1AllTray: Copyright 2004, 2005, 2006, 2007 Jochen Baier, email@jochen-baier.de
2
3  With AllTray you can dock any application with no native tray icon
4  (like Evolution, Thunderbird, Terminals) into the system tray.
5  A high-light feature is that a click on the "close" button
6  will minimize back to system tray. It works well with Gnome,
7  KDE, XFCE 4*, Fluxbox* and WindowMaker*.
8
9  *no drag 'n drop support. Enable with "-nm" option.
10
11
12**Install:
13
14  (./autogen.sh)
15  ./configure
16  make
17
18  and as root:
19
20  make install
21
22
23**Run:
24
25  just start alltray with:
26
27    alltray program_name
28
29  This will dock the program into the system tray. A single click
30  with the left mouse button on the icon will show the program.
31  A click with the right mouse button will show a popdown menu.
32
33  For the "Click-Mode" start alltray with:
34
35    alltray
36
37  and click on the target window.
38
39
40
41  A click on the "close" button ("X") in the window title will not exit the
42  application. The application will be minimized.
43
44  To quit the application use the popdown menu or the "FILE->QUIT" menu
45  from the application.
46
47  The "Undock" menu item will undock the window. Yeahh really ;)
48
49  If you use the "--borderless" option, you can move the window with
50  "Alt-left_mouse_button".
51
52
53  Note: * Under KDE the "large_icon" option has no effect.
54        * "--configure" option will only work under KDE. You need to configure
55              AllTray after each theme change.
56        * If you do not use KDE or Gnome and you want Drag n Drop: use the "--nm" option.
57        * If you do not have Gconf/Gnome installed. Use the "--disable-gconf" configure option.
58
59
60**All options:
61
62  alltray -h:
63
64  usage: alltray [options] ["] <program_name> [program parameter] ["]
65
66   where options include:
67   --help; -h:  print this message
68   --version; -v: print version
69   --debug; -d: show debug messages
70   --show; -s:  do not hide window after start
71   --icon; -i  <path to png>: use this icon
72   --large_icons; -l: allow large icons (> 24x24)
73   --sticky; -st: visible on all workspaces
74   --skip-taskbar; -stask: not visible in taskbar
75   --borderless; -x: remove border, title, frame (if not supported native)
76   --menu; -m: "menu text:command": add entry to popdown menu
77   --title; -t <sec>: show tooltip with title for <sec> seconds after song change
78   --geometry; -g [<width>x<height>][{+-}<x>{+-}<y>]: initial position (if not supported native)
79   --key; -k [Modifier:]Key: Keyboard shortcut:
80     Modifier="Shift", "Control", "Alt", "AltGr"
81     Key (Examples) = "a", "F1", "End" ...
82     or "Keycode" (Number) returned by the program "xev"
83   --notray; -nt: display no tray icon (usefull only with the "--key" option or what ever
84   --nominimize; -nm: click on window close button: do not minimize back to system tray, close
85   --configure; -conf: show KDE configuration dialog
86
87
88 usage: alltray
89
90 Click-Mode: Click on the window you would like to dock.
91 (Abort with <c>)
92
93
94**Requirements:
95
96   Compile:
97
98    - X Window stuff
99    - GTK+ >= 2.2
100    - Gconf stuff. if not disabled with "--disable-gconf"
101
102   Run:
103
104    - Gnome 2 with "Panel Notification Area" applet.
105    - KDE (>= 3.2 [3.1 ?] ) with System tray.
106    - XFCE 4.2 with System tray.
107    - Fluxbox (devel version)
108    - WindowMaker with "docker" dockapp.
109
110
111**License: GPL
112
113
114**Contact:
115
116   email@jochen-baier.de (i do not longer support alltray !!!  do not send bug reports etc)
117