Generate spoken numbers mp3 files used for Memory Competitions
Generate spoken numbers mp3 files used for Memory Competitions and training.
Usage and command line options
usage: spokennumbers [-h] [-n NUMBERS] [-p INIT_SILENCE] [-c] [-s SPEED] [-d SOURCE] [-e EXCLUDE] [-o OUTPUT_FILE] [-i] Generate spoken numbers audio files. If no options are provided, a random 100-digit mp3 file will be created. A text file will also be created next to the mp3 file contaning the raw numbers (used for recall). optional arguments: -h, --help show this help message and exit -n NUMBERS, --numbers NUMBERS The number of random digits to generate. Defaults to 100. If a text file is specified, all digits it contains will be used instead (parsed by regexp). -p INIT_SILENCE, --init-silence INIT_SILENCE Add some seconds of silence in the beginning of the audio file. Defaults to 3 seconds. -c, --skip-countdown By default, a countdown sequence will be spoken at start: "3 ... 2 ... 1 ... a ... b ... c ... ...". This option skips the countdown. -s SPEED, --speed SPEED The pace at which numbers will be spoken in seconds. Defaults to one digit per second. -d SOURCE, --source SOURCE Audio files source. The string "default" will use the default audio files included in the Python package. For custom audio files, you can specify the path to a directory as source. The directory must contain the required audio wav files: 0.wav ... 9.wav and a.wav, b.wav and c.wav. -e EXCLUDE, --exclude EXCLUDE This option is used to exclude specified digits from the output. For example, if `--exclude 789` is used, the digits 7, 8 and 9 will not be present in the output file. -o OUTPUT_FILE, --output-file OUTPUT_FILE Name of output file. Defaults to `spoken.mp3`. -i, --skip-txt-file Do not create the txt file containing the spoken numbers next to the audio file. The txt file is used for recall. Example: $ spokennumbers -n 150 --speed 1.2 -o monday_training.mp3
$ python3 -m pip install spokennumbers
or from source (make sure you have python3 -m pip install wheel setuptools first):
$ git clone https://github.com/Penlect/spokennumbers.git $ cd spokennumbers $ python3 setup.py bdist_wheel $ python3 -m pip install ./dist/spokennumbers-*.whl
or from generated Debian package:
# Install build dependencies $ sudo apt install python3-all python3-setuptools dh-python $ git clone https://github.com/Penlect/spokennumbers.git $ cd spokennumbers $ make deb $ sudo apt install ./python3-spokennumbers_*.deb
NOTE: This project has a dependency to pydub which requires ffmpeg to be installed. Install ffmpeg and make sure it is available in PATH.
The changelog is maintained in the debian directory, please check there: changelog.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for spokennumbers-1.0.0-py3-none-any.whl