NAME
disobedience - GUI client for DisOrder jukebox
SYNOPSIS
disobedience [OPTIONS]
DESCRIPTION
disobedience is a graphical client for DisOrder.
WINDOWS AND ICONS
Server Menu
This has the following options:
Login Brings up the Login Details Window; see below.
Manage Users
Brings up the User Management Window; see below.
Quit Terminates the program.
Edit Menu
This has the following options:
Select All
Select all tracks in whichever of the Queue or Recent tabs are
showing.
Properties
Edit the details of the selected tracks. See Properties Window
below.
Control Menu
This has the following options:
Scratch
Interrupts the currently playing track.
Playing
Pause and resume the current track.
Random play
Enable and disable random play. Does not take effect until the
currently playing track finishes.
Network player
Enables or disables network play. See NETWORK PLAY below.
Help Menu
This has only one option, "About DisOrder", which pops up a box giving
the name, author and version number of the software.
Controls
Pause button
The pause button can be used to pause and resume tracks.
Scratch button
The scratch button, a red cross, can be used to interrupt the
currently playing track.
Random play button
The random play button can be used to enable and disable random
play. It does not take effect until the currently playing track
finishes.
Play button
The play button controls whether tracks will be played at all.
As above it does not take effect until the currently playing
track finishes.
Network play button
The network play buttons enables or disables network play. See
NETWORK PLAY below.
Volume slider
The volume slider indicates the current volume level and can be
used to adjust it. 0 is silent and 10 is maximum volume.
Balance slider
The balance slider indicates the current balance and can be used
to adjust it. -1 means only the left speaker, 0 means both
speakers at equal volume and +1 means the only the right
speaker.
Queue Tab
This displays the currently playing track and the queue. The currently
playing track is at the top, and can be distinguished by the constantly
updating timer. Queued tracks appear below it.
The left button can be use to select and deselect tracks. On its own
it just selects the pointed track and deselects everything else. With
CTRL it flips the state of the pointed track without affecting anything
else. With SHIFT it selects every track from the last click to the
current position and deselects everything else. With both CTRL and
SHIFT it selects everything from the last click to the current position
without deselecting anything.
Tracks can be moved within the queue by dragging them to a new position
with the left button.
The right button pops up a menu. This has the following options:
Properties
Edit the details of the selected tracks. See Properties Window
below.
Select All
Select all tracks.
Scratch
Interrupt the currently playing track. (Note that this appears
even if you right click over a queued track rather than the cur-
rently playing track.)
Remove Remove the selected tracks from the queue.
Recent Tab
This displays recently played tracks, the most recent at the top.
The left button functions as above, except that drag-and-drop rear-
rangement is not possible. The right button pops up a menu with the
following options:
Properties
Edit the details of the selected tracks. See Properties Window
below.
Select All
Select all tracks.
Choose Tab
This displays all the tracks known to the server in a tree structure.
Directories are represented with an arrow to their left. This can be
clicked to reveal or hide the contents of the directory. The top level
"directories" break up tracks by their first letter.
Playable files are represented by their name. If they are playing or
in the queue then a notes icon appears next to them.
Left clicking on a file will select it. As with the queue tab you can
use SHIFT and CTRL to select multiple files.
The text box at the bottom is a search form. If you enter search terms
here then tracks containing all those words will be highlighted. You
can also limit the results to tracks with particular tags, by including
tag:TAG for each tag.
To start a new search just edit the contents of the search box. The
cancel button to its right clears the current search. The up and down
arrows will scroll the window to make the previous or next search
result visible.
Right clicking over a track will pop up a menu with the following
options:
Play Play selected tracks.
Properties
Edit properties of selected tracks. See Properties Window
below.
A middle click on a track will add it to the queue.
Right clicking over a directory will pop up a menu with the following
options:
Play all tracks
Play all the tracks in the directory, in the order they appear
on screen.
Track properties
Edit properties of all tracks in the directory.
Select all tracks
Select all the tracks in the directory (and deselect everything
else).
Note that these options do not apply recursively - only the tracks in
the relevant directory are affected, not those in its subdirectories.
Added Tab
This displays a list of tracks recently added to the server's database.
The most recently added track is at the top.
Left clicking a track will select it. CTRL and SHIFT work as above to
select muliple files.
Right clicking over a track will pop up a menu with the following
options:
Track properties
Edit properties of selected tracks. See Properties Window
below.
Play track
Play selected tracks.
Select All Tracks
Select all tracks.
Login Details Window
The login details window allows you to edit the connection details and
authorization information used by Disobedience.
At the top is a 'remote' switch. If this is enabled then you can use
the Hostname and Service fields to connect to a remote server. If it
is disabled then then Disobedience will connect to a local server
instead.
Below this are four text entry fields:
Hostname
The host to connect to.
Service
The service name or port number to connect to.
User name
The user name to log in as.
Password
The password to use when logging in. Note that this is NOT your
login password but is your password to the DisOrder server.
It has two buttons:
Login This button attempts to (re-)connect to the server with the cur-
rently displayed settings. The settings are saved in
$HOME/.disorder/passwd. on success.
Close This button closes the window, discarding any unsaved changes.
Properties Window
This window contains details of one or more tracks and allows them to
be edited.
The Artist, Album and Title fields determine how the tracks appear in
the queue and recently played tabs.
The Tags field determine which tags apply to the track. Tags are sepa-
rated by commas and can contain any printing characters except comma.
The Weight field determines the track weight. Tracks with higher
weights are proportionately more likely to be picked at random. The
default weight is 90000, and the maximum weight is 2147483647.
The Random checkbox determines whether the track will be picked at ran-
dom. Random play is enabled for every track by default, but it can be
turned off here.
The double-headed arrow to the right of each preference will propagate
its value to all the other tracks in the window. For instance, this
can be used to efficiently correct the artist or album fields, or bulk-
disable random play for many tracks.
Press "OK" to confirm all changes and close the window, "Apply" to con-
firm changes but keep the window open and "Cancel" to close the window
and discard all changes.
User Management Window
This window is primarily of interest to adminstrators, and will not be
available to users without admin rights. The left hand side is a list
of all users; the right hand side contains the editable details of the
currently selected user.
When you select any user you can edit their email address or change
their password. It is also possible to edit the individual user
rights. Click on the "Apply" button to commit any changes you make.
The "Add" button creates a new user. You must enter at least a user-
name. Default rights are setting according to local configuration, not
server configuration (but this may be changed in the future). As
above, click on "Apply" to actually create the new user.
The "Delete" button deletes the selected user. This operation cannot
be undone.
KEYBOARD SHORTCUTS
CTRL+A Select all tracks (queue/recent)
CTRL+L Brings up the Login Details Window.
CTRL+Q Quit.
NETWORK PLAY
Network play uses a background disorder-playrtp(1) process. If you
quit Disobedience the player will continue playing and can be disabled
from a later run of Disobedience.
The player will log to ~/.disorder/HOSTNAME-rtp.log so look there if it
does not seem to be working.
You can stop it without running Disobedience by the command killall
disorder-playrtp.
OPTIONS
--config PATH, -c PATH
Set the configuration file. The default is /etc/disorder/con-
fig.
--debug, -d
Enable debugging.
--help, -h
Display a usage message.
--version, -V
Display version number.
GTK+ Options
Additional options are supported by the GTK+ library. Refer to GTK+
documentation for further information. Under X11 they include:
--display DISPLAY
The X display to use.
--screen SCREEN
The screen number to use.
CONFIGURATION
If you are using disobedience on the same host as the server then no
additional configuration should be required.
If it is running on a different host then the easiest way to set it up
is to use the login details window in Disobedience. Enter the connec-
tion details, use Login to connect to the server, and then use Save to
store them for future sessions.
The other clients read their configuration from the same location so
after setting up with Disobedience, tools such as disorder(1) should
work as well.
BUGS
There is no particular provision for multiple users of the same com-
puter sharing a single disorder-playrtp process. This shouldn't be too
much of a problem in practice but something could perhaps be done given
demand.
Try to do remote user management when the server is configured to
refuse this produces rather horrible error behavior.
Only one track can be dragged at a time.
Resizing columns doesn't work very well. This is a GTK+ bug.
FILES
~/.disorder/HOSTNAME-rtp
Socket for communication with RTP player.
~/.disorder/HOSTNAME-rtp.log
Log file for RTP player.
SEE ALSO
disorder-playrtp(1), disorder_config(5)
http://www.greenend.org.uk/rjk/disorder/
- DisOrder home page
http://www.gtk.org/api/2.6/gtk/gtk-x11.html
- Using GTK+ on the X Window System