Skip to content

RustyNova016/Alistral

Repository files navigation

Alistral

CI builder

A collection of CLI based tools for Listenbrainz.

Installing

Check out the guide here

Usage

The documentation book can be found here

Full markdown help can be found under docs/CommandLineHelp.md, but full --help support exists too.

Featured Tools

Here's some of what Alistral can do:

Daily

Gives a daily recap containing the latest releases, track birthdays and discovery anniversaries

Read more | Usage

Statistics

An extended statistic calculator that calculate fresh statistics in a blink of an eye! (Data fetching not counted) Supports a wider range of entities like releases, works, or even tags.

Read more | Usage

Musicbrainz Clippy

An utility to find errors, missing data, or other potential edits for musicbrainz. It crawls over all the entities and do a series of checks called "lints", checking the integrity of the data.

This is similar to the musicbrainz reports but contains other lints and utilities to quickly fix them.

⚠️ All results are suggestions. Take them with a grain of salt. If you are unsure, it's preferable to skip.

Read more | Usage

Preview of the tool

Radio

A few radio algorithms have been made to generate playlists for you

Artist Circles

Usage > Command Line documentation

This algorithm keep your playlist close to the artists you are listening to. The way it generate is as follow:

  • Get a random listen
  • Get its artist
  • Add a random recording made by this artist

There is the option to only get unlistened recordings, making an alternative to ListenBrainz's own discovery playlists.

Underrated tracks

Usage > Command Line documentation

This radio will create a playlist containing all the tracks that you listen to, but seemingly no one else does.

Listen rate

Usage > Command Line documentation

This algorithm bases itself on your listen rate of recording to get more forgotten tracks. It takes the recordings with the lowest listen rates, and put them into a playlist

Shell completions:

How to use value hints and generate shell completions.

Usage with zsh:

$ alistral --generate=zsh > /usr/local/share/zsh/site-functions/_alistral
$ compinit

fish:

$ alistral --generate=fish > alistral.fish
$ . ./alistral.fish

Other infos

This project is in beta. There's a lot of features I'd like to add, and need a lot of testing before 1.0. If you find a bug, or have a feature request, feel free to create (and spam) a new issue.

See also

About

Power tools for Listenbrainz

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •  

Languages