NAME

hot-potato - timer for hot potato or other games

VERSION

version 0.110020

SYNOPSIS

hot-potato -t 20 -T 40 -r 5 -R 15 -s my_sounds

DESCRIPTION

This plays some music or a sound for a random amount of time that you can specify. Towards the end, it plays different music for the "rush" to the finish. Finally, it will play a sound to signify that the timer has ended. It's that simple.

There's also a couple of other sounds at the start and between rushes, but those are broken at the moment.

OPTIONS

--minumum-time N

-t N

The timer will never be shorter than this number of seconds.

--maximum-time N

-T N

The timer will never be longer thant his number of seconds. This must always be longer than the minimum time.

--minimum-rush N

-r N

The rush will start at least this many seconds before the end. This must always be shorter than the minimum time.

--maximum-rush N

-R N

The rush will never be longer than this many seconds before the end. This must always be shorter than the minimum time and as long or longer than the minimum rush.

--sound-theme NAME

-s NAME

This is the name of the sound theme to use. See "CONFIGURATION" for details.

--start-alert

This is the sound to play at the start. Overrides the sound theme. See "BUGS".

--rush-alert

This is the sound to play when the rush starts. Overrides the sound theme. See "BUGS".

--final-alert

This is the sound to play when the timer stops.

--start-music

This is the music to play when the timer starts.

--rush-music

This is the music to play during the rush.

BUGS

I need to fix the start sound and sound between the starting music and rush music.

AUTHOR

Andrew Sterling Hanenkamp <hanenkamp@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Qubling Software LLC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.