TDEDocker – minimize applications to system tray
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chris 2135f14eef Translated using Weblate (German) 1 month ago
cmake @ 8668335711 Reset submodule main/applications/tdedocker/cmake to latest HEAD 1 month ago
icons cmake: Fix installation of icons 1 year ago
po Translated using Weblate (German) 1 month ago
src Add CMakeL10n rules. 1 year ago
.gitmodules Switch all submodules to https. 1 month ago
AUTHORS Initial import 6 years ago
BUGS Initial import 6 years ago
CMakeL10n.txt Add CMakeL10n rules. 1 year ago
CMakeLists.txt Avoid overriding user linker flags (LDFLAGS) for modules and shared libs 1 year ago
COPYING Initial import 6 years ago
CREDITS Initial import 6 years ago
ChangeLog Initial import 6 years ago
ConfigureChecks.cmake Use common CMake tests. 11 months ago
HACKING qt -> tqt conversion: 1 year ago
INSTALL Initial import 6 years ago
Makefile QT_NO_* -> TQT_NO_* renaming. 1 year ago
README Initial import 6 years ago
TODO Initial import 6 years ago
VERSION Initial import 6 years ago
kdocker.desktop Switch to use kiconloader instead of hard-coded path 6 years ago Initial import 6 years ago


KDocker will help you dock any application in the system tray. This means you
can dock openoffice, xmms, firefox, thunderbolt, eclipse, anything! Just point
and click. Works for both KDE and GNOME (In fact it should work for most modern
window managers that support NET WM Specification. I believe it works for XFCE,
for instance)

All you need to do is start KDocker and select an application using the mouse
and lo! the application gets docked into the system tray. The application can
also be made to dissappear from the task bar.

System Tray Support
KDocker supports the KDE System Tray Protocol and the System Tray Protocol from

Tips to use KDocker
1. On KDE, right click on K menu and use the menu editor to create a link of
KDocker and create a shortcut (Windows key + Z). You could use the kdocker.xpm
in the src folder as the icon (its an anchor).
Rationale: ^Z on the shell puts processes in the background. On the same lines,
Windows+Z will help you put windows app to the background ;) (thanks to Thomas
McGuire for this suggestion)
2. With KDocker 0.9, there is an option to dock the current active window (-f).
As soon as you press WinKey+Z, the window which has the focus will be
automatically docked. Thanks to Daniel for this neat feature request.

Session Management
IMPORTANT: Make sure KDocker is in your $PATH for Session Management to work. I
created a link in /usr/bin to point to kdocker. KDocker will automatically dock
all the programs that you had docked in your previous session when you log on
the next time (provided they were all docked when you logged out).

When using KDocker in startup scripts, be sure to supply the "-d" switch.
This will disable session management for that kdocker instance. This will
prevent kdocker from docking that application twice (during startup and session
restoration). For the same reason, make sure you use the "-d" switch, when you
undock an application that is in a startup script and then dock it again.

Few programs do not support session management. For example, thunderbird may not
launch itself automatically after you logout and logon. For such applications
use the "-l" switch (also accessible through the menu as "Launch on startup").
KDocker will launch thunderbird on session restoration.

Note that, if you have 4 applications docked using KDocker and you use
Ctrl+Alt+Backspace to logout, nothing will be restored when log back in. (The
shortcut kills the X server and the session is not saved). Hence, it is a good
idea to put the applications that you intend to dock in your starup folder and
use the "-d" switch.

Its a bit confusing, but I cannot find any easy way to satisfy all
combinations. They say you design for the common case, but for KDocker I do not
know (yet) which will be the common case. I fancy launching stuff from console
but I am not so sure about the rest.

QTrayLabel is meant to be a reusable class which will help you dock any window.
Have a look.

If you see the following,
"Sorry, your locale is not supported. If you are interested in providing
translations for your locale, contact"
it means either
a) KDocker could not find the translation files
b) Translation files for your locale dont exist

For a), KDocker looks for the translation files in the following paths,
- install.path/i18n
- app.path/i18n
- curdir/i18n

For b), use linguist to create the translations and provide them to me. Its
really easy. Follow following steps,
1. edit Look for TRANSLATIONS. Add your locale in the end. Say,
2. from the kdocker source base, execute "lupdate"
3. "cd i18n". you should see kdocker_zz.ts.
4. provide the translations - "linguist kdocker_zz.ts"
5. from the kdocker source base, execute "lrelease"
6. thats it! Now test it. Make sure $LANG=zz (or appropriate). Run kdocker and
make sure all your translations are out there.
7. Ship the .ts file to (I can generate the .qm file from
the .ts file)

Reporting Bugs
Bugs and wishes to gramakri at uiuc dot edu. Follow the guidelines below , if
possible and send it to me at gramakri at uiuc dot edu.

* Add the following line in (in fact just uncomment it)
* Now do a "make clean" and "then make".
* Launch KDocker. Recreate the problem.
- Right Click on the tray icon.
- Choose "About KDocker"
- You should see a button called "Show Trace". Please note that this button
will appear only when compiled with tracing
- Try debugging yourself or send it to me
- If you send SIGUSR1 to the KDocker process, it will dump all the trace to

Send me a postcard!
If you love KDocker and would like to thank me, send me a postcard or some
stamps to

Girish Ramakrishnan
G7, Block No.12, R.K.Apartments,
Hoysala Nagar,
Karnataka, India

http::// for updates