Curses based lyrics display and fetcher for cmus music player with auto scroll and tag support.

• Runs as daemon and connects to cmus-remote
• Reads lyrics from tags if available
• Tries to guess song artist and title from file name and path
• Downloads lyrics from Genius (API token required)
• Downloads lyrics from azlyrics if Genius API token is not provided
• Automatically scrolls lyrics based on current position in song
• Center lines
• Split too long lines on space
• Custom color
• Limit number of lyrics lines on screen
• Supports lyrics with timestamps ([11:22.333])
• Saves lyrics, artist and title to tags (optional)
• Removes section headers from Genius lyrics (optional)
• Manual scroll deactivates auto scroll for current song
• Offline mode - forces only reading from tags

usage: cmus-auto-lyrics [-h] [-c] [-s] [-a] [-o] [-e] [-l INT] [--color INT] [--color_current INT] [-v] [token]

Curses based lyrics display and fetcher for cmus music player

arguments:
  token                 Genius API token - if not provided, will use azlyrics

options:
  -h, --help            show this help message and exit
  -c, --clear-headers   clear section headers in lyrics, applies only for genius
  -s, --save-tags       save lyrics, artist, and title tags, if lyrics tag is missing
  -a, --auto-scroll     automatically scroll lyrics based on current position in song
  -o, --offline         runs in offline mode - only reads lyrics from tags
  -e, --center          center lyrics
  -l, --limit_height INT
                        limit number of lyrics lines visivble on screen, will center lyrics vertically
  --color COLOR         8bit ANSI color code for all lyrics lines
  --color_current COLOR_CURRENT
                        8bit ANSI color code for current lyrics line (when timestamps are available)
  -v, --version         show program's version number and exit

If there are no tags, keep file names as follows:
<artist> - <title>.<extension>
<artist>-<title>.<extension>
or file name is just song title and parent directory is artist:
<artist>/<title>.<extension>

Colors are provided as integer and they are 8bit ANSI color codes. -1 is default terminal color.

• From AUR: yay -S cmus-auto-lyrics
• Build, then copy built executable to system:
  sudo cp dist/cmus-rpc-py /usr/local/sbin/

1. Clone this repository: git clone https://github.com/sparklost/cmus-auto-lyrics
2. Install pipenv
3. cd cmus-auto-lyrics
4. Install requirements: pipenv install
5. build: pipenv run python -m PyInstaller --noconfirm --onefile --windowed --clean --name "cmus-auto-lyrics" "main.py"

Example launcher for cmus with cmus-auto-lyrics in single terminal with tmux, with enabled auto-scroll.
Launching in open terminal:

bash -c "tmux new-session -s cmus -d -x '$(tput cols)' -y '$(tput lines)' $'cmus'; tmux split -h -l40 $'cmus-auto-lyrics -a'; tmux select-pane -t 0; tmux attach -t cmus"

Launching with maximized gnome terminal (can be added as launcher):

gnome-terminal --window --maximize -- /bin/sh -c "tmux new-session -s cmus -d -x '$(tput cols)' -y '$(tput lines)' $'cmus'; tmux split -h -l40 $'cmus-auto-lyrics -a'; tmux select-pane -t 0; tmux attach -t cmus"

Launching with cmus-rpc-py:

bash -c "tmux new-session -s cmus -d -x '$(tput cols)' -y '$(tput lines)' $'cmus-rpc-py -s & cmus'; tmux split -h -l40 $'cmus-auto-lyrics -a'; tmux select-pane -t 0; tmux attach -t cmus"

Note: change -l40 to number of columns that should be used by lyrics pane.