DisOrder is a multi-user software jukebox. It allows MP3s, OGGs, etc to be @@ -32,14 +49,19 @@ scripting.
This manual is about Disobedience, so it does not really cover + installation or management issues. However in this chapter it will + cover a few such topics as they are necessary to getting up and + running with Disobedience.
+This diagram shows an overview of one possible setup.
-
The server and web interface run on one computer. Disobedience runs on a desktop computer and accesses the server via the network. @@ -48,10 +70,12 @@
Many other configurations are possible. For instance the server could play directly to a local soundcard. Also if Disobedience - runs on the same computer as the RTP player then it can be used to stop - and start the player.
+ runs on the same computer as the RTP player then it can be used to + stop and start the player. Of course Disobedience can also be run + on the same computer as the server provided it can run X11 + applications. -There are two ways to get DisOrder.
@@ -84,12 +108,13 @@If you have another kind of Linux system, or a Mac, you must build from source code. See the README file included in - the source distribution for more details.
+ the source distribution for more details. Note that to use + Disobedience on a Mac, you will need X11.app.There is no Windows support (although the web interface can be used from Windows computers).
-The easiest way to get a DisOrder login is to access the web interface and set one up using that. To do this, @@ -98,7 +123,7 @@ installed. You should then be able to select the Login option at the top of the screen.
-
Go to the New Users form and enter the username you want to use, your email address, and a password. The password must be @@ -106,26 +131,67 @@ displayed on the screen). When you press Register, you will be sent an email requiring you to confirm your registration.
-
Your login won't be active until you click on this URL.
-(It might be that your installation isn't set up to automatic - registration. In that case the system administrator will have to - create your login and set your initial password by hand.)
+(It might be that your installation isn't set up to allow + automatic registration. In that case the local sysadmin will have + to create your login and set your initial password by hand.)
+ +Having done this you could of course just use the web interface. + But since this is the manual for Disobedience, it is assumed that + you want to take advantage of its more convenient design and extra + features.
-On Debian systems it should be possible to find Disobedience in the menu system:
-
On other systems you will have to start it from the command line by typing its name at a command prompt. You can (optionally) use an & suffix to stop it tying up your terminal.
-
(Please note that Disobedience shouldn't write any messages to + the terminal. If it does that probably indicates a bug, which + should be + reported.)
+ +The first time you run Disobedience it won't know what server to + connect to, your username or your password, and will therefore + display a login box.
+ +
If Disobedience is running on a different computer to the + server, then you should make sure the Remote box is ticked + and fill in the host name (or IP address) and port number + (“Service”). If you don't know what values to use + here, ask your local sysadmin. If, on the other hand, Disobedience + is running on the same computer as the server then you can + leave the Remote box clear and it should be able to connect + to it without using the network.
+ +In any case, you will need to enter your username and + password, as set up earlier.
+ +Once you have logged in successfuly, Disobedience will remember + these login settings, so it should not be necessary to enter them + again. If you need to change them for any reason, you can either + select the Server > Login option to bring the login window + back, or (if you prefer), edit the file ~/.disorder/passwd + directly.
+ +