#audio #tui #terminal #music #cli #progress-bar

app vocal

A configurable TUI program that plays audio and looks cool while doing it

3 stable releases

1.0.2 May 16, 2023

#2869 in Command line utilities

34 downloads per month

MIT license

195KB
1.5K SLoC

Vocal

preview image

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
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–37MB
~568K SLoC