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
ss1 ss2 ss3

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.0.tar.gz (33.6 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.0-py3-none-any.whl (37.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mimyo-0.4.0.tar.gz
  • Upload date:
  • Size: 33.6 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.0.tar.gz
Algorithm Hash digest
SHA256 8df9cf98a803d5fcb0ca3244aedacb51e9ef1ecc8e53c4f0428c6e63b8c23099
MD5 823850e67d32263f46e50dbc19cb276e
BLAKE2b-256 6d8bfb242c8ebdc7592008e4ba0bf8ec80a37acd008cbe84a34ea0f3fe68ee05

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mimyo-0.4.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf9088954b5a648277d0c0d1dbc3312de408054fbbd4d23e163d51371fce6cbd
MD5 662fec2f0a8ea6f7abd9de727182935f
BLAKE2b-256 65bb682e7b325f567691ef5058f8ed44f27a92b0d4d3be409619baaa66bc5ac0

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