1. Introduction

This chapter covers the following topics:

1.1 What is DisOrder?

DisOrder is a multi-user software jukebox. It allows MP3s, OGGs, etc to be played either using a single sound card or over a network to many different computers, with multiple different people controlling what is played.

DisOrder has three main user interfaces.

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.

1.2 Getting DisOrder

There are two ways to get DisOrder.

If you have a Debian system you can download the .deb files from DisOrder's home page and install those. There are four packages to choose from:

(At the time of writing, DisOrder is not included as part of Debian.)

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. 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).

1.3 Getting a DisOrder login

The easiest way to get a DisOrder login is to access the web interface and set one up using that. To do this, visit http://HOSTNAME/cgi-bin/disorder, where HOSTNAME is the name of the server where DisOrder is 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 entered twice to verify you did not mistype it (since it won't be 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 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.

1.4 Starting Disobedience

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.)

1.5 Initial Login

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.

Back to contents