Create an audio program from a text file containing English sentences
Project description
apg (audio_program_generator)
Generates an audio program from a text file containing English sentences
Prerequisites
- Some relatively recent version of Python (3.7+)
- FFMPEG with at least the ability to read mp3s and wavs, and write mp3s
Installation & Basic Use:
Using pip:
$ pip install audio-program-generator
$ python
>>> from audio_program_generator import apg
>>> apg.main()
From source:
$ git clone https://github.com/jeffwright13/audio_program_generator.git
$ cd audio_program_generator
$ poetry build
$ poetry shell
$ apg --help
Description:
Generate audio program of spoken phrases, with optional background sound file mixed in.
User populates a semicolon-separated text file with plain-text phrases, each followed by an inter-phrase duration. Each line of the file is comprised of:
- one phrase to be spoken
- a semicolon
- a silence duration (specified in seconds)
The script generates and saves a single MP3 file. The base name of the MP3 file is the same as the specified input file. So, for example, if the script is given input file "phrases.txt", the output file will be "phrases.mp3".
The "mix" command is used to mix in background sounds. This command takes an extra parameter, the path/filename of a sound file to be mixed in with the speech file generated from the phrase file. If the sound file is shorter in duration than the generated speech file, it will be looped. If it is longer, it will be truncated. The resulting background sound (looped or not) will be faded in and out to ensure a smooth transition. Currently, only .wav files are supported as inputs.
The CLI prints out a progress bar as the phrase file is converted into gTTS speech snippets. However, no progress bar is shown for the secondary mix step (when the mix option is chosen). There can be a significant delay in going from the end of the first stage (snippet generation) to the end of the second stage (mixing), primarily because of reading in the .wav file. For this reason, you may want to select a sound file for mixing that is small (suggested <20MB). Otherwise, be prepared to wait.
Usage:
apg [options] <phrase_file>
apg [options] mix <phrase_file> <sound_file>
apg -V --version
apg -h --help
Options:
-a --attenuation LEVEL Set attenuation level of background file (non-
negative number, indicating dB attenuation).
-d --debug Print debug statements to console.
-V --version Show version.
-h --help Show this screen.
Commands:
mix Mix files
Arguments:
phrase_file Name of semicolon-separated text file containing
phrases and silence durations. Do not include
commas in this file.
sound_file A file to be mixed into the generated program
file. Useful for background music/sounds. Must
be in .wav format.
Example <phrase_file> format:
Phrase One;2
Phrase Two;5
Phrase Three;0
Author:
Jeff Wright jeff.washcloth@gmail.com
Project details
Release history Release notifications | RSS feed
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 audio_program_generator-1.6.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56116b1e41c26d20fbf83082ae03a07134963a37add04f07b5d5cade78fde095 |
|
MD5 | c6b00bcf268b82866fde05531978dade |
|
BLAKE2b-256 | b1bad0c4e9bb83e04304c990f6ce5e0c8d1a9ea7dca2462608ac175dacd0db58 |
Hashes for audio_program_generator-1.6.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7a129e9dc60272f5be43b6ca25c34ccc8ac0e4b3ba62a7bc370d65ceb4ac0075 |
|
MD5 | 0fa07ab2f2efcaf6dd1fe0a6e6000e0d |
|
BLAKE2b-256 | e64c7f221d9cc37944efcf36aaa9f02ed273e013bc85f572a3bf5009a7351337 |