DeliPlayer 2 and

DeliPlayer 2 Pro

 

Documentation

 

 

 

                                                            DeliPlayer, DeliPlayer2 and DeliPlayer2 Pro © 1997 – 2003 by Florian Vorberger and Peter Kunath

 

 

 

 

 

Introduction. 3

What is DeliPlayer 2 ?. 3

What is DeliPlayer 2 Pro ?. 3

Major Changes since the previous Release (DeliPlayer 1.30) 3

Using DeliPlayer 2. 3

Panel window. 3

Information window. 3

The Playlist window. 4

Adding entries to the playlist 4

Drag & Drop. 4

Add Files. 4

Add Directories. 4

Add URL.. 4

Inplace Editing. 4

Replicate Fields. 4

Sorting. 5

Searching in a Playlist 5

Normal Search. 5

Advanced Search. 5

Sandwich Queue. 5

Transitions. 6

Repeat Modes. 6

Internet Radios. 6

Stream Radios. 6

Keyboard shortcuts. 6

The Menus 7

Main RMB menu. 7

Playlist 8

Playlist / Sequence Mode. 8

Playlist / Transition. 8

Edit 8

Replicate Fields. 9

Sandwich Queue. 9

Play. 9

Visibility. 10

SFX.. 10

Sound effects 10

Equalizer. 10

Join Stereo. 10

Reverb. 11

Roomsize. 11

Width. 11

Damp. 11

IO-Weight 11

Wide soundstage. 11

Visualization Effects 11

Frequency-Scope. 11

Levelmeter. 11

Sonogram.. 11

Stereo-Scope. 12

Wave-Scope. 12

The ‘Tools’ 12

ID3 editor. 12

Stream Recorder. 12

Timer. 13

Configuration. 13

Control Client Configuration. 13

Control Configuration. 13

Skins. 14

Skin Properties. 14

Evaluation. 14

Switches, Switches 2. 14

Misc. 15

VFX.. 15

Window Customization. 15

Window Switches. 15

List switches. 15

List columns. 15

List settings. 16

Hotkeys 16

Core Configuration. 16

Core / Directories. 17

Core / File Extensions. 17

Add Custom Extension. 17

Core / Hotkeys. 17

Core / Switches. 17

Core / Miscellaneous. 17

Core / Stream Buffering. 17

Core / Transition. 18

Plugins 18

ArchiveLoader. 18

DiskLoader. 18

Mixer. 18

NetReader. 19

WaveOut 19

Advanced Usage. 20

'God mode' 20

Activating 'God mode’ 20

Using ‘God’ mode. 20

Element Types. 21

Functional elements. 21

Layout elements. 21

Multiple Playlists 21

Starting DeliPlayer from the command line: 21

Appendix. 22

Credits 22

Technical Details 24

Sytem Requirements. 24

Supported archive formats. 24

Supported compression formats. 24

Supported formats. 24

History. 27

Glossary. 28

Introduction

This document is a guide explaining the average day use of DeliPlayer2.

What is DeliPlayer 2 ?

DeliPlayer 2 is a music player. It is Freeware for non commercial use.

DeliPlayer 2 supports a great variety of music formats and plays all music files with the highest possible quality.

What is DeliPlayer 2 Pro ?

DeliPlayer 2 Pro has all features of DeliPlayer2 plus it allows you to save playlists with any sub-list depth and includes the full StreamRecorder plugin capable of saving stereo output.

DeliPlayer 2 Pro costs € 20 (EUR).

You can upgrade to DeliPlayer 2 Pro on our website http://www.deliplayer.com.

Major Changes since the previous Release (DeliPlayer 1.30)

Using DeliPlayer 2

When DeliPlayer2 is started it will open a new trayicon and all windows that were open when DeliPlayer2 was exited the last time.

 

All functions can be easily accessed through window controls and the right mouse button menu. To open the menu, hover the mouse over any of DeliPlayer’s windows and press the right mouse button. For a detailed description of the menus, please read the Menu section.

 

If your mouse has mouse-wheel, you can use it to change the volume. This works in all windows except the playlist window and the Information window, where the mouse-wheel scrolls the content of the controls.

Panel window

