A plugin that embeds DockbarX into Xfce4-panel
Switch branches/tags
Clone or download
TiZ-EX1 Fix #12 by monkey-patching in a custom __setattr__ for Globals that r…
…eacts when shown_popup or gtkmenu_showing is set. The Vala socket watches a new xfconf property and calls block_autohide when the plug changes it.
Latest commit a2dcb66 Aug 16, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Add MouseNeo themes. Jun 19, 2014
src Fix #12 by monkey-patching in a custom __setattr__ for Globals that r… Aug 16, 2016
vapi Start of migration to xfconf. Sep 4, 2015
.gitignore Initial commit. May 7, 2014
AUTHORS Initial commit. May 7, 2014
COPYING Initial commit. May 7, 2014
ChangeLog Add MouseNeo themes. Jun 19, 2014
INSTALL Initial commit. May 7, 2014
README.md Update readme. Sep 6, 2015
THANKS Initial commit. May 7, 2014
waf Initial commit. May 7, 2014
wscript Version bump. Sep 6, 2015



ver. 0.5

About xfce4-dockbarx-plugin

xfce4-dockbarx-plugin is free software. Please see the file COPYING for details. For building and installation instructions please see the INSTALL file. For information on the authors of this program, see AUTHORS and THANKS.

xfce4-dockbarx-plugin is a pair of programs--a gtk socket in Vala and a gtk plug in Python--that work together to embed DockbarX into xfce4-panel. See THANKS for details on DockbarX. Because this is not a port and just grabs the pre-existing DockbarX, you immediately benefit from any updates made to DBX, and already have all the pre-existing functionality.

Using xfce4-dockbarx-plugin

Add DockbarX to the panel and it will automatically start. If you don't want to customize it, no further configuration is necessary.

If you wish to configure it, you must invoke the configuration dialog through the panel preferences window. You can then configure a distinct background for the plugin, change the maximum size, or set it to expand. The plugin will automatically detect panel orientation and will reconfigure itself on the fly.

There is only one gotcha for automatic panel blending; namely, if you use the image style, you still need to make sure the offset is properly configured if you have an image that necessitates it.

Any extras?

This plugin includes a DockbarX theme called Mouse, created by me for use with xfce4-panel (but should work fine on Gnome/Mate panels, AWN, or DockX). There are two variant versions for varying levels of x/ythickness on the panel widgets to make them match up nicely. If a theme gives different panel widgets differing x/ythickness, its author is a sick bastard.

Okay, I'm sold! Gimme the goods!

Some distros already have it packaged in some form:

  • Arch Linux / Manjaro users can install from the AUR.
  • Ubuntu users can install from the Dockbar PPA.
  • The stable source release can be found on Xfce-Look.

If you want to (or have to) install from source, you need the following dependencies:

  • Vala >= 0.12
  • GLib >= 2.10
  • GTK+2 >= 2.16
  • Xfce4-Panel >= 4.8
  • Xfconf >= 4.8
  • DockbarX >= 0.49

To configure, build, and install, run these commands:

./waf configure
./waf build
sudo ./waf install

The panel will probably not detect the plugin unless you install it in the /usr prefix, so instead do the configure step with ./waf configure --prefix=/usr If you are using a distribution that supports checkinstall, you can replace the install step with sudo ./waf checkinstall to install it in your package manager.

Awesome! Who do I need to thank for all this?

  • Aleksey Shaferov is the original Dockbar developer.
  • Matias Särs is the developer of the DockbarX fork.
  • The included Vala bindings were developed by Mike Masonnet.
  • The developers of the Vala and Python languages are to be thanked, of course.
  • The build system is waf, so all the guys working on that are to thank for keeping this out of autohell.
  • Trent McPheron is the original developer of this beautifully hacky xfce4 panel plugin that really should not work as well as it does.
  • And the github community to whom I entrust the future of this plugin.

I want to make the plugin better!

Awesome! Fork the repo and send me pull requests! I will probably merge any request I get. The future of this plugin is in your hands now. :)