~callum/barszcz

TUI and music player plugin for beets
Leave space for large thing indexes
Make gap between things configurable
Make information displayed configurable

refs

main
browse  log 

clone

read-only
https://git.sr.ht/~callum/barszcz
read/write
git@git.sr.ht:~callum/barszcz

You can also use your local clone with git send-email.

#barszcz

Barszcz is intended to be a TUI and music player plugin for beets. It is currently mostly non-existent, and how far I will get is uncertain.

Barszcz is a Polish beetroot soup.

#How to use it

Get the source:

git clone https://git.sr.ht/~callum/barszcz

Add it to your PYTHONPATH, for example:

export PYTHONPATH=$PWD/barszcz:$PYTHONPATH

Enable the plugin in your beets configuration by adding barszcz to the plugins option. For more information on using plugins see the beets plugins documentation.

Run barszcz with:

beet barszcz

#Configuration

Make a barszcz section in your configuration file. The available options are:

  • format_item determines what information about an item (track) should be displayed, and where. It has two options, left and right, which are both lists of strings which follow the beets path format syntax. Each list entry corresponds to a line on the screen. If a list entry is left blank, a blank line will be displayed, and if left or right is left blank, nothing will be displayed on that side.

  • format_album is as above but for albums.

  • gap is the number of blank lines between each item or album.

Default configuration:

barszcz:
	format_item:
		left:
			- $title
			- $album ($year)
			- $artist
		right:
			- $length
	format_album:
		left:
			- $album
			- $albumartist ($year)
		right:
			- $albumtotal tracks
	gap: 1