Skip to content
a qt music player in python
Python CSS Other
Branch: master
Clone or download
Latest commit 70f33e1 Apr 19, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
img Update img/main.png Apr 8, 2019
src Fix dark mode color scheme Apr 19, 2019
.gitignore Add .spec file for pyinstaller Mar 19, 2019
LICENSE Add drag and drop, find cover art in folder Mar 10, 2019 Move disable window decorations to separate module Mar 28, 2019
aidoru.spec Nice redesign Apr 8, 2019
build.bat Center window upon disabling decorations (Windows), update build.bat Mar 29, 2019 Update build.bat, Mar 19, 2019
release.txt Update release.txt Apr 8, 2019
requirements.txt Use taglib.Picture to handle image metadata Mar 20, 2019


a qt music player in python

music player in playing album mode


You must install Qt5 library, taglib headers (libtag1-dev in Ubuntu) and python3. After that, do:

pip3 install --user -r requirements.txt

You can then run directly or by invoking python3:

python3 ./

Linux users, if this line:

defaultServiceProvider::requestService(): no service found for - "org.qt-project.qt.mediaplayer"

appears upon running, then:

  1. install your distro's equivalent to libqt5multimedia5-plugins
  2. remove ~/.local/lib/python3*/dist-packages/PyQt5/Qt/plugins/mediaservice/
  3. ln -s /usr/lib/x86_64-linux-gnu/qt5/plugins/mediaservice/ ~/.local/lib/python3*/dist-packages/PyQt5/Qt/plugins/mediaservice/

Windows users, the latest release is in the Releases tab. You'll also need to install DirectShow codecs to play audio (hint: K-Lite Codec Pack)


Upon first startup, it'll find and index all audio files in your ~/Music directory (This PC > Music for you Windows users).

The player assumes you organize albums into separate folders in your music directory, it'll also automatically locate cover art in those folders.

shortcut action
ctrl+q quit
space play/pause song
F5 refresh listing
ctrl+f toggle file search bar
ctrl+shift+f switch to full mode
ctrl+m switch to mini mode
ctrl+shift+m switch to micro mode


  • Breeze/Paper icons
  • Design based on
You can’t perform that action at this time.