Metadata-Version: 2.4
Name: ephemeral-mp3-player
Version: 0.1.0
Summary: A mouse-first terminal MP3 player with local listening stats.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pygame>=2.5.0
Requires-Dist: pydub>=0.25.1
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.89.1

<p align="center">
  <img width="200" src="./title.svg" alt="mp3-voting-app logo" />
</p>

---

Little NodeJS app for voting for MP3s, works on local network...

**Terminal Players**

- Classic curses player: `python play.py`
- Ephemeral mouse-first player: `python ephemeral.py`

## Ephemeral MP3 Player

Install the mouse-first player with pip:

```bash
pip install ephemeral-mp3-player
```

Then point it at any folder containing MP3 files:

```bash
ephemeral /path/to/music
```

`ephemeral --folder /path/to/music` is equivalent. The player keeps its listening
metadata and analysis cache inside that music folder. MP3 decoding and loudness
analysis require [FFmpeg](https://ffmpeg.org/) to be installed and available on
your `PATH`.

For local development, install this checkout in editable mode with
`pip install -e .`.
