A class to create a taskbar/launcher progress and more, for all desktop platforms
- Show a progress in the taskbar/launcher/dock/…
- Show a badge with a number in the taskbar/launcher/dock/…
- Works on:
- Windows >= 7
- Linux (Desktops that support the
com.canonical.Unity.LauncherEntryD-Bus signal, for example Unity, KDE)
- Additional Windows Features:
- Set the badge icon background and text color
- Set the progress state (running, paused, stopped)
- Show indeterminate progress
The package is providet as qpm package,
de.skycoder42.qtaskbarcontrol. To install:
- Install qpm (See GitHub - Installing, for windows see below)
- In your projects root directory, run
qpm install de.skycoder42.qtaskbarcontrol
- Include qpm to your project by adding
Check their GitHub - Usage for App Developers to learn more about qpm.
Important for Windows users: QPM Version 0.10.0 (the one you can download on the website) is currently broken on windows! It's already fixed in master, but not released yet. Until a newer versions gets released, you can download the latest dev build from here:
For most platforms, you simply need to create an instance of the class for a window, and your good to go. For linux however, you need to do additional setup. Read Special setup for linux. The following example shows the part thats the same for all platforms:
auto widget = new QWidget(); //your window auto taskbar = new QTaskbarControl(widget); //MUST have a valid parent! // additional linux setup here taskbar->setProgress(0.42); taskbar->setProgressVisible(true); taskbar->setCounter(42); taskbar->setCounterVisible(true);
Special setup for linux
In order to work, the linux implementation needs an application with a valid desktop file in an accessible location (e.g.
~/.local/share/applications/ on KDE). You need to set that file as extra property to enable it. The following steps explain how to properly setup QTaskbarProgress with a desktop file:
- Create a
.desktopfile. For testing purpose, the following should suffice:
[Desktop Entry] Type=Application Version=1.1 Name=<MyApp> Exec=<path_to_MyApp>
- Copy that file to a location where desktop files are found by the OS (e.g.
- Register the desktop file in your application. In case the file is named
myapp.desktop, add the following code after the construction of QTaskbarControl:
And thats it. When you run the application it should work. I case it doesn't work: Try to set a different icon for the desktop file, e.g.
gtk-edit. If you see that icon in the taskbar, your application gets corretly "connected" to that desktop file.