The most important window besides the playlist window is the so called ‘Panel’. It contains brief information about the currently playing tune (i.e.: songname and playtime), the position slider and the volume slider, on/off controls for the sound effects, and - last but not least - play control buttons.

 

Whenever you want to pause or stop the current tune, jump to the next or previous tune or load a completely new tune, change the volume or seek inside the tune, this is the window for it.

Information window

The information window displays various information about the currently playing tune. The detail level of the information depends on the format of the song and the diligence of its creator.

For example, MP3 files often contain a special information structure called ID3 (see also the integrated ID3 Editor) which allows the person who encodes the tune to store information about the song. It is up to the encoding person to provide detailed and correct information. Advanced versions of the ID3 structure even allow storing pictures - which DeliPlayer2 can also display.
Multi-channel music formats like ImpulseTracker and ProTracker also contain a lot of (sometimes quite interesting) information from the authors, which will also displayed in the information window.

 

Whenever you want to know something about the currently playing tune, comments from the author etc., this is the window where to look for it.

The Playlist window

Grossly simplified, the Playlist acts as a jukebox where all files in the playlist are played progressively.

You can use DeliPlayer’s playlist ‘only’ to conveniently play files now and then and you can use it to maintain your (huge) collection of audio/music files.

Adding entries to the playlist

There are several ways of adding new entries to a playlist.

Drag & Drop

The most simple method is to Drag & Drop the files and/or directories from your file browser (i.e.: Windows Explorer or TotalCommander) onto the playlist.

You can also use Drag & Drop to add new internet radios to the playlist. Simply Drag & Drop the link to the radio stream from Internet Explorer onto the playlist (this method is reported to not work for other Internet browser like Opera).

Add Files

To open a load file dialog in DeliPlayer, choose ‘Add Files’ in the ‘Edit’ sub-menu of the playlist’s RMB menu. You can select one or multiple files to be added to the playlist.

Add Directories

You can also add all files in a directory in one step with the ‘Add Directories’ operation located in the ‘Edit’ sub-menu of the playlists RMB menu. Note that this operation will also recursively add all files in all sub-directories of the selected directory to the playlist.

Add URL

If your Internet browser does not support the Drag & Drop operation for links, you can add Internet radios using the ‘Add URL’ operation located in the ‘Edit’ sub-menu of the playlists RMB menu.

Inplace Editing

You can easily modify information that is stored in DeliPlayer’s playlists. This is done directly in the playlist by slowly clicking twice on the field that you want to modify. If DeliPlayer starts playing the entry instead of entering the inplace-edit mode, you have clicked too fast.

Some columns can not be modified. These columns are: Channels, Filesize, Fullpath, Realsize and Resolution.

 

When you are done editing, press Return to take the changes over into the playlist, or press Escape to discard them.

 

While the inplace-edit control is open your can move the control to other columns and entries by pressing the ALT key and the cursor keys. Columns that cannot be modified will automatically be skipped. When moving the inplace-edit control with this method, changes made to the fields will be taken over into the playlist.

Replicate Fields

When for example adding multiple songs from an album to a playlist, you usually want to set several fields (i.e.: author and album) for all songs of the album to the same value. You can easily do this with the following few steps:

 

If you want to replicate only one single field (column), follow the first three steps described above and then open the RMB menu while the mouse is hovering over the column you want to replicate and select Replicate Fields / Field under the Mouse Cursor from the menu.

Similarly, you can replicate all fields by selecting All Fields from the ‘Replicate Fields’ menu.

Sorting

To sort a playlist, simply click on the header of the column that you want to be sorted. Clicking the same column header again will reverse the sort order.

Using the ‘Sort’ entry from the Playlist menu sorts the playlist by a set of predefined columns. These columns can be selected in the List Columns page in the window customization dialog.

When sorting by clicking on a column header, entries that have the same content will be sorted by the sort columns described above.

 

When your playlist has a hierarchical structure, you can restrict sorting to specific sub-lists. The sort scope can be configured globally on the Switches 2 page of the configuration dialog.

Searching in a Playlist

The bigger and more structures your playlists get, the hard it will become to find entries by just browsing through the lists. With the playlist search dialog, you can jump to the first/next entry that matches your search pattern or you can let it select all matches.

DeliPlayer2 offers a normal and an advanced search dialog. The normal search dialog allows you to specify one search pattern and supports only simple patterns. It is the recommended search dialog for average day use.

 

