Skip to main content

A terminal-based music player

Project description

mimyo

PyPI Python License Downloads

pygame-ce mutagen textual yt-dlp Pillow

A simple vibecoded terminal music player that takes inspiration from 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 screenshot 2 screenshot 3

Installation

pip install mimyo

For album art rendering, install 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?

pip install "mimyo[discord]"

Installing from source

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

Usage

mimyo

Or run it without installing:

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:

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

License

MIT — see LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mimyo-0.4.1.tar.gz (33.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mimyo-0.4.1-py3-none-any.whl (37.2 kB view details)

Uploaded Python 3

File details

Details for the file mimyo-0.4.1.tar.gz.

File metadata

  • Download URL: mimyo-0.4.1.tar.gz
  • Upload date:
  • Size: 33.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for mimyo-0.4.1.tar.gz
Algorithm Hash digest
SHA256 d087cfd0a620b95d01c1a48be82f803843114ec10f7369de10bcdb52c4dcd28a
MD5 e05985e0b0c5a3aed527feccfffb374a
BLAKE2b-256 d63e53eae36c8489624dae289890d914ba04ae2fbec7f47b0017b17b8286ae26

See more details on using hashes here.

File details

Details for the file mimyo-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: mimyo-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 37.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for mimyo-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b532fd5fe0f0b4c6ed0a774f6468ddf24596232b5f553688660ae3855f9ae978
MD5 2e9bc505e501c693654d5ebf6413ef93
BLAKE2b-256 f5e9d150e7074e5a3f559fcdbda3d764d9d4853a82ebcf9458a529d9eba66018

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page