We figure there should be a walkthrough with pictures, 'cause everyone likes pictures.

This is what eMotion looks like. It's pretty standard for a media player with a playlist. The video is played in a seperate window.

These are the standard video controls.
 | Pressing 'play' plays the currently active file in the playlist, the first file in the playlist, or gives an open dialog, depending on the situation. If there are no items in the playlist, pressing 'play' is the same as pressing 'open' and then pressing 'play'. The only point of confusion is in the difference between the active file in the playlist and the selected file in the playlist. The active file has a smallified play icon ( ) beside it. If nothing is active, the first file in the playlist will be played. To play the selected file, just double click on that file in the playlist.
If play is hit while a file is playing, playback will restart at the beginning of the file.
When the play button is used to open a file, it opens the file using the open dialog |
 | The 'stop' button ceases playing the active file and closes the video window. |
 | The 'pause' button stops the video from playing without closing the video window. If skip-forward or skip-back is hit while a movie is pause, the player will switch to the next or previous file and start playing it, not keep it paused. If fast-forward or rewind is hit while paused, it will unpause but not seek in the file. |
  | The skip-back and skip-forward buttons cause the currently playing file to stop playing and the next or previous file, depending on which button was clicked, to start playing. If playback was currently stopped, the next file will not start to play but it will become the active file.
If looping is not on, and the last file is currently playing, pressing skip-forward will cause it to stop playing and there will no longer be an active file, if looping is off. Skip-back operates the same. If skip-forward is pressed at the end of the playlist while looping is on, the first file in the playlist will be treated as the next file. Skip-back operates the same regardless of whether looping is on or off (it always stops if you skip-back at the start of the list).
If the skip-forward button is clicked while there is no active file, the first file in the playlist will be started playing. If skip-back is clicked while there is no active file, the last file in the list will start to play. |
  | 'Rewind' and 'fast-forward' cause the video playback to skip several seconds. If fast-forward is clicked, the next several seconds will be passed by. If rewind is clicked, the video will go back several seconds.
If fast-forward is held until past the end of the file, that file will end playing and the next will start. If rewind is held and the beginning of the file is hit, it will stay playing that file and repeatedly rewind to the start until the rewind key is released.
WARNING: Be careful when rewinding and fast-forwarding. Keystrokes are queued up and will all be executed. If you hold down fast-forward, it will not stop when you release the fast-forward button, it will stop when it has skipped forward once for every time you hit the key. Also, the pause, rewind, and fast-forward commands not will be received as long as the file is still fast-forwarding. Rewind behaves likewise. |

These are some important control relating to watching the movies you love.
  | The subtitles button shows whether or not subtitles are currently being displayed. It will be in the 'no subtitles' position if subtitles are turned off or in the 'subtitles' position if subtitles are turned on. Clicking on it will switch toggle it between the two. The subtitle button cannot be used while a video is not being played. The button will flash, but nothing else will occur. |
 | This is the fullscreen button. Clicking on it makes the video window take over the main screen so only the video being played will be seen. |
  | Clicking the volume/mute icon causes muting and unmuting to occur. While muted, the icon will change. Moving the volume slider chanegs the sound volume up and down. The further to the left, the quieter, the further to the right the louder. If the volume is set to mute, and the volume slider is moved, it will not un-mute the volume, but it will cause the volume it change. If you then click the mute/un-mute button again, it will switch back to where it was before you originally muted it. |

This is the seekbar. It shows what percent of the way through playback you are in any given file. Clicking on the slider and dragging it will cause you to jump to a specific place in the file. Clicking on the bar ahead or behind the slider will cause it to jump for a moment, but will not actually cause the video to seek forwards or backwards.

This is the playlist and the playlist controls.
 | The playlist file noted with this icon is the active file. It is either playing, paused, or stopped. Any control buttons hit will apply to this file. Hitting play will cause it to play, skip forward will move to the file after this one, etcetera.