You can select which search dialog you want to use by toggling the ‘Use Advanced Search Dialog’ setting on the ‘Switches’ page of the configuration.

 

To repeat the last search operation you do not to reopen the search dialog, you can use the ‘Find Next’ entry from the Edit menu, or simply press F3.

Normal Search

To search using the normal search dialog, select the column you want to search for in the Column drop-list and enter the search pattern in the Pattern field. For example, if you want to search for the first entry of an Album of which you can only remember that the word ‘fish’ was part of it, select the Album column and enter ‘fish’ as search pattern (see picture) and press the ‘Search’ or ‘Search & Close’ button.

 

When you select a numeric column type (like Filesize, Rating or Resolution) an addition drop-list will appear next to the column drop-list that allows you to choose the compare operation (equal, greater, less, greater or equal, less or equal, and not equal).

 

You can also restrict the search to already selected entries. Using this technique allows you to further refine a search.

Advanced Search

The advanced search dialog allows you to specify up to 4 search patterns for different columns. The different patterns can be logically combined with the AND, OR and XOR (exclusive OR) operation. Further, you can choose if you want to use simple patterns (sub string search), basic regular expression or extended regular expressions as well as if the compare should be made case sensitive or case insensitive.

If you want to learn more about regular expressions, please search the Internet – there is plenty of information available.

Sandwich Queue

The sandwich queue allows you specify a list of playlist entries that should be played out of the current playlist order. When all songs in this list have been played, the playlist will continue to play in its normal order, starting with the last song from the sandwich queue.

To add one or multiple playlist-entries to the sandwich queue, select the entry/entries and choose ‘Add to Top’ or ‘Add to Bottom’ from the sandwich RMB menu. ‘Add to Top’ will add the entry/entries the top of the sandwich queue so it gets played as the next song, ‘Add to Bottom’ will add it/them to the end of the sandwich queue.

The first ten entries in the sandwich queue are enumerated in the playlist by a tiny number in the entry icon. Sandwich queue entry 10 and above are marked with two dots in the entries icon.

To remove one or multiple entries from the sandwich queue, select the entry/entries and choose ‘Remove from the Sandwich Queue RMB menu.

You can add one entry several times to the sandwich queue. In this case the number displayed in the playlist entry icon will be the index of the first entry. When removing an entry from the queue that has been added two timer or more often, always the first entry will be removed from the queue so that you have to remove it as many times as you have added it before.

Transitions

When playing music from the playlist you can choose how you want to concatenate two songs.

You can choose one of the following transition methods:

No fade effect is applied to either song, the next song will follow seamlessly.

No fade effect is applied to either song but a gap of silence will be inserted between both songs. This mode is especially useful when recording MiniDisks.

The ending song will fade out while the next song fades in.

The ending song will fade out and the next song will follow. No fade effect is applied to the next song.

Repeat Modes

Each song is played one, until the end of the playlist is reached.

One song is repeated over and over. When the end of the song is reached, it is restarted from position 0.

Each song is played one, when the end of the playlist is reached, the whole playlist is repeated, over and over.

One song is played over and over. When the end of the song is reached, the playback simply continues. For legacy formats (like ProTracker and similar) this is very often different from simply restarting the song because the songs have and internal loop point. For MP3 and other streaming formats this option behaves the same way ‘Repeat One’ does.

One song is played once, when the end of the song is reached, the playback is stopped.

Internet Radios

Stream Radios

DeliPlayer2 can play Internet audio streams, also called ‘Internet Radios’. When you have navigated your Internet browser to the homepage of an Internet Radio you want to listen to, locate the link to the radio stream/relay and drag & drop the into DeliPlayer’s playlist. You can now start listening to the Radio by double-clicking the playlist entry, as if it was any music file. Another way of adding a Internet Radio to the playlist is via the playlist RMB Menu / Edit / Add ULR dialog.

 

When listening to Internet Radios, keep in mind that a continuous stream of data must be received via your ISP. If your Internet connection has a traffic volume limit, you should be very careful because you can easily exceed this limit just by listening to Internet Radios for a few hours (depending on your transfer volume limit and the quality of the stream). Please consult your ISP if you have questions regarding traffic limits.

 

