Metadata-Version: 2.4
Name: mimyo
Version: 0.1.2
Summary: A terminal-based music player
Author: Isht4ros
License: MIT
Project-URL: Homepage, https://github.com/Isht4ros
Keywords: music,player,terminal,tui,textual
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.50.0
Requires-Dist: pygame-ce>=2.4.0
Requires-Dist: mutagen>=1.47.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: yt-dlp>=2024.1.0
Requires-Dist: sixel>=0.2.0
Provides-Extra: discord
Requires-Dist: pypresence; extra == "discord"
Dynamic: license-file

# mimyo

A simple terminal music player that drew inspiration from [rmpc](https://github.com/mierak/rmpc). Fully vibecoded, easy to get running, nothing to figure out.

## What it does

- Plays music straight from your terminal
- Renders album art (sixel support included for compatible terminals)
- Manages playlists and queues
- Streams audio from YouTube
- Hooks into Discord rich presence if you want it to

## Installation

```bash
pip install mimyo
```

For album art rendering, install [chafa](https://hpjansson.org/chafa/):
- **Windows:** `winget install -e --id hpjansson.Chafa`
- **macOS:** `brew install chafa`
- **Linux:** `sudo apt install chafa` or your distro's equivalent

Want Discord rich presence too?

```bash
pip install "mimyo[discord]"
```

## Usage

```bash
mimyo
```

Or run it without installing:

```bash
python -m mimyo
```

By default, mimyo looks for a `Music` folder in your home directory. You can point it somewhere else and it'll remember for next time:

```bash
mimyo --path "D:\Music"
# or
mimyo -p "D:\Music"
```

## License

MIT — see [LICENSE](LICENSE).
