.\" Man page for xmms-curses
.\" 
.\" This file is part of xmms-curses, copyright 2003-2005 Knut Auvor Grythe.
.\" 
.\" xmms-curses is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\" 
.\" xmms-curses is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with xmms-curses; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.pc
.TH xmms-curses 1 "2004-10-16" "0.2" "Ncurses remote for XMMS"
.SH NAME
xmms\-curses \- Control XMMS from the command line with a friendly ncurses
interface
.SH SYNOPSIS
.B xmms\-curses
.RB [<\| \- \||\| + \|>ntlaVh \|] 
[ 
.I options
]
.SH 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.
.SH OPTIONS
To negate a short option, use 
.RB '\| + \|'
instead of 
.RB '\| \- \|'
(e.g. 
.RB \| +a \|).
.br
Long-options are negated with 
.RB \| no\- \|,
(e.g. 
.RB \| \-\-no\-read\-all \|).
.TP
.B \-n, \-\-numbers  
Show numbers in playlist (default on)
.TP
.B \-t, \-\-title    
Read the title from ID3/ogg\-tags (SLOW) (default on)
.TP
.B \-l, \-\-length   
Show length of track in playlist (SLOW) (default on)
.TP
.B \-a, \-\-read\-all 
Read all titles and lengths on startup (EXTREMELY SLOW) (default off)
.TP
.B \-V, \-\-version  
Display version information
.TP
.B \-h, \-\-help     
Print help message
.LP
Tip: Things going slow? Try 
.B xmms-curses -ntl
.SH KEYS
.TP
.B Arrow right/left
Skip forward/backward 5 seconds
.TP
.B Arrow up/down
Move up/down in the playlist or search results
.TP 
.B Page up/down
Scroll up/down one page in the playlist or search results
.TP
.B Enter
Select and play file
.TP
.B x
Play
.TP
.B c
Pause
.TP
.B v
Stop
.TP
.B z
Jump to previuos song
.TP
.B b
Jump to next song
.TP
.B 0 or +
Increase volume
.TP
.B 9 or \-
Decrease volume
.TP
.B j
Search for file to jump to
.TP
.B L
Reload playlist
.TP
.B q
Exit from application
.TP
.B Esc
Exit from application, or, if in jump dialog, go to main view
.SH FILES
.TP
.B /etc/xmms-curses.conf
Global configuration file.
.TP
.B $HOME/.xmms-curses
Local configuration file, specific for each user. Can be used to override 
the global options.
.LP
The syntax of the configuration files are long options without the '--', one 
on each line.
.TP 
.B Example:
numbers
.br
title
.br
length
no-read-all
.SH BUGS
The xmms remote controlling library provides no good way of detecting changes
in the playlist, and therefore
.B xmms\-curses
might need to be told to reload the playlist if songs are moved. Do so by
pressing 
.RB \| L \|.
If the length of the playlist changes, 
.B xmms\-curses 
will assume the playlist has changed and reload the entire playlist to make
sure it is correct.

Probably lots more.
.SH AUTHOR
.nf
Knut Auvor Grythe <xmms-curses@auvor.no>.
.fi