User Manual

Hang The DJ User's Manual
HangTheDJ is an MP3 player that frees you from managing playlists.

There are two major modes of operation: listening to music in the Small View, and editing song data in the Large View.

Small View
Here's a screenshot of Small View:



Brief rundown:


 * Volume control
 * Playlist combobox. This shows the currently-playing song.  If you drop down the list, you can see the songs queued to be played next.  If you select one, it will immediately start playing, skipping past the songs above the song you selected.
 * System toolbar: move window, switch to Large View, windowshade mode toggle, minimize to taskbar, exit
 * Song progress. Drag the slider to skip to different points in the song.  You can also do this with the left and right arrow keys.
 * Main toolbar: options, always-on-top, refresh playlist, bump current song rating higher, bump it lower, permanently ignore current song, copy playlist to media directory, rescan for song files
 * Navigation toolbar: previous song, set current song stomp-in point, pause, set stomp-out point, next song
 * DJ combobox. Different DJ's can be configured, and each has an opinion about every song.  Switch between them with this combobox.
 * Main menu. Contains items for most operations, including everything on the toolbars.

All the controls are within Internet Explorer-like toolbar bands that can be dragged into different positions. In addition, right-clicking on an empty area of one of the button toolbars will let you customize the buttons' visibility and order.

Large View
Here's a screenshot of Large View:



Brief rundown:


 * Toolbars, similar to Small View
 * Playlist. Shows all the upcoming songs selected by the current DJ.  You can drag/drop to change order, or double-click to jump to a specific song.
 * Master song list. Shows all your songs.  Sort by columns by clicking on them.  Hold down Ctrl for multiple column sorting.  Type in the search box, the master list will be filtered to show what you type, as you type it.  Type in any of the column filter bars to sort based on column contents.  Drag from the master list to the playlist.  Right-click for other options.
 * Editor. There are two editor pages.  The one shown allows you to change the DJ ratings.  The other page shows all the details for the song, like song name, artist, album, genre, etc.
 * Friends. This lets you see the current playlists of other HangTheDJ users.  This is a work in progress.

Options

 * General
 * Song locations
 * View
 * Copy playlist songs
 * My DJs
 * Custom attributes
 * Log
 * Connections

ShareTheDJ
ShareTheDJ is an executable that runs on linux. The executable is named sharethedj. It is basically an HTTP server that listens for requests from HangTheDJ clients. Typically, you run it as root, specifying the port to listen on. Usage:

sharethedj

The certificate file and passphrase are required but not used at this time - just type dummy values. That's about all you have to do. Then in HangTheDJ, specify the IP or URL of the linux box, along with the port. Any client that connects to the server will be able to view any other connected user, and request a view of their playlist. More to come!