.\" Man page for audtty .\" .\" This file is part of audtty, Copyright 2003-2005 Knut Auvor Grythe. .\" Copyright 2009 Chris Taylor .\" .\" audtty 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. .\" .\" audtty 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 audtty; if not, write to the Free Software .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA .pc .TH audtty 1 "2010-02-28" "0.1.12" "Ncurses remote for Audacious" .SH NAME audtty \- Control Audacious from the command line with a friendly ncurses interface .SH SYNOPSIS .B audtty .RB [<\| \- \||\| + \|>ahlntV \|] [ .I options ] .SH DESCRIPTION audtty is a simple application for controlling Audacious 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 Audacious 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 The keys for basic control are as follows: +-----------------------+ .br | << > || o >> | .br +-----------------------+ .br z x c v b .TP .B \-a, \-\-read\-all Read all titles and lengths on startup (EXTREMELY SLOW) (default off). .TP .B \-h, \-\-help Print help message. .TP .B \-l, \-\-length Show length of track in playlist (SLOW) (default on). .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 \-V, \-\-version Display version information. .LP Tip: Things going slow? Try .B audtty -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 Esc Exit from application, or, if in other dialog, go to main view. .TP .B 0 or + Increase volume. .TP .B 9 or \- Decrease volume. .TP .B a Open a file browser window. .TP .B b Jump to next song. .TP .B c Pause. .TP .B d Remove currently selected item from playlist. .TP .B j Search for file to jump to. .TP .B L Add URI to playlist. .TP .B q Exit from application. .TP .B R Reload playlist. .TP .B u Save playlist. .TP .B v Stop .TP .B x Play .TP .B z Jump to previuos song .SH FILE BROWSER .TP .B Enter Will either add the current selection if it is a file, or change directories if it is a directory. .TP .B a or A Will add selected file or directory to the playlist. .TP .B q or Esc Exit back to the main playlist window. .SH CONFIGURATION FILES .TP .B /etc/audtty.conf Global configuration file. .TP .B $HOME/.audtty.conf 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 audtty 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 audtty will assume the playlist has changed and reload the entire playlist to make sure it is correct. Probably lots more. .SH AUTHORS .nf See /usr/share/doc/audtty/copyright for the list of authors. .SH RESOURCES The audtty website can be found at .sp This man page was originally written by Knut Auvor Grythe . Updated by Chris Taylor . .sp .fi