minirok(1) a small music player written in Python


minirok [options] [file]...


Minirok is a small music player written in Python for the K Desktop Environment. To start it, select it from the applications menu, or type minirok in a terminal.

To reproduce music, first type in the combo box at the left the directory where music is located, and press enter, or select "Open directory" from the File menu. Available audio files will be shown in a tree structure. Locate the files you want to play, and use drag and drop to append them to the playlist in the right. You can also press double click in a file or a folder to append it to the existing playlist.

Both the tree view and the playlist have search line widgets above them. Typing text in them will reduce the shown items to those matching the introduced words. If you press enter after a search in the tree view completes, the visible items will be appended to the playlist. If you press enter in the playlist search line, the first visible track will be played.

You can modify the order in which the tracks are played by enqueueing them in a different order. For this, press right button click on a track, and select "Enqueue track". Or press Control + RightButtonClick on the track to enqueue.

Similarly, you can signal that playing should stop after a certain track. To do this, select "Stop playing after this track" in the contextual menu as above, or press Control + MiddleButtonClick.

If you make changes to the filesystem, you can quickly refresh the tree view by clicking on the refresh button next to the combo box with the directory name. A key can be also configurated to do this, F5 by default.


Minirok offers a DBus interface to control the player and various other bits. At the moment a single object /Player is provided, under the org.kde.minirok service. To invoke a DBus method, run from a terminal qdbus org.kde.minirok /Player methodName. dbus-send(1) should also work, but then you'll need to fully qualify the method name.

Here's a list of available methods:


See the README.Usage file for details. Note that this interface will only be available if the required dependencies are installed. See the README file a list of these.


Minirok can submit played tracks to, or any other service (such as You will just need to configure your username and password in the preferences dialog. Starting with Minirok 2.1, no external software is needed any more.


-a, --append
Try to append the files given as arguments to an existing Minirok instance first. If that fails, start a new Minirok instance as usual. (This is done via DBus, see the README file for required dependencies.)

Minirok also accepts many other options for using the Qt and KDE libraries. Run minirok --help-all for a comprehensive list.


Please report bug to the Debian Bug Tracking System. See the README.Bugs file for instructions.

A list of reported issues is kept at


Minirok is Copyright (c) 2007-2009 Adeodato Simó, and licensed under the terms of the MIT license.