MortPlayer - Help


 

back

Important terms and basics


Favorites
Favorites structure (update)
Changer Mode
Playlist Mode
Recently modified playlist
Selection dialogs
Open dialog
 

back

Favorites


The favorites are a selection of directories and playlists, which are often played.
You can access them easily with the list skip buttons (<[]/[]>) and the Open dialog.
Additionally, they're used for the Changer Mode.

There can be multiple groups, e.g. for different storage cards or usages (like one for the party, one for audio books, ...). But only one group will be used.

Favorite usually means a single directory or playlist in a favorite group.
Favorites usually is a synonym for the currently active favorites group or its contents.
 

back

Favorites structure (update)


To allow easy switching between paths and playlists, MortPlayer needs to scan the favorites structure.
Doing this, the player scans subdirectories, contained playlists, and the number of audio files (required for "Shuffle all").
By default, this is done at the first program start each day. In the program start settings or the wizard, you can change this to every program start or only manual updates.
A manual update can be done the following ways:
  • With the menu entry "Refresh fav. structure" (in "Data for Open")
  • Assign the update to the open button (in "Settings" - "Open dialog and button", at best with Tap&Hold)
  • Leave the favorites management with OK

If there are multiple favorite groups, only the recently chosen one is updated.
 

back

Changer Mode