Many Internet Radios provide streams of the same radio in different qualities. Which stream you should pick depends on the speed of your Internet connection.

The following table shows which Radio streams different Internet connections allow:

 

Connection Type

Downstream bandwidth (kbps)

Radio bandwidth (kbps)

Analog Modem

56

24

ISDN

64

56

ISDN with channel bundling

128

56

Cable connections

256 and above

128 and above

DSL

256 and above

128 and above

T1…

1Mbit and above

128 and above

Keyboard shortcuts

Most playlist functions have a keyboard shortcut. This becomes very useful when you need to perform certain operation repeatedly.

The following list contains all shortcuts that are not documented on the menus as well as the most important shortcuts from the menus.

 

Ctrl + Left

Jump to previous expanded sub-list

Ctrl + Right

Jump to next expanded sub-list

Ctrl + Shift + Left

Jump to the head of the current sub-list

Shift + Left

Jump to the previous sub-list

Shift + Right

Jump to the next sub-list

Shift + Up

Span selection to the previous entry

Shift + Down

Span selection to the next entry

Up

Select the previous entry

Down

Select the next entry

Ctrl + Up

Set focus to previous entry

Ctrl + Down

Set focus to next entry

Left

Scroll Playlist view to the left

Right

Scroll Playlist view to the right

Ctrl + E

Evaluate selected entries

Ctrl + U

Evaluate un-scanned entries

Ctrl + Q

Evaluate all entries

Del

Remove selected entries

Backspace

Jump to playing entry

Ctrl + A

Select all playlist entries

Ctrl + O

Load a playlist

Ctrl + W

Save current playlist with the same name

Ctrl + Shift + W

Save current playlist with a new name

F3

Find next

Ctrl + F

Open the search dialog

Alt + Cursor Keys

Move the inplace-edit control (which must already be open)

The Menus

Besides the obvious window controls, DeliPlayer2 is mainly controlled via its windows’ context menus, which are opened by pressing the Right Mouse Button inside any of DeliPlayer’s windows. This menu is from now on referred to as ‘RMB menu’.

 

DeliPlayer distinguished between windows containing a playlist control, and windows without a playlist. The main difference from the user’s perspective is the extended RMB menu of windows that contain a playlist control. In the following only the RMB menu of windows containing a playlist control will be described because it is an extended version of the RMB menu of windows without a playlist control.

 

You can quickly access most menu functions without having to open the menu by pressing the braced key shortcut specified after the menu function.

 

Main RMB menu

Close Window

Closes the current window. It performs the same function as pressing the close button in the top left corner of every standard window. Because DeliPlayer can hide the window caption and with it the close button, you can always close the window via this menu entry.

Recent Playlists

Recent Files

Each of these entries will open a sub-menu containing a list of the last loaded playlist/files. By selecting one of the listed playlists/files you can quickly load it again.

 

 

Playlist

Statistics

Displays a dialog containing statistic data about the current playlist.

New List

Clears the current playlist and creates a new empty playlist.

Load List

Opens the Load playlist dialog

Save List

Stores the current playlist under the name under which it was loaded. DeliPlayer 2 Pro stores playlists with any nesting level (sub-lists within sub-lists), the Freeware version only stores playlists with one sub-list level. Playlists with deeper nesting will be ‘flattened’’ to one sub-lists level.

Save List As

Opens the Save playlist dialog that. (see also ‘Save List’)

Update Directory

Opens a Directory dialog where you can select a directory to be scanned for files that are not already present in the current playlist

Sort

Sorts the current playlist by the columns configured as sort columns.

Record List

Random Play

Activates and indicates that the playlist is currently playing in random order.

Clear Random Memory

Resets the memory of already played entries.

Create Empty Sub-List

Ditto

Decompose Selected Sub-Lists

Replaces all selected sub-lists by their content.

Collapse Selected

Collapses all selected sub-lists. This affects only the visual representation.

Expand Selected

Expands all selected sub-lists.

 

Playlist / Sequence Mode

 

 

[see the Repeat Modes section]

 

Playlist / Transition

 

[see the Transition section]

 

Edit

Add Files

Opens a file dialogs where you can select multiple files that you want to add to the current playlist

Add Directory

Opens a directory dialog where you can select a directory that you want to recursively add to the current playlist

