Metadata-Version: 2.4
Name: mimyo
Version: 0.4.1
Summary: A terminal-based music player
Author: Isht4ros
License: MIT
Project-URL: Homepage, https://github.com/Isht4ros/mimyo
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://static.pepy.tech/badge/mimyo)](https://pepy.tech/project/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
- Play audio from YouTube URL
- Hooks into Discord rich presence if you want it to

![screenshot 1](https://github.com/user-attachments/assets/a8b7894f-4547-4177-b46d-3f4dda3bd673)
![screenshot 2](https://github.com/user-attachments/assets/7e78e902-6c45-4f83-85a3-17f851c5b495)
![screenshot 3](https://github.com/user-attachments/assets/12b7eaaf-65e3-4cb7-827d-dc83b8af5fe1)

## 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]"
```
### Installing from source

```bash
git clone https://github.com/Isht4ros/mimyo.git
cd mimyo
pip install .
```

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