Tree-based tiling layout for Awesome Window Manager.
Switch branches/tags
Nothing to show
Clone or download
RobSis Merge pull request #10 from aguslr/master
Added support for gaps between clients
Latest commit c34210c Dec 11, 2014
Failed to load latest commit information. Update Oct 19, 2014
bintree.lua qa Apr 4, 2013
init.lua Added support for useless gaps Dec 11, 2014
layout_icon.png Add new (provisory) layout icon (#5) Oct 21, 2014


Treesome is binary tree-based tiling layout for Awesome 3.4 and latter. Similarly to tmux, it can split focused window either vertically or horizontally.

The project is still in the development. Feel free to fork/contribute!


  1. Clone repository to your awesome directory

    git clone ~/.config/awesome/treesome

  2. Add this line to your rc.lua below other require calls.

    local treesome = require("treesome")

  3. And finally add the layout treesome to your layout table.

    local layouts = {
  1. Restart and you're done.

Optional steps

  1. By default, direction of split is decided based on the dimensions of focused client. If you want you to force the direction of the split, bind keys to treesome.vertical and treesome.horizontal functions. For example:
    awful.key({ modkey }, "v", treesome.vertical),
    awful.key({ modkey }, "h", treesome.horizontal)


treesome in action


GPL 2.0