SourceFiles.org - Use the Source, Luke

NAME

xmms-curses - Control XMMS from the command line with a friendly ncurses interface

SYNOPSIS

xmms-curses [<-|+>atlaVh] [ options ]

DESCRIPTION

xmms-curses is a simple application for controlling XMMS from the command line. It is designed to make common, simple tasks fast and easy to do. It is operated using arrow keys and standard XMMS keys, to make it easy and intuitive to learn.

INSTALLATION

Dependencies: make gcc xmms-dev ncurses-dev

I have unfortionately not had the time to make a reasonable autoconf setup. Since people kept nagging me to release something for them, I released it anyway. Just running make might, and might not, do the trick for you. Afterwards, just run make install to copy the binary to /usr/local/bin and the manpage to /usr/local/man/man1, or copy the files manually to some other nice places.

Or, if using Debian, just run dpkg-buildpackage -b -rfakeroot, and install the package you get in ../ using dpkg -i <filename> ;-)

OPTIONS

To negate a short option, use '+' instead of '-' (e.g. +a)

Long-options are negated with 'no-', (e.g. --no-read-all)

-n, --numbers Show numbers in playlist (default on) -t, --title Read the title from ID3/ogg-tags (SLOW) (default on) -l, --length Show length of track in playlist (SLOW) (default on) -a, --read-all Read all titles and lengths on startup (EXTREMELY SLOW)

(default off)
-V, --version Display version information -h, --help Print help message

Tip: Things going slow? Try xmms-curses +tl

KEYS

Arrow right/left:

Skip forward/backward 5 seconds Arrow up/down:

Move up/down in the playlist or search results Page up/down:

Scroll up/down one page in the playlist or search results Enter: Select and play file

    x:     Play
    c:     Pause
    v:     Stop
    z:     Jump to previuos song
    b:     Jump to next song
    0 or +: 
           Increase volume
    9 or -:
           Decrease volume
    j:     Search for file to jump to
    L:     Reload playlist
    q:     Exit from application

Esc: Exit from application, or, if in jump dialog, go to main view

FILES

/etc/xmms-curses.conf

Global configuration file.

$HOME/.xmms-curses

Local configuration file, specific for each user. Can be used to override the global options.

The syntax of the configuration files are long options without the '--', one on each line.

Example: numbers title length no-read-all

BUGS

The xmms remote controlling library provides no good way of detecting changes in the playlist, and therefore xmms-curses might need to be told to reload the playlist if songs are moved. Do so by pressing L. If the length of the playlist changes, xmms-curses will assume the playlist has changed and reload the entire playlist to make sure it is correct.

Probably lots more.

DISCLAIMER

Sorry, no guarantees for you today either. This was pretty much the first thing I ever wrote in C. Expect it to fuck up and blow up your room.

COPYRIGHT

# vim:expandtab:ts=4:sw=4