Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

Tree [37e987] master 1.1.11 /
History



File Date Author Commit
hicolor 2011-12-28 ShadowKyogre ShadowKyogre [072470] Tweaked makefile and added an icon for the editor
new-editor 2014-11-22 ShadowKyogre ShadowKyogre [37e987] Drag and drop of multiple *.desktop files is no...
.gitignore 2014-09-18 ShadowKyogre ShadowKyogre [5038bb] Don't include vim swap files or compiled python...
CHANGELOG 2014-09-21 ShadowKyogre ShadowKyogre [2cc991] Update the changelog
Compiz-Boxmenu-Editor.desktop 2014-11-20 ShadowKyogre ShadowKyogre [cee09c] Add *.desktop file for the editor
Makefile 2014-09-21 ShadowKyogre ShadowKyogre [bd36b4] Fix makefile filling in LOOK_HERE for the pytho...
README 2012-06-16 ShadowKyogre ShadowKyogre [843b37] Initial GTK3 + Python3 port
TODO 2011-12-28 ShadowKyogre ShadowKyogre [072470] Tweaked makefile and added an icon for the editor
autoconfig-compiz.py 2014-09-21 ShadowKyogre ShadowKyogre [bd36b4] Fix makefile filling in LOOK_HERE for the pytho...
cbmenu.xcf 2011-12-28 ShadowKyogre ShadowKyogre [072470] Tweaked makefile and added an icon for the editor
compiz-boxmenu-editor.in 2013-01-06 ShadowKyogre ShadowKyogre [70696a] Allow setting which python interpreter to use f...
deskmenu-common.h 2010-11-30 shadowkyogre shadowkyogre [9c67ee] update to match paths
deskmenu-documentlist-client.c 2010-12-06 shadowkyogre shadowkyogre [5b9f38] docs, vp, and windowlist can be called on own
deskmenu-dplist-client.c 2014-02-28 ShadowKyogre ShadowKyogre [95c8de] New Desktops menu list. It should be mentioned ...
deskmenu-menu.c 2014-02-28 ShadowKyogre ShadowKyogre [95c8de] New Desktops menu list. It should be mentioned ...
deskmenu-menu.h 2014-02-28 ShadowKyogre ShadowKyogre [95c8de] New Desktops menu list. It should be mentioned ...
deskmenu-service.xml 2014-02-28 ShadowKyogre ShadowKyogre [95c8de] New Desktops menu list. It should be mentioned ...
deskmenu-utils.c 2010-12-19 shadowkyogre shadowkyogre [54057e] replace %20 with a space
deskmenu-utils.h 2010-12-19 shadowkyogre shadowkyogre [54057e] replace %20 with a space
deskmenu-vplist-client.c 2010-12-10 shadowkyogre shadowkyogre [f719fb] commit proper fix for vplist editor & client bugs
deskmenu-windowlist-client.c 2010-12-14 shadowkyogre shadowkyogre [470c48] this viewport and minimized only windowlist opts
deskmenu-wnck.c 2014-07-05 ShadowKyogre ShadowKyogre [c59e88] Only free the viewport names obtained IF we're ...
deskmenu-wnck.h 2014-02-28 ShadowKyogre ShadowKyogre [95c8de] New Desktops menu list. It should be mentioned ...
deskmenu.c 2010-12-18 shadowkyogre shadowkyogre [54790c] manual reset item if error, env is the cwd
menu.xml 2010-11-27 shadowkyogre shadowkyogre [134118] first push
org.compiz_fusion.boxmenu.service 2010-11-30 shadowkyogre shadowkyogre [9c67ee] update to match paths
precache.ini 2012-02-07 ShadowKyogre ShadowKyogre [cb8535] Bump version, prevent loading a non-existent me...

Read Me

                            Compiz Boxmenu

=== Requirements ===

 * A recent version of GLib 2.x and GTK+ 2.x
 * libwnck (2.20 is probably best, but not strictly required)
 * dbus (you must have a running session bus) and dbus-glib (for dbus version)

It does not strictly require compiz (but it does need a recent version of the
vpswitch plugin for 'Initiate on Desktop' to work)

=== Install ===

 $ make
 $ sudo make install

Prefix support is currently broken, so it only works correctly if you install
to /usr (will be fixed when it gets a proper buildsystem or perhaps sooner)

=== Usage ===

For the lazy, you can run the provided "autoconfig-compiz.py" script (as your
user, *not* as root!), but here's what it sets:
 + General Options > Commands > Commands > Command line 0 to "compiz-boxmenu"
 + General Options > Commands > Key bindings > Run command 0 to "<Control>space"
 + Viewport Switcher > Desktop-based Viewport Switching > Plugin for initiate
   action to "core"
 + Viewport Switcher > Desktop-based Viewport Switching > Action name for
   initiate to "run_command0_key"

=== Menu Format ===

The default menu lives at /etc/xdg/compiz/boxmenu/menu.xml. You can override
that menu by copying it to ~/.config/compiz/boxmenu/menu.xml (it's XDG
basedir-compliant, so if you're setting those variables, adjust accordingly)

Menus: <menu title="Title"> Menus can contain <item> and more <menu> tags (so
  they're infinitely nestable!). The title attribute is optional and is ignored
  for the toplevel menu

Items: <item type="Type"> There are a few supported item types:
 * launcher: supports the following child elements:
    - <name>: the label to show in the menu
    - <icon>: the icon name to use in the menu.
      This name is looked up by gtk+, so you can toss custom icons in 
      ~/.icons/$YOUR_THEME/$ICON_SIZE/apps/
    - <command>: the launcher command line, now can be used as 
		a pipemenu by setting the mode2="pipe" attribute (this was done
		to make up for the removal of pipeitems)
 * separator: a simple GtkSeparatorMenuItem
 * windowlist: libwnck-based window list menu.
 * viewportlist: libwnck-based viewport list menu.
 * reload: reload button (it actually quits the daemon)
 * documents: access to recent documents list

=== Implementation ===

It compiles into two binaries, compiz-boxmenu and compiz-boxmenu-daemon.
compiz-boxmenu is a simple dbus client that connects
to org.compiz_fusion.boxmenu and calls the show method. The actual menu is
compiz-boxmenu-daemon, but you shouldn't ever need to manually launch it; the
dbus service file will cause it to be automatically spawned when the name is
requested.

There are also three other binaries that allow you to call up the viewport list,
windowlist, and documents list on their own. These are compiz-boxmenu-wlist, compiz-boxmenu-vplist,
and compiz-boxmenu-dlist.

== Credits ==
crdlb for the original
Openbox developers for the pipeitem -> pipemenu idea
Windowmaker developers for the filebrowser idea