Add URL (Internet Radio)

Opens a URL dialog where you can specify the URL, port and name of the radio station that you want to the current playlist.

Search

Opens the search dialog

Find Next

Performs the last search again starting from the focused playlist entry without opening the search dialog.

Show Playing Entry

Changes the playlist’s view so the currently playing entry (if any) is visible. If the playing entry is in a collapsed sub-list tree, all sub-lists are expanded so the entry becomes visible.

Evaluate Selected

Evaluates all selected entries.

Evaluate Unscanned

Evaluates all entries in the playlist that have not already been evaluated.

Evaluate All

Evaluates all entries in the playlist.

Re-Evaluate Selected

Evaluates all selected entries. All information already stored in the entries is overwritten (use with care).

Remove Selected

Ditto

Split Selected Into Subsongs

Splits all selected entries with sub-songs into as many entries as they have sub-songs.

Late Relocate Paths

This function replaces a specific path part in all entries of the playlist by another path part. This allows you to adjust a playlist after the files referred to from the playlist have been moved to a different location on your harddisk(s).

 

Replicate Fields

 

[see the Replicate Fields section]

 

Sandwich Queue

 

[see the Sandwich Queue section]

 

Play

 

This menu is self-explanatory.

 

Visibility

 

On Windows™ XP and Windows™2000 you can make each of DeliPlayer’s windows individually transparent. This option may be especially useful on windows that are ‘always on top’.

When you activate the the Only When Inactive option, then the window will only become transparent when it is inactive.

 

SFX

 

This sub-menu controls and displays the activation state of the sound effects.

Sound effects

 

DeliPlayer2 comes with four sound effects:

1)     Equalizer

2)     Reverb

3)     Wide soundstage

4)     Join stereo

Equalizer

The Equalizer allows you to create your own frequency profile. 10 frequency bands can be amplified and attenuated up to 12 Decibel. The equalizer can help to balance out failings in either output audio equipment (hardware) or the audio files themselves. The equalizer is active when the checkbox in the lower left corner is checked (in the skinned layout the checkbox is in the top left corner).

 

You can amplify and attenuate the whole equalizer profile with the Modify slider.

 

Equalizer profiles can be created, modified and deleted using the buttons below the sliders.

 

Note that when the equalizer settings result in an overall amplification (this is what you usually do) the output can saturate [see also Saturation]

(Some soundcards do their own sound manipulation and some tend to saturate normalized signals even if all of their effects are turned off. Also, loudspeakers have only limited dynamics and will start saturating the output themselves at some point, especially with loud bass frequencies). To check if DeliPlayer2 creates the saturation or not, you can open the Wave-Scope VFX and check if the signal reaches the top/bottom borders of the window. If it does, DeliPlayer is responsible for the saturation.

 

To avoid saturation, use the following steps for finding optimal equalizer settings:

Join Stereo

This effect reduces the stereo width, at its extreme resulting in mono output. Join Stereo is primarily useful when listening to multi-channel formats with only few channels (like ProTracker) using headphones. As ’Wide soundstage’ is not simply a reversed ‘Join Stereo’ effect, combining both effects can often add a pleasant atmosphere to multi-channel tunes.

Reverb

Technically, reverb is a recursive echo. The reverb is probably the most widely used effect available to musicians and sound designers. Depending on the reverb settings, the result can be extremely subtle or vast in effect.

 

Available setting:

Roomsize controls the depth if the echo.

Width specifies how much the stereo channels are exchanged when adding the echo to the sound-output. Setting the Width to ‘cross’, creates similar results as the ‘Wide Soundstage’ effect does.

Damp specifies how much the high frequencies in the echo are attenuated, this creates are more realistic reverb effect.

IO-Weight specifies how loud the echo effect is compared to the input data. Setting the slider to ‘Dry’ adds no echo to the input data, hence you hear no reverb at all. Contrary, ‘Wet’ results in only the reverb effect to be audible.

Wide soundstage

Soundstage is your systems ability to spread sound wide of loudspeaker enclosures. Within audiophile circles (what is referred to as) a wide soundstage is usually a desired effect. Some recordings, audio formats or equipment severely limit good soundstage recreation. In this situation the ‘wide soundstage’ effect helps to expand the sonic image.

It has no configuration as it is an ON/OFF effect.

