From: Richard Kettlewell Date: Thu, 26 Nov 2009 13:18:47 +0000 (+0000) Subject: Most of intro section X-Git-Tag: 5.0~38^2~15 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/commitdiff_plain/750e9f84216e473903d634360aa49148c8ba72ec Most of intro section --- diff --git a/disobedience/manual/disobedience-debian-menu.png b/disobedience/manual/disobedience-debian-menu.png new file mode 100644 index 0000000..49bbdb4 Binary files /dev/null and b/disobedience/manual/disobedience-debian-menu.png differ diff --git a/disobedience/manual/disobedience-terminal.png b/disobedience/manual/disobedience-terminal.png new file mode 100644 index 0000000..5cf2e8d Binary files /dev/null and b/disobedience/manual/disobedience-terminal.png differ diff --git a/disobedience/manual/disorder-email-confirm.png b/disobedience/manual/disorder-email-confirm.png new file mode 100644 index 0000000..c535a67 Binary files /dev/null and b/disobedience/manual/disorder-email-confirm.png differ diff --git a/disobedience/manual/disorder-web-login.png b/disobedience/manual/disorder-web-login.png new file mode 100644 index 0000000..3155a4c Binary files /dev/null and b/disobedience/manual/disorder-web-login.png differ diff --git a/disobedience/manual/index.html b/disobedience/manual/index.html new file mode 100644 index 0000000..aac1a64 --- /dev/null +++ b/disobedience/manual/index.html @@ -0,0 +1,18 @@ + + + + Disobedience + + + +

Disobedience

+ +

This is the manual for Disobedience, the graphical client + for DisOrder.

+ +

1. Introduction

+ + + diff --git a/disobedience/manual/intro.html b/disobedience/manual/intro.html new file mode 100644 index 0000000..555effb --- /dev/null +++ b/disobedience/manual/intro.html @@ -0,0 +1,131 @@ + + + + Disobedience: Introduction + + + +

1. Introduction

+ +

This chapter covers the following topics:

+ +

What DisOrder and Disobedience are, and how to get them
How to get a DisOrder login
How to start Disobedience

+ +

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.

+ +

It has a command-line interface, suitable for ad-hoc use and + scripting.
It has a web interface, usable with graphical web browsers + (Firefox, Opera, Internet Explorer etc).
It has a graphical client called 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. + On another system the RTP player runs and plays sound received from + the server via its local sound card.

+ +

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.

+ +

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:

+ +

disorder.deb - the base package. You should always + install this. It contains the command-line client.
disorder-server.deb - the server and web interface. + Only install this if you are setting up a totally new DisOrder + installation. If you just want to access an existing one, you + don't need this package.
disobedience.deb - the graphical client. If you are + reading this manual you want this package!
disorder-rtp.deb - the network play client. If your + server is set up to transmit sound over the network you will need + this. If it uses a local sound card then this package won't be + useful to you.

+ +

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

+ +

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 automatic + registration. In that case the system administrator will have to + create your login and set your initial password by hand.)

+ +

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.

+ +

+ + +