SongChange(3)

NAME
Xmms::SongChange - Take actions based on song track/time change

SYNOPSIS
 xmms> change on

DESCRIPTION
This module creates a thread to poll xmms for song track and time changes. The thread is started via the Xmms::shell command change on and stopped via change off.

CAVEATS
This module is considered very EXPERIMENTAL. During testing, it caused xmms to freeze sometimes. However, this freezing occured with xmms version 0.9, I have seen no freezing with version 0.9.1.

The module decides if a song has changed based on track number or track length. So, when only one track is in the playlist, this logic is broken.

Since the thread is constantly polling xmms via the remote protocol, xmms is consuming more cpu time than normal.

FEATURES
Current features include: When Xmms::SongChange is running, it will auto jump to the current track's jtime, if any. The Xmms::shell repeat command can be used with 2 additional arguments, to repeat a track in the playlist n number of times before advancing. Example:

 xmms> repeat 1 3
This command will cause track 1 to be repeated 3 times before advancing. Xmms::SongChange adds a new crop command, which is similar in concept to jtime, but advances to the next track in the playlist when the current track crop time is reached. Example:

 xmms> crop 2 4:30
This command will cause playlist advance when track 2 reaches the output time of 4:30.

With no arguments, the current output time is set as the crop time for the current track. The M-c key binding has the same effect. When the SongChange thread is running, the Xmms::shell clear command will also clear all SongChange watch points.

TIPS
The Xmms::shell history command can be used to run a "script". For example, consider a file such as:

 change on
 clear
 add /usr/local/mp3/prodigy/live/speedway.mp3
 add /usr/local/mp3/prodigy/live/rock_n_roll_98.mp3
 jtime 1 1:19
 crop 1 2:17
 repeat 1 3
 jtime 2 1:00
 crop 2 4:20
 play
Which can be run in the shell like so:

 xmms> history < ~/mp3/example.sc

FUTURE
I plan to implement the following features in the future: start to fade the volume at a given time. similar to using jtime and crop, but in the middle of a song. of course, this can already be done by adding the same file to the playlist multiple times and setting different jtime and crop times for each.

AUTHOR
Doug MacEachern