Metadata-Version: 2.4
Name: muziqa
Version: 0.1.5
Summary: Add your description here
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib>=3.10.8
Requires-Dist: mutagen>=1.47.0
Dynamic: license-file

# muziqa

Analyze your MP3 collection and plot a chart of your most-listened-to artists.

![Top 20 Artists chart](artists.png)

## Install

```
pipx install muziqa
```

## Usage

Point it at a folder of music files (MP3, FLAC, WAV):

```
$ muziqa --folder /path/to/music
```

This reads the tags from every supported file in the folder and saves a bar chart to `artists.png` in the current directory.

### Options

| Option | Description |
|--------|-------------|
| `--folder DIR` | Directory of MP3/FLAC/WAV files (reads tags) |
| `--artists FILE` | Path to a plain-text `artists.txt` file instead |
| `--output FILE` | Output image filename (default: `artists.png`) |
| `--top N` | Number of top artists to show (default: 20) |

### Examples

```
$ muziqa --folder ~/Music
$ muziqa --folder ~/Music --top 30 --output top30.png
$ muziqa --artists artists.txt
```
