[ previous ] [ Copyright Notice ] [ Contents ] [ next ]

Ksmp3play 0.5.1
Chapter 3 Usage


3.1 Command line options

     Usage: ksmp3play [OPTION ...] FILE1 [FILE2 ...]
     Options:
       -h, --help                 display this help and exit
       -v, --version              output version information and exit
       -r, --random               start in random play mode
       -l, --loop                 start in loop play mode
       -t, --title                set xterm title (0/1, default=1)
       -d, --delay                delay between songs (in seconds)
       -m, --rmethod              method used for random play (1/2/3)
       -p, --playlist             default playlist to save to

You may specify as many files as you wish at the command line. These can be either mp3, m3u, or ks3 files, or even an URL for http streaming. It's not necessary to use the --playlist option if only one ks3 file is specified, since this file will be considered the default playlist.


3.2 Config file

Ksmp3play looks for a dot-file in the user's home dir called .ksmp3playrc. The format of this file is variable = value, one variable on each line. Empty lines and lines beginning with # are ignored.


3.2.1 General config variables

The general config variables you can set in the config file are:

Here's an example:

     #
     # Conf file for ksmp3play
     #
     
     # Start in random play mode (0/1)
     Random = 1
     
     # Start in loop play mode (0/1)
     Loop = 1
     
     # Set xterm title to currently playing song
     Set_xterm_title = 1
     
     # Default volume (0-100)
     Volume = 80


3.2.2 Keybindings

Since version 0.5 you can bind most of the commands in ksmp3play to keys of your choice. The format is very similar to the other config variables. Here's an example:

     PAUSE = p
     JUMP_TO_CURRENT = P

This will bind the key 'p' to the pause command and the 'shift + p' to jump to currently playing song. You may however want to use keys that can't be typed as a single character. This is done by entering '\' followed by the ASCII code. Here's an example:

     PAUSE = \32
     JUMP_TO_CURRENT = \9

This will bind ASCII code 32 (space) to the pause command, and ASCII code 9 (tab) to jump to currently playing song.

Here's a list of the keybindings you can specify:


3.3 In-program controls

These are the default controls. The ones marked with an asterisk may be customised. See Keybindings, Section 3.2.2 for more info.


3.3.1 Controls


3.3.2 Song options


3.3.3 Playlist options


3.3.4 File browser


3.3.5 Playmodes


3.3.6 Other


3.4 Song ratings and volume

Ksmp3play allows you to rate the songs in a playlist with a value between 1 and 9. This affects the chance of that particular song being played in random play mode. See Why three different methods for random play?, Section 4.4 for more details.

The volume is individual for each song, with a default of 80 or what's specified in the config file. This, along with the song rating, is saved in the .ks3 playlist.


[ previous ] [ Copyright Notice ] [ Contents ] [ next ]
Ksmp3play 0.5.1
19 August 2001
Karl Söderström ks@xanadunet.net