=========== DESCRIPTION =========== This is a branch of DockBar (a task bar with grouping and group manipulation). Dockbar is made by Aleksey Shaferov. DockbarX branch is developed by Matias Särs. Both the default theme "DBX" and "Sunny Colors" as well as the DockbarX icon is made by BigRZA. "Gaia" is made by Izobalax. Dockbar and DockbarX are licensed under GPL3. ======= INSTALL ======= 1. Install zeitgeist, python-wnck, python-gnomeapplet, python-keybinder and python-numpy (DockbarX might be able to run without python-numpy, but it shouldn't hurt to install it). $ sudo apt-get install python-gnomeapplet python-wnck python-keybinder python-numpy zeitgeist 2. Download and extract dockbarx. Change directory to where you extracted dockbarx and run the setup.py install $ sudo ./setup.py install 3. Add DockBarX applet to panel (kill gnome-panel first if necessary) DockManager helpers - To use DockManager helpers, you need to install dockmanager and dockmanager-daemon (available from dockbar ppa and awn-testing ppa) as well as libdesktop-agnostic-cfg-gconf and libdesktop-agnostic-vfs-gio (these two might not need to be installed separately on distributions that aren't Debian based). Then you need to activate DockManager and the helpers you like to use from DockbarX prefeference. NOTE! To use previews you need to activate KDE Compability in compiz settings manager and under KDE Compability check "Support Plasma Thumbnails". (Alternatively you can use kwin as window manager instead of compiz. That will give you previews for minimized windows as well.) You can also run dockbarx in window (meant for debugging purposes, mostly): $dockbarx_factory run-in-window === AWN === To install dockbarx as an AWN 0.4 applet, you should first do an normal install and then copy the content of the AWN folder to ~/.config/awn/applets. Preference dialog: AWN gives you no handle so you can't access preference dialog by right clicking and choosing preference. You can access dockbarx preference window from your gnome menu (Accessories->Dockbarx Preference). If you like you can also pin it to dockbarx. ===== USAGE ===== The default actions are listed here. There are more actions in dockbarx. You can assign them to different buttons via preference dialog. DEFAULT GROUP BUTTON ACTIONS: left click: - activate / minimize / unminimize group (launch application if no window is open) shift + left click: - launch application middle double click: - close group of windows right click: - open 'menu' scroll up/down: - Select next/previous window of the group DEFAULT WINDOW ITEM ACTIONS: left click: - activate / minimize / unminimize middle click: - close window right click: - minimize and lock WORKSPACE/VIEWPORT BEHAVIOR OPTIONS: You can change how DockbarX reacts when you select a group (left click on the group icon if the default is used) from preference window. Ignore: Acts as if windows on other workspaces and viewport doesn't exist. Switch: Behaves as ignore if there are windows belonging to the group on the current workspace/viewport. If there are no windows belonging to the group on the current workspace/viewport it switches to the workspace/viewport with most windows that belong to the group. This is the default behavior. Move: Moves windows from other workspaces/viewports to current workspace/viewport. This is the behavior vanilla Dockbar uses. If you select a window in the window list you will always switch to the workspace/viewport of the window. This is not configurable (vanilla Dockbar behaves the same way). === FAQ === Q: Why do you want to make Linux into a Microsoft Windows 7 clone? A: I don't. The goal of DockbarX isn't to be a clone of the Windows 7 task bar. Windows 7 task bar has a good principle, though. When it comes to your most used programs it's more productive to do all window handling - launching, selecting, closing, etc. from the same few pixels. If I need a Firefox window I move my mouse cursor to the same spot on the screen regardless of which Firefox window I want and or if I even have opened a Firefox window yet. This behavior is good and it would be stupid not to implement it just because "Windows had it first". Don't reduce your productivity out of stubbornness. When it comes to looks it's up to you to choose a theme that looks like windows 7 or a theme that doesn't look that way. Here are some historical references about docks: http://en.wikipedia.org/wiki/Dock_(computing) http://en.wikipedia.org/wiki/Icon_bar And another interesting link that has had quite a bit of infuence on my work with DockbarX: http://arstechnica.com/software/news/2009/01/dock-and-windows-7-taskbar.ars Q: I want a button for every window instead of all windows of the same application grouped together under one button. When will DockbarX support that? A: Never. That would demand quite a bit of restructuring of the code and I believe it's less productive to keep the windows ungrouped. You are welcome to change the code yourself if you don't like my decision, or try the applet Talika it might suit your needs better than DockbarX does. Q: I added a new launcher for program X but when I click on the launcher a new groupbutton is made for the window instead of using the groupbutton of the launcher. What went wrong? A: Dockbarx connects group buttons and windows by using the resource class name of the application. When a launcher is added dockbarx tries to guess the resource class name of that launcher. This works in most cases but not always. Apparently it didn't work for your program X. To fix this, right click on the launcher for program X and choose "Edit Resource name" and enter the correct resource name. If the program is already running you should be able to find it's resource class name in the drop-down list. Q: There is no menu option to pin program X, but there is one for program Y and Z. Why? A: Dockbarx wasn't able to identify program X correctly then. You can "pin" the program by dragging it's icon from the gnome menu instead. Oh, and you will probably have to enter the resource name manually as well (see previous question). Q: How do I get to preference dialog? A: Right click the handle (the dots or lines to the left of dockbarx) to get a menu where you can choose the preference option. Sometimes though, you have to double right click the handle to get the menu. Don't ask me why - just do it. You can also find the preference dialog from gnome menu (in Accessories). Q: None of DockbarX's compiz stuff like "compiz scale" work. Why? A: Make sure you enable the GLib extension in Compiz settings manager and that the compiz plugin dockbarx uses is activated as well. (eg. for group button action "compiz scale" to work you need the scale plugin activated) Q: Opacify doen't work? A: A common misunderstanding is that opacify should have something to do with transparency of dockbarx itself, it doesn't. Opacify is a way to find localize a window with dockbar. When opacify is on and you roll over a name in the window list with the mouse, all other windows will become transparent so that you easy can spot the window. Q: How do I install a theme? A: If you find a theme on the web that you like, copy the file (should be SOMETHING.tar.gz) to ~/.dockbarx/themes or /usr/share/dockbarx/themes. You change themes in the appearance tab of preference dialog. You might need to press the reload button before your newly installed theme shows up. Q: How can I make an theme of my own? A: Read Theming HOWTO. If you need help ask me (Matias Särs alias M7S) on gnome-look or at launchpad. I'm happy to help theme developers as much as I can. AWN Q: When I use dockbarx in AWN, IntelliHide and Window Dodge behaviors doesn't work. Why? Can I do anything about it? A: For IntelliHide and Window Dodge to work, AWN Taskmanager applet has to be activated. So to get back IntelliHide or Window Dodge, simply add Taskmanager to your applet list again. If you think using Taskmanager and DockbarX at the same time looks a bit weird, you can go to the Task Manager tab of AWN preference and check the option "Display launchers only" and then remove all the launchers in the list. That will give you a completely invisible Taskmanager that will make sure IntelliHide and Window Dodge works as they should.