A file can be played out of order by double clicking on it, which will both play it and make it the active file.
When the last file in the playlist is played, playback will stop and there will be no active file.
When there is no active file selected, the first file in the list will be played if the play command is given. Likewise, the skip-forward command will cause the first file to be played. |
 | The add button will allow you to add a file to the playlist. You may select and add multiple files. Files are always added at the end of the playlist. Files are added by using the open dialog. |
 | If you click and hold the add button, a menu will pop up. There are two options: Add File(s) and Add Directory Recursively. Add File(s) is the same as just clicking the add button once. Add Directory Recursively allows you to select a single directory and add its contents and the contents of all of its subdirectories to the playlist. Be careful with this, as adding several thousand items can cause slowdown, and this does not check if files can be played, it just adds them, so text file, video files, and executable files would all be added alike if they were in a directory. |
 | The remove button will remove all the files which are currently selected. Clicking on the remove button and holding it down for a second will cause a menu to pop up. Removing a file while it is being played back causes the next file to become the active file and start being played back. |
 | The remove menu has two options. 'Remove File(s)' is identical to merely clicking on the remove button. 'Remove All' empties the entire playlist, regardless of what is selected. |
  | The loop button show whether the playlist is set to repeat when it finished playing. If set to loop, the first file will become active and start playing when the last file finished playing. If not set to loop, playback will stop when the last file finishes playing. The loop button will stay set however you set it when you close and reopen eMotion. The loop state is represented by arrows pointing into each other. The unloop state is represented the same, but with blocky heads instead of arrow-heads. |
  | To move items in the playlist, use these buttons. Pressing the up arrow will move all the selected files up one space in the playlist. Pressing the down arrow will move all the selected files down one space in the playlist. |

In eMotion, the toolbar doubles as a menubar.
 | This opens the eMotion menu, which contains the 'About eMotion', 'Open', 'Options', and 'Quit'. |
 | About eMotion pops up a dialog telling you that eMotion was coded by Mike Swieton and arted by Micah Abresch, as well as showing the icon, version, and copyright date.
Open pops up an open dialog. You can select multiple files, then open them, at which point they will be added to the playlist but not played.
Options pops up the configuration dialog.
Quit causes eMotion to exit. If there are any video windows open, they are closed as well. |
 | The open button is the same as selecting 'Open' in the eMotion menu. |
 | Pressing the DVD button will open the DVD dialog. |
 | The configuration button is the same as selecting 'Options' in the eMotion menu. |
 | The 'What's This?' button allows you to get more information about a button by clicking on it. Clicking on the 'What's This?' button will change your cursor to a cursor with a question mark beside it. If you then click on a button, some information about that button will pop-up in the same manner as a tool-tip, except that it will remain until you click somewhere else. Clicking somewhere else does not just make the tip disappear. If you click on a button, that will be the same as clicking that button but it will also make the tip disappear. |
 | The quit button is the same as selecting 'Quit' in the eMotion menu. |

Open Dialog is mostly a standard open dialog, except for the three options at the bottom.
Rebuild Index has a checkbox. If it is selected, the index for that video file will be redetermined by MPlayer. This is very slow, often taking a minute or longer, and gives no indication it is occuring. Instead, eMotion will hang while this operation is taking place. This only has any effect on AVI files. MPEG and most other file formats do not have indexes. If a file has no index or a broken index, seeking (fast-forward/rewind) will be impossible in it. Rebuilding the index will likely solve this problem, but may result in an unusual appearance while seeking. This option is only useful if you know a file has a broken index and want to be able to seek in it.
Non-interleaved & No-cache is the next option, also just on or off, depending on if you check the checkbox. This option is of use with badly interleaved or non-interleaved AVI files. If a file allows seeking, but the seeking is extremely slow, this should solve that problem. On files that do not have this problem, do not bother with this option.
Volume boost increases volume before sending it to the sound device, allowing a higher than normal maximum volume. Unfortunately, boosting the volume very far can cause clipping. Up to about 5 usually sounds okay, and 10 is usually decent as well. This should never be set above 20, as the sound output will be horrible. This option is often needed for extremely quiet video plays to be intelligible.

There is only one option here: DVD Title. eMotion will play the DVD beginning with this title. There is no support, currently, for DVD menus or chapter by chapter navigation.

The configuration dialog only has a few options, and they mostly don't need changing.
If fullscreen is checked, videos will start in fullscreen when they are played.
MPlayer Location is just the command line used to start MPlayer. This should be 'mplayer', unless MPlayer was installed to a directory not in your path, or you have a really weird setup.
Mixer Device is the path to the sound mixer you use.
Audio Output Driver is what sound system or sound server you are using. If you are having errors with sound output (no sound output) you might need to set this to something. If it is not set to anything in particular, MPlayer will attempt to automatically determine the proper drive, so this should be able to be left blank. All options available are oss, alsa9, arts, esd, sdl, null, and pcm.
PCM output will result in a file named 'audiodump.wav' being created in either your home directory or the directory emotion was launched from. This will be a WAV file of the sound to the video that you played. Also, the video will play extremely fast and jerky (most likely) as it will be synced to the speed at which the audio output is written.
Putting in an option besides those noted will cause there to be no sound output.
This is identical to passing options to MPlayer after the -ao option. You can check the MPlayer documentation for specifics on what this does.
X Display is for output to multiple screens without xinerama. Whatever X Display is set to is where the video window will open.