Metadata-Version: 2.4
Name: antarctiteex-mp3-player
Version: 0.1.2
Summary: A terminal MP3 library and player
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pygame>=2.5
Requires-Dist: pynput>=1.7
Requires-Dist: Send2Trash>=1.8
Requires-Dist: textual>=0.50
Requires-Dist: yt-dlp

# antarctiteex-mp3-player

A terminal interface for playing and organizing a folder of MP3 files.

## Install

Install the player from PyPI:

```sh
python3 -m pip install antarctiteex-mp3-player
```

Then open a music folder and launch the player:

```sh
cd /path/to/music
antarctiteex
```

You can also pass the music folder directly:

```sh
antarctiteex /path/to/music
```

The `mp3-player` command is also available as an alias.

The player stores song metadata, playlists, and analysis in a single
`.mp3cache.json` file inside the selected music folder.

`ffmpeg` and `ffprobe` must be available on `PATH` for audio conversion and
analysis features. On macOS, install them with `brew install ffmpeg`.

## Development

Run the test suite with:

```sh
python3 -m unittest test_play.py
```
