A configurable and keyboard-centric music player
Project description
Maestro
A keyboard-centric configurable music player
Design principles
-
focus on user interaction:
maestro is a only a front-end application, playing the actual audio is delegated to well-know applications like mpv or vlc -
keyboard driven:
all interaction with maestro is done through keyboard shortcuts and command lines, which allows for a clean and minimalist interface -
configurable:
the modular command system and the various configuration options allows you to adapt maestro to your workflow (and not the opposite)
Requirements
Maestro is made with python. You need python>=3.10
to run maestro.
You also need one of the supported audio backend to play the music. Currently supported backends are mpv and vlc. Install whichever you like or whichever works best for you.
As an optional dependency, you may install xdotool
, which is used to properly set the WM_CLASS
attribute of the window. This will help you if you want to add specific rules for maestro in your window manager.
Installation
Clone the repository and run the install
script.
git clone https://framagit.org/Blaireau/maestro.git
cd maestro
./install
This will install maestro on your system (setup desktop file and icons and put maestro on your path).
After installation, you will need to setup a few things before you can use maestro.
See maestro help setup
.
Documentation
All the documentation is included with the application.
Simply type maestro help
to get started.
Support: getting help or reporting bugs
Please use the issue tracker or contact rabbitstemplate@disroot.org.
Reinstalling, uninstalling
In case you don’t want to use maestro anymore, or want to uninstall it before reinstalling it, you can run the following commands.
cd maestro
./uninstall
This will remove maestro and all it’s associated files from your system, except for configuration files and the cloned repository, you will have to remove those manually.
Contributing
You are welcome to contribute to the project ! You can report bugs, improve the documentation, suggest new features… For that, use the issue tracker or send an email to rabbitstemplate@disroot.org.
License
Maestro is free software, released under GPLv3 with the exception of a few assets which are under their respective license.
Credits
A huge thanks to all the tools this project relies on:
- the programming language python
- the graphical interface library kivy
- mpv and vlc for the audio backend
And on specific points:
For how to handle the recycle view:
For the monospaced font:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for maestro-music-player-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35ee8b8ed293c7583c9efddd34d3bff64505670a5b2208345804a290f030a8f5 |
|
MD5 | a34bf37dd803b20ef0ed7bf116323c86 |
|
BLAKE2b-256 | 354fab4906e7c56180e66d32c21e605e7a45deb46925aa76d2b4720a14b467a3 |
Hashes for maestro_music_player-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c77e9a0f161fedf63d031c71a7d7163dd9974c15984d8b007309c6a1e0c0df6 |
|
MD5 | b0cc2972a050c88f28da851ae0a9de9e |
|
BLAKE2b-256 | c490cd782342becd53b8474f1072a6660c5cc0a07db3b8fce2dc66d3702cac28 |