File: README

package info (click to toggle)
moosic 1.2.5-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 124 kB
  • ctags: 90
  • sloc: python: 937; makefile: 31
file content (54 lines) | stat: -rw-r--r-- 2,839 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Moosic - A musical jukebox program.
Version 1.2.5
By Daniel Pearson

Moosic is a music player that focuses on easy playlist management. It consists
of a server process that maintains a queue of music files to play and a client
program which sends commands to the server. The server continually runs through
its playlist, popping items off the top of the list and playing each with an
external program. The client is a simple command-line utility which allows you
to perform powerful operations upon the server's queue, including the addition
of whole directory trees, automatic shuffling, and item removal according to
regular expressions. The server comes configured to play MP3, Ogg, MIDI, MOD,
and WAV files.

REQUIREMENTS:
This program is written in Python, and thus requires a Python interpreter. It
also relies on the Unix "find" utility. It relies upon external programs for
actually playing the music files. The default setup uses mpg123 for MP3,
timidity for MIDI, ogg123 for Ogg/Vorbis, mikmod for the whole range of MOD
formats, and the play command (from the SOX distribution) for all the formats
handled by SOX. Moosic will only work on Unix systems, since it uses a wide
variety of Unix-only features. All of these portability issues are noted
within the source code.

INSTALLATION:
There's nothing to compile, since moosic is just a pair of Python scripts.
Simply move the two scripts to wherever you like. They don't need to be next
to each other or anything like that. I prefer to place moosicd outside of my
$PATH, so that it doesn't come up as an option for command-line completion.

USAGE:
First, you must start up the moosic server, moosicd. You can simply run it
without arguments. Now you can control moosicd with the client script, moosic.
moosic is a command-line script that sends a control message to moosicd, and
then returns more or less immediately afterward. The first non-option argument
to moosic is the name of a command to be performed. Use "moosic --showcommands"
to learn what all the commands are. For example, "moosic add foo.mp3" adds the
file foo.mp3 (in the current directory) to the end of the playlist. Any command
which takes a list of files will also accept directories, and doing so will
cause every file below that directory to be included in the file-list. Note
that the default behavior of the moosic client is to shuffle everything in a
file-list before sending the list to the server, but after recursively
expanding named directories.

BUGS:
There are no known bugs. (yay!)
Please report any bugs that you discover to Daniel Pearson <dpears2@umbc.edu>.


Copyright (C) 2001 Daniel Pearson <dpears2@umbc.edu>

This program is free software, and can be redistributed and/or modified under
the terms of the GNU General Public License (GPL).  See the file named
"License" for more details.