|
| 1 | +------------------------------------------------------------------------------- |
| 2 | +PyPanel v2.4 Copyright (c) 2003-2005 Jon Gelo ( [email protected]) |
| 3 | +Distributed under the GNU General Public License v2, see COPYING for details. |
| 4 | +------------------------------------------------------------------------------- |
| 5 | +PyPanel is a lightweight panel/taskbar written in Python and C for X11 window |
| 6 | +managers. It can be easily customized to match any desktop theme or taste. |
| 7 | +PyPanel works with EWMH compliant WMs. |
| 8 | + |
| 9 | +The panel displays currently running tasks/applications and can also be |
| 10 | +configured to display the current desktop name, date/time, a system tray |
| 11 | +(notification area) and application launcher. |
| 12 | + |
| 13 | +When the panel is minimized, either manually or by autohide, it can be restored |
| 14 | +by moving the mouse over the top or bottom of the screen where the panel was |
| 15 | +displayed prior to minimization. |
| 16 | + |
| 17 | +All image rendering (icons and background transparency/tinting) is handled by |
| 18 | +Imlib2. |
| 19 | + |
| 20 | +Mouse button events on panel objects are handled by the ~/.pypanelrc |
| 21 | +configuration file. The file is a python script which gets imported/executed |
| 22 | +when PyPanel is invoked. Ensure that it contains proper Python formatting and |
| 23 | +no syntax errors or the panel will not start! |
| 24 | + |
| 25 | +------------------------------------------------------------------------------- |
| 26 | + Requirements (Minimum versions) |
| 27 | +------------------------------------------------------------------------------- |
| 28 | +1. Python v2.2 http://www.python.org |
| 29 | +2. Python X Library v0.12 http://python-xlib.sourceforge.net |
| 30 | +3. Imlib2 v1.1.1 http://www.enlightenment.org/pages/imlib2.html |
| 31 | +4. libXft v1.0 (optional) http://fontconfig.org |
| 32 | + |
| 33 | +------------------------------------------------------------------------------- |
| 34 | + Installation (Upgrading) & Starting |
| 35 | +------------------------------------------------------------------------------- |
| 36 | +1. python setup.py install |
| 37 | +2. pypanel & |
| 38 | +3. If upgrading to 2.x from 1.3, you will need to replace your current |
| 39 | + ~/.pypanelrc with the new version: |
| 40 | + |
| 41 | + a. Move your current ~/.pypanelrc to a backup location or backup name |
| 42 | + b. Start PyPanel so a new ~/.pypanelrc is created |
| 43 | + c. Kill the panel process |
| 44 | + d. Merge any changes you wish to keep from your backup config to the |
| 45 | + new version |
| 46 | + |
| 47 | +------------------------------------------------------------------------------- |
| 48 | + Uninstallation |
| 49 | +------------------------------------------------------------------------------- |
| 50 | +PyPanel installs the following files - |
| 51 | + |
| 52 | +1. /usr/bin/pypanel (may be in /usr/local/bin or other depending on system) |
| 53 | +2. <path to your Python library>/site-packages/ppmodule.so (.sl) |
| 54 | +3. <path to your Python library>/site-packages/pypanel/ |
| 55 | +4. ~/.pypanelrc |
| 56 | + |
| 57 | +------------------------------------------------------------------------------- |
| 58 | + Configuration |
| 59 | +------------------------------------------------------------------------------- |
| 60 | +1. Configuration is handled via the ~/.pypanelrc python script, it's |
| 61 | + executed when PyPanel is started. |
| 62 | +2. If the level of customization from the config script isn't enough, hack |
| 63 | + the PyPanel script itself. |
| 64 | + |
| 65 | +------------------------------------------------------------------------------- |
| 66 | + Contributions & Thanks |
| 67 | +------------------------------------------------------------------------------- |
| 68 | +1. My sincerest thanks to the many PyPanel users who have shared their ideas, |
| 69 | + suggestions, comments, code snippets and overall support for this project. |
| 70 | +2. The default app icon included with this distribution is from the Amaranth |
| 71 | + icon set by Michael Doches. Available from http://www.kde-look.org |
| 72 | +3. Original shadowed text and no-task display patches were contributed by |
| 73 | + Johannes Winkelmann. |
| 74 | + |
| 75 | +------------------------------------------------------------------------------- |
| 76 | + Contact |
| 77 | +------------------------------------------------------------------------------- |
| 78 | +Jon Gelo |
| 79 | + |
| 80 | +http://pypanel.sourceforge.net |
| 81 | + |
| 82 | +------------------------------------------------------------------------------- |
| 83 | + History |
| 84 | +------------------------------------------------------------------------------- |
| 85 | +050626 New features: |
| 86 | +v2.4 Shadowed text |
| 87 | + Ability to disable the task display |
| 88 | + Bug fixes: |
| 89 | + Fix for wmhint icons with icon mask > maxint (eg AleVT) |
| 90 | + Fix when reading the class name of apps that don't set class name |
| 91 | + Race condition for destroyed task - drawing its wmhints icon |
| 92 | + New config options: |
| 93 | + SHADOWS : Enable text shadows |
| 94 | + TASK_SHADOW_COLOR : Normal task shadow color |
| 95 | + FOCUSED_SHADOW_COLOR : Focused task shadow color |
| 96 | + SHADED_SHADOW_COLOR : Shaded task shadow color |
| 97 | + MINIMIZED_SHADOW_COLOR : Minimized task shadow color |
| 98 | + DESKTOP_SHADOW_COLOR : Desktop name shadow color |
| 99 | + CLOCK_SHADOW_COLOR : Clock name shadow color |
| 100 | +050510 New features: |
| 101 | +v2.3 Improved support for Fluxbox, Blackbox, XFWM4 and Enlightenment |
| 102 | + Ability to customize individual app icons |
| 103 | + Added an Application Launcher |
| 104 | + Added a check to enforce only one running instance of the panel |
| 105 | + Option for the panel to stay above or below other apps (ABOVE) |
| 106 | + Bug fixes: |
| 107 | + Clock updates |
| 108 | + Several system tray and performance improvements |
| 109 | + New config options: |
| 110 | + ABOVE : Panel is above or below other apps |
| 111 | + APPL_I_WIDTH : Application launcher icon width |
| 112 | + APPL_I_HEIGHT : Application launcher icon height |
| 113 | + ICON_LIST : List of custom icons for specific apps |
| 114 | + LAUNCHER : To enable and position the application launcher |
| 115 | + LAUNCH_LIST : List of executables and their icons |
| 116 | + TRAY_I_WIDTH : Can now be set to 0 to allow app specific size |
| 117 | + |
| 118 | +050206 v2.2 - New features/options: |
| 119 | + Read config from /etc/pypanelrc first if it exists |
| 120 | + Option to show only minimized/iconified apps (SHOWMINIMIZED) |
| 121 | + Option to show a border around the panel (SHOWBORDER) |
| 122 | + Option to set the minimized panel size (HIDDEN_SIZE) |
| 123 | + Added panelButtonEvent() to handle button events on empty panel |
| 124 | + Bug fixes: |
| 125 | + Removed legacy WindowMaker support, it's now EWMH capable |
| 126 | + Fixed setup.py to gather correct compile/link arguments |
| 127 | + Added a workaround for failing Imlib2 image loaders |
| 128 | +040926 v2.0 - New features/options: |
| 129 | + Now using Imlib2 for all image rendering |
| 130 | + Panel background tinting using BG_COLOR |
| 131 | + Show desktop function (EWMH only) |
| 132 | + Show apps from all desktops |
| 133 | + EWMH task ordering (oldest to newest, left to right) |
| 134 | + Support for XFWM4 |
| 135 | + Autohiding (AUTOHIDE) |
| 136 | + Minimized panel now restored by moving mouse over the top or |
| 137 | + bottom of the screen where the panel was displayed |
| 138 | + Ability to define the clock update interval (CLOCK_DELAY) |
| 139 | + Ability to define each desktop's name (DESKTOP_NAMES) |
| 140 | + Ability to define a custom default app icon (ICON) |
| 141 | + Bug fixes: |
| 142 | + Clock overwriting |
| 143 | + Font/text display issues |
| 144 | + Background change garbled panel text |
| 145 | +040719 v1.3 - Added a System Tray |
| 146 | + More flexibility for the panel layout |
| 147 | + Tweaked the config |
| 148 | + Fixed a bug with font handling |
| 149 | +040328 v1.2 - Ability to change the color of focused tasks (FOCUSED_COLOR) |
| 150 | + Added taskFocus() method for button events which allows |
| 151 | + tasks which aren't focused to become focused else it toggles |
| 152 | + the tasks minimization. |
| 153 | + Decreased the amount of time between clock updates when idle. |
| 154 | + Bug fixes: |
| 155 | + Crash with certain panel size/dimension settings |
| 156 | + Unnecessary task refreshing caused flashing/blinking |
| 157 | +040218 v1.1 - Bug fixes: |
| 158 | + Broken hide list |
| 159 | + Exception during get_wm_state |
| 160 | +040131 v1.0 - Xft support |
| 161 | + Ability to minimize the panel (toggleHidden) |
| 162 | + Ability to hide certain apps (HIDE_LIST) |
| 163 | + Removed the SHOWALL option |
| 164 | + Numerous bug fixes and optimizations |
| 165 | +031109 v0.9 - Clock support |
| 166 | + Customizable button event handling |
| 167 | + Ability to place the workspace name/clock on right/left |
| 168 | + Vertical line seperators can be turned off |
| 169 | + Bug fixes: |
| 170 | + Background change or restart sometimes killed panel |
| 171 | + Sending task to another desktop didn't update correctly |
| 172 | +031012 v0.8 - Create ~/.pypanelrc if it doesn't exist |
| 173 | + Raise & focus a task via middle mouse click |
| 174 | + Workspace switching via clicks/scroll on the workspace name |
| 175 | +031009 v0.7.1 - Bug fixes: |
| 176 | + Strut and visible name hints |
| 177 | + Icons with no/invalid masks |
| 178 | + Tasks with no name |
| 179 | +031004 v0.7 - OpenBox3 support |
| 180 | + Window shading/unshading via right mouse click |
| 181 | + Config option for panel width, x position and top/bottom |
| 182 | + Config option for displaying all tasks or just minimized |
| 183 | +030927 v0.6 - Added EWMH support (Kahakai and PekWM) |
| 184 | +030921 v0.5 - Initial Beta release |
0 commit comments