A package to play an alarm after an interval
Project description
PyBites Alarm
Play a music file or voice message after an interval of N minutes or seconds.
Install the tool
$ pip install pybites-alarm
$ alarm
usage: alarm [-h] (-s SECONDS | -m MINUTES) [-b | -d] [-l SONG_LIBRARY | -f FILE | -M MESSAGE] [-v] [-t TIMEOUT]
alarm: error: one of the arguments -s/--seconds -m/--minutes is required
Usage
You can specify an interval time using seconds (-s
) or minutes (-m
).
By default it runs in the foreground, but you can run it in the background using b
.
To display the seconds countdown use -d
.
There are three ways to play an alarm file:
-
Specify one with
-f
. -
Pick a random file from your music library directory. For that use
-l
. -
Use a default file by setting
ALARM_MUSIC_FILE
in.env
, for example:$ cat .env ALARM_MUSIC_FILE=/Users/bbelderbos/Music/alarm.mp4
It can be confusing when a music file plays so since 0.0.4
you can play a voice message instead using -M
(--message
).
For example:
alarm -M "stand up for a walk" -m 20 -b
A voice repeats "stand up for a walk" three times after 20 minutes. Pretty useful for programmers :)
For long alarm files you can set a timeout to stop the alarm after N seconds using the t
(--timeout
) switch.
Here are all the supported options again:
$ alarm -h
usage: alarm [-h] (-s SECONDS | -m MINUTES) [-b | -d] [-l SONG_LIBRARY | -f FILE | -M MESSAGE] [-v] [-t TIMEOUT]
Play an alarm after N minutes
optional arguments:
-h, --help show this help message and exit
-s SECONDS, --seconds SECONDS
Number of seconds before playing alarm (default: None)
-m MINUTES, --minutes MINUTES
Number of minutes before playing alarm (default: None)
-b, --background Run timer in the background (default: False)
-d, --display_timer Show timer in console (default: False)
-l SONG_LIBRARY, --song_library SONG_LIBRARY
Take a random song from a song library directory, supported formats: .mp3, .mp4, .wav (default: None)
-f FILE, --file FILE File path to song to play as alarm (default: None)
-M MESSAGE, --message MESSAGE
Set an audio message to play for alarm (default: None)
-v, --version show program's version number and exit
-t TIMEOUT, --timeout TIMEOUT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pybites_alarm-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1d631508ad29e9c292aabaa887c204de8c0e5f004f43a1b6da7c50b34c1f64d6 |
|
MD5 | d3a11934e9902298452d34df3d7b0ff7 |
|
BLAKE2b-256 | e6ecbaca60f7d9c72762153fb19065002c973f1132eb6f27785c47508e9176c8 |