muziqa 1.0.21

App for various music-file-collection analyses (for example, chart of most popular artists in your MP3 collection)

muziqa

Analyze your music collection and generate interesting charts using command-line:

• Top artists by track count
• Tracks by decade
• Tracks by year, with a 5-year rolling average of mean tracks per artist
• Tracks by country (optional, see below)
• Tracks by genre (optional, see below)

Install

$ pipx install muziqa

Works on Linux, Mac. Probably Windows too, but I didn't test it.

Usage

No API keys, no accounts, no streaming service — just point muziqa to a folder of music files:

$ muziqa /path/to/music

Reads tags from all supported files in the folder and subfolders, and saves two charts:

• muziqa.png — top artists + tracks by decade
• muziqa_years.png — tracks by year with rolling average

Supported formats: MP3, FLAC, WAV, M4A, OGG

Country and genre charts

$ muziqa /path/to/music --country
$ muziqa /path/to/music --genre
$ muziqa /path/to/music --country --genre

Looks up each artist's country of origin and genre from MusicBrainz and saves additional charts:

• muziqa_country.png — tracks by country
• muziqa_genre.png — tracks by genre

Note: The first run with --country or --genre queries MusicBrainz for every unique artist at 1 request/second (required by their API). For a large collection this can take a bit of time. Using both flags together does not double the time — data is fetched in a single pass. Results are cached in muziqa_mb_cache.json so subsequent runs are instant.

Note on "Unknown" genre: This means MusicBrainz either didn't find the artist or has no community-submitted genre tags for them. It does not affect the rest of the chart.

All options

Option	Description
DIR	Directory of music files to analyze
--flat	Search only the given folder, not subfolders
--country	Fetch artist countries from MusicBrainz and plot by country
--genre	Fetch artist genres from MusicBrainz and plot by genre
--output FILE	Output image filename (default: muziqa.png)
--top N	Number of top entries to show (default: 20)

Examples

$ muziqa ~/Music
$ muziqa ~/Music --flat
$ muziqa ~/Music --country --genre
$ muziqa ~/Music --top 30 --output top30.png