3 stable releases
| 1.0.2 | May 16, 2023 |
|---|
#2710 in Command line utilities
195KB
1.5K
SLoC
Vocal
Description
Vocal is a terminal program to play audio and to look cool while doing it.
Installation
Manual
git clone https://github.com/Jackboxx/vocal
cd vocal
make
make install
Issues
| error | fixes |
|---|---|
Package alsa was not found in pkg-config search path |
try installing the alsa-lib-devel package on Fedora or these packages alsa-base libasound2 libasound2-dev libudev-dev on Ubuntu. |
Configuration
Options
color
Description
Color of the audio graph, progress bar, text, and list items.
Default Value
color = 'blue'
Valid Values
| lower case | upper case |
|---|---|
| black | Black |
| red | Red |
| green | Green |
| yellow | Yellow |
| blue | Blue |
| magenta | Magenta |
| cyan | Cyan |
| gray | Gray |
| lightred | LightRed |
| lightgreen | LightGreen |
| lightyellow | LightYellow |
| lightblue | LightBlue |
| lightmagenta | LightMagenta |
| lightcyan | LightCyan |
| white | White |
| rainbow | Rainbow |
highlight_color
Description
Color of the selected list item.
Default Value
highlight_color = 'magenta'
Valid Values
| lower case | upper case |
|---|---|
| black | Black |
| red | Red |
| green | Green |
| yellow | Yellow |
| blue | Blue |
| magenta | Magenta |
| cyan | Cyan |
| gray | Gray |
| lightred | LightRed |
| lightgreen | LightGreen |
| lightyellow | LightYellow |
| lightblue | LightBlue |
| lightmagenta | LightMagenta |
| lightcyan | LightCyan |
| white | White |
audio_directory
Description
The directory that is loaded if no values are provided to the --load or --play flags.
All files in this directory are listed and can be selected to be played.
Default Value
audio_directory = '$HOME/vocal/audio'
log_directory
Description
The directory that logs of all events are stored. If there are 10 or more files in the log directory, files are removed until there are only 10 remaining files.
Default Value
log_directory = '$HOME/vocal/logs'
log_file_prefix
Description
The prefix of the automatically created log files.
Log files have the following naming schema: {prefix}_{date}_{time}.log}.
Default Value
log_file_prefix = 'vocal'
show_hotkeys
Description
Whether to show the hotkeys in the footer section while playing an audio track.
Default Value
show_hotkeys = true
custom_footer
Description
The text in the shown in the footer section if show_hotkeys = false.
Default Value
custom_footer = ""
starting_volume
Description
The volume level that audio will play at after the application is first started.
Default Value
starting_volume = 50
Max
starting_volume = 100
Min
starting_volume = 0
starting_speed
Description
The speed that audio will play at after the application is first started.
Default Value
starting_speed = 100
Max
starting_speed = 200
Min
starting_speed = 10
bar_width
Description
The width of the bars in the bar chart shown when playing an audio track.
Default Value
bar_width = 3
bar_gap
Description
The gap between bars in the bar chart shown when playing an audio track.
Default Value
bar_gap = 1
Dependencies
~7–42MB
~606K SLoC