Metadata-Version: 2.4
Name: mimyo
Version: 0.3.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

![PyPI](https://img.shields.io/pypi/v/mimyo)
![Python](https://img.shields.io/pypi/pyversions/mimyo)
![License](https://img.shields.io/pypi/l/mimyo)
![Downloads](https://img.shields.io/pypi/dm/mimyo)

![pygame-ce](https://img.shields.io/badge/pygame--ce-2.5.7-brightgreen)
![mutagen](https://img.shields.io/badge/mutagen-1.47.0-brightgreen)
![textual](https://img.shields.io/badge/textual-0.50.0+-brightgreen)
![yt-dlp](https://img.shields.io/badge/yt--dlp-latest-brightgreen)
![Pillow](https://img.shields.io/badge/Pillow-10.0.0+-brightgreen)

A simple vibecoded terminal music player that takes inspiration from [rmpc](https://github.com/mierak/rmpc) and runs completely standalone. Built for anyone who just wants to open their terminal, hit play, and lose themselves in their music library 

## 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).
