Skip to main content

Mad Play

Play your music from the terminal like a Divine Madman!

PyPI - Version PyPI - Python Version


Installation

pip install mad_play

Usage

For ease of use you could add an alias to your .bashrc, for example:

alias = mp="mad-play"

Remember to close and re-open your terminal or run:

source ~/.bashrc

Then open your terminal where the music is. To play a file:

mp funkytown.mp3

If you have a list of filenames in a text file, one filename per line and you have given it the .playlist extension, you can start playing it by:

mp bebop.playlist

Or just play every audio file in a folder like so:

mp mongolian/

press space to pause and resume, n for next tune, b to go back and q to quit.

Project scope

Dead simple terminal audio player that plays audio files from anywhere on your computer, with playlists edited as plain text files and the ability to play everything in a folder. The player has intuitive controls and does not require learning exotic key-bindings.

Contribute

This is a fun, simple project, but very useful all the same. It's a single python file with code that is fairly easy to catch. Mind you, it's early days and everything is very raw. The Divine Madman invites you all to tinker, suggest improvements within the scope of the project and contribute improvements if doing so tickles your fancy!

Dependencies and Acknowledgments

Mad Play depends on ffplay, which must be installed and in the path. (On Fedora 44 it is out of the box).

License

Mad Play is distributed under the terms of the MIT license.

Download files

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

Source Distribution

mad_play-0.1.1.tar.gz (2.9 kB view details)

Uploaded Source

Built Distribution

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

mad_play-0.1.1-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

Details for the file mad_play-0.1.1.tar.gz.

File metadata

  • Download URL: mad_play-0.1.1.tar.gz
  • Upload date:
  • Size: 2.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for mad_play-0.1.1.tar.gz
Algorithm Hash digest
SHA256 306822dd7de22ab420e705e2fea74a9b5299273decc1740eb874c76af54b36ea
MD5 86fd0f27163286bc0a5a2fff32fb160e
BLAKE2b-256 e7b72cfc7cbe7cfa674b8b9eabc80fcc6434309c5b74db22c49d280a79e34ca7

See more details on using hashes here.

File details

Details for the file mad_play-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: mad_play-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 4.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for mad_play-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 96c4db0cfe17eb978692bcfb8ae5320628961996580f70e96da589079eb70607
MD5 69f03d4796e8277c1acf4032b028dc7b
BLAKE2b-256 379e276b51586feb35da1fbda6f456c0c03694a899280f12f64fe41439d55440

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Supported by

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