Visualization Effects

The display plugins visualize different aspects of the currently playing tune.  You can select an individual color scheme for each VFX.

Frequency-Scope

The Frequency scope displays the frequency distribution of what DeliPlayer is currently playing. There are various ways of configuring the look of it.

 

 

 

 

 

 

Levelmeter

The Levelmeter displays the volumes of all virtual channels or the output channels (usually stereo) in different ways. When displaying the virtual channels you can choose if you want to visualize the 'virtual' volume of the channels or the 'real' pressure. The 'virtual' volume does not necessarily reflect the pressure but in most cases it gives a good hint and sometimes looks more 'jumpy' than the real sound pressure.

 

The default configuration displays the channels as ascending bars (the higher, the louder) split into 30 segments. You can configure the number of segments, the segment spacing (the 'empty' space between the segments) and the bar spacing (the empty space between the bars). Setting the number of segments to zero disables segmentation resulting in continuous bars.

Beside ascending bars you can choose to display the volumes as descending bars, two bars, one from the top and one from the bottom, meeting in the middle and as two interleaved bars, one from the top and one from the bottom.

Finally all modes can also be drawn horizontally. This makes ascending bars grow from the left to the right, and so on.

 

As an option, the Levelmeter can display a peak marker. The time a peakmarker stays at the peakposition can be specied by setting the Hold Time. The drop-down-speed of the markers can be modified in the Drop Speed field.

Sonogram

 

The sonogram displays the same as the FrequencyScope but in a very different way. Frequencies that are 'loud' (have a high peak in the Frequ.Scope) will be displayed as a 'bright' point, silent frequencies are displayed with a 'dark' point. One frequency analysis is drawn as one line with the frequencies on the Y-axis. The X axis is the time axis. You can swap the X/Y axis. The Sonogram is not 'jumpy' at all. The Sonogograms of some tunes look really crazy, escpecially when pitch slides are used.

Stereo-Scope

The Stereo-Scope is visualizes the dependencies between the stereo channels. If the output is mono, you will see only a diagonal line flashing in different colors. The wider the soundstage of a song, the more interesting figures are drawn by the Stereo-Scope.

 

 

 

Wave-Scope

The Wavescope displays the currently playing waveform. Again you can choose from a variety of displaymodes:

The ‘Tools’

DeliPlayer2 includes three tools that come in handy in different situations.

ID3 editor

ID3 is the name of a structure (often called ‘tag’) that was designed to be stored in MP3 files and contains information about the music. With DeliPlayer’s ID3 editor you can create new ID3 tags, change the information in existing ID3 tags, and remove ID3 tags from files. Later versions of the ID3 tag allow applications to insert information into the tags that only they can understand. When editing those ID3 tags, DeliPlayer will leave such data untouched.

DeliPlayer will only allow you to add ID3 tags to formats that support them. When the editor is disabled, the currently playing tune is in a format that does not support ID3 tags or the file is read-only or stored in an archive.

 

 

 

 

 

 

Stream Recorder

The Stream Recorder plugin writes the audio-output of DeliPlayer into a file. Please note that this plugin only creates mono in the Freeware version of DeliPlayer 2. If you want to save the output in stereo you should upgrade to DeliPlayer 2 Pro. Please visit http://www.deliplayer.com if you wish to upgrade.

To start recording, press the Record button while a tune is playing. Use Record Sequence to record the entire playlist starting from the current playlist position.

The recorded file(s) is/are placed in the Destination directory. These files can grow quite large (ie.: 30MB for a 3 minute long CD-quality WAV file), so make sure that you have enough free disk space, especially when recording a sequence.

The Bypass SFX Plugins checkbox controls if the effect plugins are active during recording. Leave this setting disabled to record a song exactly as DeliPlayer plays that song, including all active sound effects.

Normalization can be turned on by enabling the Normalize checkbox. This is especially useful for multi-channel tunes because the volume of these formats is often rather low. When normalization is active, two passes are required to create the final output file and DeliPlayer. The Maximum Output Amplitude in % control allows you to specify if the recorded output will saturate (when using values greater than 100) or not use the maximum possible volume. Usually you always start with 100% and adjust this value only when the volume of the recorded output is too low (increase the value) or too loud (decrease the value) before recording the tune again.