upload

README.bunsen-wmhacks

@@ -0,0 +1,61 @@
+README imported from bunsen-wmhacks
+===================================
+
+Scripts for adding hot corners and aero style window snapping
+to Openbox.
+Based on cb-wmhacks, written for CrunchBang Linux.
+Repackaged for BunsenLabs Linux.
+Repackaged for Mabox
+
+### mb-hotcorner usage:
+This script is designed to be started automatically on login via
+Openbox's autostart file:
+
+# Start hotcorner detection:
+mb-hotcorners --daemon &
+Once started, the script will detect when the mouse cursor enters
+the corners of your screen. If the corner has an associated command,
+it will get executed.
+
+#### Command line usage:
+mb-hotcorners: usage:
+--help show this message and exit
+--kill attempt to kill any running instances
+--daemon run daemon and listen for cursor triggers
+
+#### Customising commands:
+On first use, a config file will be created
+`~/.config/mb-hotcorners/mb-hotcornersrc`. The file should be
+self-explanatory.
+
+### bl-aerosnap usage:
+This script is designed to be called via Openbox keyboard shortucts.
+Edit Openbox's rc.xml file to add new shortcuts. Example shortcuts to
+bind snapping to Super+Alt+Left/Right key combinations:
+<keybind key="W-A-Left">
+<action name="Execute">
+<command>mb-aerosnap --left</command>
+</action>
+</keybind>
+<keybind key="W-A-Right">
+<action name="Execute">
+<command>mb-aerosnap --right</command>
+</action>
+</keybind>
+
+#### Command line usage:
+mb-aerosnap: usage:
+--help show this message and exit
+--left attempt to snap active window to left of screen
+--right attempt to snap active window to right of screen
+
+### Dependencies
+* python
+* python-xlib
+* wmctrl
+* xdotool (>=2.20110530)
+On Debian systems:
+sudo apt-get update && sudo apt-get install python python-xlib wmctrl xdotool
+
+### License
+GPL3