Notion is a tiling, tabbed window manager for the X window system:

  • Tiling: you divide the screen into non-overlapping ‘tiles’. Every window occupies one tile, and is maximized to it
  • Tabbing: a tile may contain multiple windows - they will be ‘tabbed’
  • Static: most tiled window managers are ‘dynamic’, meaning they automatically resize and move around tiles as windows appear and disappear. Notion, by contrast, does not automatically change the tiling. You’re in control.

Features include:

  • Workspaces: each workspace has its own tiling
  • Multihead: the mod_xinerama plugin provides very nice dual-monitor support
  • RandR: mod_xrandr picks up changes in the multihead configuration, without the need for restarting Notion.
  • Extensibility: Notion can be extended with lua scripts. Browse through the scripts collection.

Supported platforms:

Other than the above-linked packages, the Notion project does not publish binary releases. You can download a convienent source package from github releases or clone our git repo.


Check out this quick reference to the keyboard commands

The manual page is a good reference. For an introduction, you may follow the tour

For advanced configuration documentation, see Configuring and extending Notion with Lua

For writing patches and modules, see Notes for the module and patch writer

Support, bugs and feature requests

Find us on IRC, in #notion on freenode.

Report your bugs and feature requests in the GitHub trackers.


If you’d like to support Notion, you can donate. I will not spend the donations on myself, as I wouldn’t find that fair to all the other contributors. Rather I’ll use the funds to cover any costs for Notion or other community projects, or pass on the donations to other organizations doing important work in the open source world.

If you’d like to associate your donation with a particular support/documentation request, bug or other goal, you can make a note of that.


Notion 4

The current major version of Notion is Notion 3. The next upcoming version of Notion will be Notion 4.

If you want to try this out, you are welcome to take ‘master’ for a spin! Be sure to report any problems you might have to the issue tracker.

This release will include a number of changes that are either not backwards compatible, or change the (default) behavior. Those are described in more detail in the migration notes.


Notion was originally a fork of Ion, which has been abandoned by its original author, Tuomo Valkonen.

Former Ion3 users will be glad to hear any changes to configuration will be backwards-compatible, so you can simply drop your ~/.ion3 tweaks into ~/.notion and rename cfg_ion.lua to cfg_notion.lua.


Notion 3 is available under a slightly modified LGPL license: in short, the only extra restriction is you cannot release it under the name ‘Ion’ and cannot mix it with GPL code, but read the license itself for details.

Notion 4, which is not yet released, will be plain LGPL again. You can build a prerelease of Notion 4 from the ‘master’ branch.

Other software


The following software combines well with Notion:

  • stalonetray shows FreeDesktop (XEmbed) and KDE trayicons
  • trayion shows FreeDesktop (XEmbed) trayicons (like Qt4 and gtk2)
  • arandr a flexible tool for manipulating your monitor layout, resolutions, orientations

Clipboard utilities:

  • autocutsel for keeping various clipboards synchronized
  • parcellite more advanced clipboard management (with history)

Notification daemons:


  • i3wm very nice tiling wm, but doesn’t handle tabbing quite as nicely as Notion
  • awesomewm the most popular tiling wm