In this mode, the playlist is filled with the contents of another favorite if it's required.
Usually this happens after the current playlist is finished. I.e., like a CD Changer skips to the next CD if one is played - hence the name.
Because more files than the ones shown in the playlist are played, there are some shuffle and repeat modes only available in this mode. For example, whether the current favorite (i.e. the shown playlist) or all files should be repeated, if you want to shuffle the files of each favorite ("Shuffle files") or across all favorites ("Shuffle all"), etc.
Modifications to the playlist aren't possible in this mode, because when another favorite is activated, they'd either be dismissed or (if there'd be a query) block the playback. Additionally, the contents of the playlist wouldn't correspond to the original favorite contents (i.e. directory or playlist contents) anymore.
Due to this, the Playlist Mode is activated automatically, if you modify the playlist of a Favorite in Changer Mode.
 

back

Playlist Mode


This mode resembles what is common in most other players. I.e., the shown playlist will not be left and can be modified.
This mode will be activated automatically if the playlist is edited in Changer Mode.
(See also Changer Mode)
 

back

Recently modified playlist


Changes to the playlist will be saved automatically to an internal "recently modified playlist" until the playlist is saved with ""Save (as)"".
You can restore it by selecting it in the Open dialog.
If another playlist is modified (e.g. a favorite or a new empty list), the old data will be overwritten. Due to this, a query will pop up, which allows you to choose between saving the old playlist data, dismissing it, or cancel the modifying action. In "Handling" - "Overwrite recently modified playlist", you can change this behaviour to dismis the changes without query.
 

back

Selection dialogs


There are multiple situations where the selection dialogs are used. The one which is probably used the most is the open dialog, others are available for Skins, presets, playback modes, ...

Even though the usage is quite intuitive, there are some possibilities you might not have noticed.
There are three ways to select an entry of the list:
  • The list: Just tap at the entry. It's immedially accepted.
  • The buttons: Highlight the entry with the arrow buttons, then press "Select".
  • The hardware buttons: Highlight the entry with up or down, and press the action or right key to accept.
When pressing direction pad to the left or pressing "Back", the dialog is cancelled. If you opened a sub menu (in the open dialog), you get back to the upper menu level. If the main selection is shown, the dialog will be closed.
 

back

Open dialog


The Open dialog is entered with the open symbol (usually looks like a eject button or labeled with "Open", but might differ in some Skins) or the menu entry.
It allowes not only to open single fies or playlists, like it's usual, but you can also select your favorites (or even a whole tree of it), streams, bookmarks, invoke their management dialogs, etc.

The handling is mostly like every other selection dialog. The main difference is that there might be sublevels, and "Back" puts you in the previous menu level before it leaves the dialog on top level.
It is possible to customize the Open dialog. This allowes e.g. to show the favorites in a submenu, after the bookmarks, or not at all, or show all bookmarks directly in the main menu.
Additionally, there are some settings which influence its behaviour, esp. regarding favorites. Most of them can be set with the wizard.
 

back

Handling, tips, and tricks

Setup favorites
Customize Open dialog
Install a Skin
Install a Plug-In
Showing album art
Volume
Screen off and button lock
Tap & Hold
Device buttons
Bookmarks
Audio books
Streams and Podcasts
 

back

Setup favorites


The dropdown and buttons on top allow multiple favorite groups (i.e. add, remove, select). See favorites for more information about them.

To create a new entry (favorite) in the current group (ususally there's just "Favorites"), press the "+" button next to the list.
Now a dialog is opened which allows you to enter or select a path or playlist, and there are some options:
  • "Only contained playlists"
    With this, only the contained playlist files will be used when creating/updating the favorites structure. I.e., if the path "\Storage" was set, "\Storage\dings.mpl", "\Storage\test.asx", etc. will be used, but the not files in "\Storage" - of course except those which are contained in any of the playlists.
  • "With all subdirectories"
    Includes the subdirectories. I.e., subdirectories like "\Storage\Music\ASP\Weltunter", "\Storage\Audiobooks", "\Storage\Mix", etc. will become selectable, too. If "Only contained playlist" is checked, playlists in subdirectories (like "\Storage\Music\ASP\Weltunter.mpl") will be included.
  • "Show contained paths/directories on top level"
    With this, the Open dialog won't show the given directory but its contents. This is useful if you use a folder structure like "\Storage\Artist\Album" and you selected "\Storage" as path. If this option isn't checked, you'll have to select first "Storage", then the artist. If the option is checked, all artists are listed at once. Drawback: you won't be able to select "\Storage" to hear directly contained files or play the whole tree.
  • "Contains audio books"
    Activates some special behaviours for audio books:
    Stop doesn't reset the position to the beginning
    Tracks are continued where they've been stopped
    Playback order is set to "Don't shuffle"
    In Changer Mode, these favorites won't be used for automatic skips, so they don't bother when listening to music.
With "Edit" or a double click on an entry, this dialog is shown again for changes.
With "-", the selected entry is removed.
 

back

Customize Open dialog


With the menu entry "Customize" in the Open dialog, or the corresponding entry in the settings, you can define for every entry, if, how, and where it should be shown.
This means: E.g. you can omit the bookmarks (select "don't show"), show them directly in the main menu (like the favorites by default, select "in main menu") or in a sub menu ("<Bookmarks>" entry, select "in sub menu"), and the position can be changed (below/above the streams, favorites, ...) ("where"). Additionaly you can omit the "Manage" entries (like for example "<Manage bookmarks>").
For example, you could show the bookmarks to your recent audio books in front of the favorites, and the "Other files" entry you never use can be omitted.
 

back

How do I install a Skin?


First, download a Skin. There are lots of them in the download area of www.sto-helit.de.

Now, copy the contents of the downloaded ZIP file to the MortPlayer installation directory on your PocketPC.
To do this, use the "Browse" button in ActiveSync or select the "Mobile device" folder in Explorer, then look for the MortPlayer folder. It should be something like "\Program files\Mort's MortPlayer" unless you chose to install it to a storage card. If in doubt, open the "Paths" section in the MortPlayer settings, and check the "Skins" path. If you want to, you can change it there to a different location (see below for more information about this).
Depending on the unzip program you're using, you can either drag&drop the contents of the ZIP file directly to the target directory on the device, or you have to unzip it to a temporary directory on a local drive and copy it afterwards.
Just watch out subfolders (usually one for the images) remain as contained in the ZIP file. Some programs might ignore them and unzip everything directly in the target directory. If this happens, MortPlayer won't find the required images and the skin will look quite ugly.

You can set the Skins directory to another path in the Paths settings, too. This might be a Skins subdirectory or a path on your storage card. You'll have to move the Skins (*.mps) and the required subdirectories to the new path yourself.
If you wonder why there's no Skins subdirectory by default: It's because of backward compatibility.
It would be a bit hard to move all existing skins (esp. the required subfolder) to the Skins directory at an update.
 

back

How do I install a plug-in?


Most important: The plug-in DLL must be located in the Plug-ins directory that is set in the "Paths" section of the MortPlayer settings. By default, this is the "PlugIns" subdirectory of the MortPlayer installation, e.g. "\Program files\Mort's MortPlayer\PlugIns".
If you're using the installer of GSPlayer's MIDI plug-in, it will install it to something like "\Program files\GreenSoftware". You can either set the PlugIn path to this directory or move the installed gspmidi.dll to MortPlayer's PlugIn directory.
After this, you should be able to see the plug-in(s) in the settings ("Playback" - "Plug-Ins").
The MIDI plug-in needs to know where the instruments (extra download!) are located. So, select the MIDI plug-in (if necessary), and press "Configure". Now, press the "..." button next to "Config file" and choose the path to which you copied the GM.cfg file and close the dialog. You have to use the system's file selection and OK button in this case, I can't modify the plug-in's dialogs. If GM.cfg isn't shown, you might need to copy it in "My documents" or a subfolder ("\Storage\My documents" or similar for storage cards). This is a limitation of Windows Mobile's default open dialog...
 

back

How do I use album art?


Obviously, first of all you need a skin which implements it...

The cover image is searched in this order:
  • ...\path\track.jpg/png (e.g. \Music\CD\Track.jpg for \Music\CD\Track.mp3)
  • Image of type "Cover (front)" contained in the ID3 tags (JPG or PNG)
  • Image of type "Other" contained in the ID3 tags (JPG or PNG)
  • ...\path\cover.jpg/png (e.g. \Music\CD\cover.jpg for all tracks in \Music\CD)
  • ...\path\folder.jpg/png (e.g. \Music\CD\folder.jpg for all tracks in \Music\CD)
  • ...\path\path.jpg/png (e.g. \Music\CD\CD.jpg for all tracks in \Music\CD)
  • ...\playlistpath\playlist.jpg/png (e.g. \Music\MyPlaylist.jpg for all tracks in \Music\MyPlaylist.m3u; works only if the playlist is shown)
 

back

Volume


The settings and the wizard offer you to choose whether the volume slider will modify the system volume (like the system's volume slider in the title bar) or recalculate the track's volume relative to this volume (like WMP does since V10). (Or modify the preamp, which is a special case...)
Independent from this, you can modify both volume types on program start, when the player's alarm clock becomes active, or when the player's closed (of course there's no way to modify a relative volume on exit). This way, you can set the system's volume to "full power" for the alarm clock, so you'll be woken for sure, even if you use the relative volume otherwise...
 

back

Screen off and button lock


For this, there are many possible combinations. For example, you can switch off the display automatically after a given timespan, and then turn it on again with any button, set button locks which require two buttons to be removed (first turn screen on, then remove button lock), etc. Listing all combinations would take too much place...
The button lock is only available in combination with screen off, since it'd be of no use if the touchscreen is still active.
If the screen is switched off by the player, it deactivates even without button lock all buttons which are handled by the player (i.e. application buttons only if they're activated, otherwise the system will not even notify the player about them!) and which would be useless without display. This includes e.g. exit, minimize, selection dialogs, program starts, ...
The button lock on the other hand really locks all buttons, even the application buttons if they're not activated. The player registers them temporarily in this case.
A little trick, which isn't so easy to find: If you activate the button lock, don't assign "Screen on/off" to a button, but select a button to deactivate button lock, this button will also turn on the screen. This way, you are able to activate button lock and turn off the screen after a timeout, and then remove it with a button which is used for something else otherwise.
 

back

Tap & Hold


Tap and Hold (i.e., tapping a button and holding the stylus down until the circle around the arrow is closed) is supported even on buttons. Some of them do different actions when "Tap&Hold"ed.
The buttons marked with "*" support the Tap&Hold even when the action's assigned to a hardware button (no circle there, you'll have to wait until the actions is done...)
  • * Next/Previous Screen -> Shows Screen selection
  • Screen selection -> Next Screen
  • Play favorites -> Play favorites shuffled (and vice versa)
  • Favorites management -> Play favorites
  • Open -> Favorites management (can be changed in the settings)
  • * Previous track -> Rewind (while playing)/Previous source
  • * Next track -> Fast forward (while playing)/Next source
  • * Prev./next source -> Prev./next track
  • * Shuffle/repeat mode -> Shows corresponding selection dialog (or not, if it's set as default in the settings)
  • Remove ("-") -> Remove all (clear playlist)
  • Move up -> Move to top
  • Move down -> Move to bottom
  • Exit -> Minimize (hide)
  • Minimize -> Exit
  • Changer -> Switches to changer mode (if not already activated) and starts playing
 

back

Device buttons


You can assign the device buttons in the settings. Select "Device buttons" - "Assign device buttons" to open the assignment dialog.
If you want to use the application buttons, you need to activate them in "Use upplication buttons?". Otherwise, these buttons would be handled directly by the system, i.e. the player wouldn't even be notified if they are pressed.
For some assignments, a different function is activated if you press the button for over about one second. See Tap&Hold for more informations.
A little trick: If the playlist selection was modified and you press the "Play/Pause" button, the newly selected track is played, instead of pausing the previous. If you assign "playlist selection" and "Play/Pause" to device buttons, it allowes you to easily switch to another track of the playlist.
 

back

Bookmarks


Bookmarks are added with the menu entry "New bookmark". In some skins and the toolbar there's also a button for it.
Selecting a bookmark is done in the Open dialog.
With "Manage bookmarks" (available in the Open dialog or "Data for Open" in the menu) you can remove and modify the existing bookmarks.
 

back

Audio books


There are several useful features available for audio books:
Bookmarks
Audio book option in the favorites
Automatical continuation of the previous track (in the "program start" settings, or use the wizard)
 

back

Streams and Podcasts


Streams and Podcasts can be opened by different ways:
  • Add them to the streams list in "Manage streams" (available in the Open dialog or "Data for Open" in the menu) and select them in the Open dialog. This has the advantage of being easy to access without having unwanted data transfer when accidently opening a stream playlist (esp. if it's in the favorites).
  • Select "Other path/playlist" in the Open dialog, and enter the URL.
  • Only streams: Open any playlist which contains the stream's URL, e.g. a .pls file downloaded from www.shoutcast.com.
  • Only Podcasts: Save the Podcast as .xml and open it with "Other path/playlist".
Notice about Podcasts: The referred files will be streamed directly from the server, downloading them to listen them offline isn't possible currently.
 

back

FAQ

License and donations
Features
Difficulties with handling
Other troubles
 

back

License and donations

May I offer the program on my web side, magazine CD, ...?
How can I donate?
Why should I spend money for freeware?
Why not as Shareware?
 

back

Features

Will there be support of WMA/ACC/any other sound format?
Why don't you display the entire network neighborhood?
Why do the titles etc. only scoll line by line?
Why aren't there any tag informations in the playlist?
Will there be a landscape mode for devices without WM2003 SE?
Why is so much included in the "Open" dialog?
Why all this strange "favorites" stuff?
How do I create an own Skin?
 

back

Difficulties with handling

Why are the "Changer Mode" and list skip buttons disabled?
Why does nothing happen if I select "Tree -" or "All in Changer Mode"?
If I press stop, close the player, and start it again, the track is resumed from the position I pressed stop. Why?
Why doesn't "Always on top" exist in the menu?
 

back

Other troubles

I often have breakups and interruptions. What can I do?
Why isn't the track position updated?
The player works very slow, if it's attached to a GPS power cord, but the navigation system isn't running. What's going on?
Why are there distortions if the preamp is over a certain level?
When the screen's toggled off, why is the screen on while I press a button?
Why are the toolbar symbols so tiny? (WM5/VGA)
 

back
May I offer the program on my web side, magazine CD, ...?

Yes. There are only two conditions:
- Publish the link to this homepage (www.sto-helit.de) and my name (either my nick "Mort" or my real name "Mirko Schenk")
- Make clear it's a freeware program. I.e. no advertisements which look like it's a registered shareware program! ("full version", "unlimited", ...)
Not a condition, but good behavior, would be to tell me about it...
 

back
How can I donate?

Most simple using PayPal. Go to www.paypal.com (or your locale, like www.paypal.de), register, and send the donation to mort@sto-helit.de.
On my page (www.sto-helit.de) you'll also find links to PayPal with some presets.

If you prefer to do a bank transfer, I can send you my account data. I just don't want to publish it on my page... Usually, this is only useful inside the EU, otherwise transfer fees are way to expensive.
 

back
Why should I spend money for a freeware program (donate)?

For the same reasons, why other demand it. There's a lot of work in this player (and everything about it, like homepage, skins, support, ...), and it would be nice if this is honored in a financial way, too.
Others want up to $20 for an MP3 player - consindering this, some bucks aren't too much for a little "Thanks, good work", don't you think? ;)
 

back
Then why not as Shareware?

Most obviously for license reasons, because the player contains foreign code, which is published under the GPL (and thus the player does itself, too).
But primarily because I don't want to enforce anybody to spend money. It's still a hobby for me.
I think donations are a very fair system.
For you: You can spend whatever it's worth to you and what you can efford, whenever you like.
For me: No (unwritten) promises I can't promise to hold, like support or updates. I do my best, but I'm only a single human, and not doing this a business... And I don't need to waste my time with license systems, user databases, etc.
 

back
Will there be support of WMA/ACC/any other sound format?/b>

At least not from me...
MortPlayer supports GSPlayer plug-ins, so in theory, it's possible.
However, sadly there don't seem to be any plug-ins but the MIDI plug-in on the GSPlayer page and a beta plug-in for FLAC, and I don't have enough knowlege about audio codecs...
 

back
Why don't you display the entire network neighborhood?

Because there's no official way to do this.
The function parameters common for (desktop) Windows don't work in Windows Mobile.
If anyone knows which tricks Resco did use, and there are no patents/copyright troubles, I'd be happy to know them...
 

back
Why do the titles etc. only scoll line by line?

To save CPU time. Esp. on slower PPCs the constant repaints would put the device close to its limits.
But even newer PPCs would be pushed, esp. since MortPlayer in spite to many other players hasn't a single small label for all track infos, but in some screens many big labels (e.g. in most car screens). For those, almost half the screen would need a redraw very often. And the Windows routines to draw transparent text (i.e. without a fixed background color) are really slow - even without "Cleartype"...
 

back
Why aren't there any tag informations in the playlist?

Imagine you're using the Playlist Mode with hundreds of songs in your playlist, and those are located on a slow SD card or even on a network drive. And now imagine how long it would take to open every single file and evaluate the tag informations...
 

back
Will there be a landscape mode for devices without WM2003 SE?

No. The effort would be far too big, and there would be a problem with screens that aren't fullscreen: The title and menu bars can't be moved, which would look strange and leads to different usable screen sizes.
Apart from this, those devices are an endangered species anyway...
 

back
Why is so much included in the "Open" dialog?

I wanted an interface which can be easyly used during travel without the stylus. Many small buttons would be too complicated. The menu in the open dialog can be used very good without a stylus (direction pad, big buttons, ...) and additionaly offers the possibilty to fit it to your own needs.
 

back
Why all this strange "favorites" stuff?

Because usually I just copy all songs, I like to listen to, to the same directory structure, and would like to have these tracks played as simple as possible.
No complicated and slow syncronization, no need to update playlists all the time, features like the Changer Mode, ...
 

back
How do I create an own Skin?

The manual on my site includes a link to a skin manual.
Direct: www.sto-helit.de/downloads/skinhelp.html
 

back
Why are the "Changer Mode" and list skip buttons disabled?

You have to tell the programs which paths and playlists should be played in changer mode or skipped with the list skip buttons.
This is done in the favorites.
 

back
Why does nothing happen if I select "Tree" or "All in Changer Mode"?

Something does happen - it's just not very obvious. "Tree in Changer Mode" limits the changer mode to the chosen path and its subdirectories. I.e., the list skip buttons as well as the automatical list changes at playlist end or with "Shuffle all" only skip inside this tree. That's nice if for example you want to listen to music from all albums of one band.
With "All in Changer Mode", this limitation is removed.
 

back
If I press stop, close the player, and start it again, the track is resumed from the position I pressed stop. Why?

First of all, because the option to restore the position is activated (in program start settings or the wizard).
It works for stop, because often the playback is stopped by it intuitively, and it would be annoying if you had to seek the last position e.g. of an audio book in this case. I think, in doubt it's more easy to press "back" to get to the beginning of the track than to seek the position.
That the position is set to 0:00 after pressing stop, instead of the stopped position like after program start, is because you usually expect a track to start from the beginning after pressing stop and play.
If a favorite is marked as audio book, the last stop position is restored even if "Restore position" is not activated. In this case, the position isn't reset after a stop, too.
 

back
Why doesn't "Always on top" exist in the menu?

Because this option only makes sense if the player doesn't occupy the whole screen.
With a screen that only occupies a part of the display (e.g. the car screen of MaxxTT), this option will exist.
 

back
I often have breakups and interruptions. What can I do?

First step: Increase the buffer. Depending on the system, 500ms to 1s usually are fine.
If this is not enough, you can increase the priority of the playback routines. But this might slow down the system...
If even this doesn't work, check whether there are programs which are using lots of CPU time.
ActiveSync usually is a prospect for this...
 

back
Why isn't the track position updated?

The position update works with low priority. Due to this, the position update doesn't work if the CPU usage is very high.
Additionally, the track position isn't updated while MortPlayer isn't the active application (exception: "Always on top" is checked) because usually this only uses CPU time without any visible effect (since another program is shown).
 

back
The player works very slow, if it's attached to a GPS power cord, but the navigation system isn't running. What's going on?

ActiveSync is going on. On some devices, it desperately tries to interpret the GPS data and by this paralyzes the PPC.
If the navigation system is running, ActiveSync can't use the port - and the problem doesn't exist.
In MortPlayer you can do something similar with the option "Lock serial port" in the program start settings. If you want to use your navigation system with this option active, you've got to start it before MortPlayer. Otherwise, it wouldn't be able to get the GPS data stream (just like it's wanted for ActiveSync).
Btw, this problem isn't specific to MortPlayer. It just attracts more attention than if something resource friendly (e.g. a clock) is running.
 

back
Why are there distortions if the preamp or equalizer is over a certain level?

If a song (or certain frequence ranges of it) is made softer or louder this way, the volume, i.e. the amplitute of the contained noise, is recalculated.
For example, a part with 50% amplitute (volume) will be e.g. 70%. The maximum volume is limited by the system's volume level, i.e., more than 100% is not possible. This means, everything above a certain level will be made 100%, wich modifies the sound characteristics in a way that causes the distortions (btw., it's the same cause that makes the sound of distorted guitars. This effect origins from overdriven speakers).
If songs are not set to maximum gain, this will have no or less effect.
 

back
When the screen's toggled off, why is the screen on while I press a button?

The system turns on the screen during an application button is pressed. MortPlayer turns it off afterwards.
It could do that during the button's pressed, too, but it would result in a terrible flickering.
 

back
Why is the toolbar so tiny? (WM5/VGA)

Because WM5 (or at least some devices) return the wrong value for the menu bar height.
And I can't ignore this value, because it would result in problems for users which use "real VGA" tools like SE_VGA or OzVGA.