Skip to content

Commit

Permalink
Added sample xbindkeysrc and updated documentation
Browse files Browse the repository at this point in the history
- added sample xbindkeysrc
- updated documentation to describe grid options
- fixed the smallest GridWidth which _must_ be 1/3
  • Loading branch information
soulfx authored and TheWanderer committed Mar 31, 2009
1 parent 2b4853e commit abb062c
Show file tree
Hide file tree
Showing 3 changed files with 81 additions and 5 deletions.
24 changes: 20 additions & 4 deletions README
Original file line number Original file line Diff line number Diff line change
@@ -1,16 +1,32 @@
Basically a simple python script which does tiling on any windowmanager (Perfectly on pekwm and openbox. Partly on compiz due to the fact that compiz says it has a single desktop even if there are 4 virtual desktops, which means all the windows you have will be tiled). Basically a simple python script which does tiling on any windowmanager (Perfectly on pekwm and openbox. Partly on compiz due to the fact that compiz says it has a single desktop even if there are 4 virtual desktops, which means all the windows you have will be tiled).
It uses wmctrl to get the info and manage the windows. Bind it to a key or to autowhatever-on-window-creation-hook. It uses wmctrl to get the info and manage the windows. Bind options to keys or to autowhatever-on-window-creation-hook. A sample xbindkeysrc file is included.


Currently options are Usage: OPTION

Standard options:
simple - The basic tiling layout . 1 Main + all other at the side. simple - The basic tiling layout . 1 Main + all other at the side.
left,right - Does the new windows7 ish style of sticking to the sides.
swap - Will swap the active window to master column swap - Will swap the active window to master column
cycle - Cycle all the windows in the master pane cycle - Cycle all the windows in the master pane
vertical - Simple vertical tiling vertical - Simple vertical tiling
horizontal - Simple horizontal tiling horizontal - Simple horizontal tiling
maximize - Maximize the active window/ for openbox which doesn't permit resizing of max windows maximize - Maximize the active window/ for openbox which doesn't permit resizing of max windows
max_all - Maximize all windows max_all - Maximize all windows


On first run it will create a config file ~/.stilerrc. Modify the values to suit your window decorations/Desktop padding. Grid options:

The following grid options mimic the functionality of compiz's grid plugin which in turn mimics the functionality of winsplit revolution.

top_left - Place the active window in the top left corner of the screen
top - Place the active window along the top of the screen
top_right - Place the active window in the top right corner of the screen
left,right - Does the new windows7 ish style of sticking to the sides.
middle - Place the active window in the middle of the screen
bottom_left - Place the active window in the bottom left corner of the screen
bottom - Place the active window along the bottom of the screen
bottom_right - Place the active window in the bottom right corner of the screen

Multiple calls to any of the grid options on the same active window will select different widths. Grid widths can be changed in the ~/.stilerrc file.

On first run stiler will create a config file ~/.stilerrc. Modify the values to suit your window decorations/Desktop padding. Change the GridWidths list to define different widths for the grid options.


If you need other layouts modify get_simple_tile If you need other layouts modify get_simple_tile
2 changes: 1 addition & 1 deletion stiler.py
Original file line number Original file line Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ def initconfig():
WinTitle = 21 WinTitle = 21
WinBorder = 1 WinBorder = 1
MwFactor = 0.65 MwFactor = 0.65
GridWidths = 0.50,0.65,0.35 GridWidths = 0.50,0.67,0.33
TempFile = /tmp/tile_winlist TempFile = /tmp/tile_winlist
""") """)
cfg.close() cfg.close()
Expand Down
60 changes: 60 additions & 0 deletions xbindkeysrc
Original file line number Original file line Diff line number Diff line change
@@ -0,0 +1,60 @@
###########################
# xbindkeys configuration #
###########################

# copy the following key bindings into ~/.xbindkeysrc

# stiler key bindings #

#Tile Left
"stiler.py left"
m:0x1c + c:83
Control+Alt+Mod2 + KP_Left

#Tile Right
"stiler.py right"
m:0x1c + c:85
Control+Alt+Mod2 + KP_Right

#Tile Swap
"stiler.py swap"
m:0x1c + c:91
Control+Alt+Mod2 + KP_Delete

#Tile Top
"stiler.py top"
m:0x1c + c:80
Control+Alt+Mod2 + KP_Up

#Tile Top_Left
"stiler.py top_left"
m:0x1c + c:79
Control+Alt+Mod2 + KP_Home

#Tile Top_Right
"stiler.py top_right"
m:0x1c + c:81
Control+Alt+Mod2 + KP_Prior

#Tile Middle
"stiler.py middle"
m:0x1c + c:84
Control+Alt+Mod2 + KP_Begin

#Tile Bottom_Left
"stiler.py bottom_left"
m:0x1c + c:87
Control+Alt+Mod2 + KP_End

#Tile Bottom
"stiler.py bottom"
m:0x1c + c:88
Control+Alt+Mod2 + KP_Down

#Tile Bottom_Right
"stiler.py bottom_right"
m:0x1c + c:89
Control+Alt+Mod2 + KP_Next

#
# End of xbindkeys configuration

0 comments on commit abb062c

Please sign in to comment.