agwells / pywo

Automatically exported from code.google.com/p/pywo
GNU General Public License v3.0
0 stars 0 forks source link

PyWO - Python Window Organizer

Introduction

PyWO allows you to easily organize windows on the desktop using keyboard shortcuts. It's inspired by Quicktile, Compiz plugins: Grid, Put, and Maximumize.

Features:

Watch PyWO in action

Requirements

Build & Install

Download

Download archive with PyWO-0.2 for stable version.

Checkout project's Subversion repository for development version (/trunk folder). This version contains latest features and bugfixes, but I can't guarantee that it will be stable!

Compatibility

PyWO works with (or at least should work with) any EWMH compliant window manager.

Seems to work OK (or almost OK) with:

In 0.2 version there are problems with:

Development version works OK with GNOME 3 (Mutter)

Usage

Just run ./pywo.py

Create ~/.pyworc file to configure PyWO. Read PyWO Configuration for reference. Defaults can be found in pyworc file. You can choose one of the predefined grid layouts: 2x2, 3x2 (default), 3x3, or define your own.

PyWO creates /tmp/PyWO.log file where all debugging informations are logged.

Default keyboard shortcuts:

Alt-Ctrl-Shift-Q    - exit PyWO
Alt-Ctrl-Shift-R    - reload configuration file
Alt-Ctrl-Shift-I    - print debug information about window manager and current window

Alt-KP_Divide       - switch windows (change position of the window)
Alt-Shift-KP_Divide - cycle windows (change contents of the window)

Alt-KP_1-9          - move window in a direction (KP_1-9 - numpad keys)
Shift-KP_1-9        - expand window in a direction (5 works as maximumize compiz plugin)
Alt-Shift-KP_1-9    - shrink window
Alt-Ctrl-KP_1-9     - put window to predefined position
Ctrl_KP_1-9         - put and resize (grid), and cycle widths
Ctrl-Shift_KP_1-9   - put and resize (grid), and cycle heights

Cycle/Switch - press keyboard shortcut and select other window (using Alt-Tab, or using mouse). If you want to cancel switch/cycle press again the keyboard shortcut

Known bugs

TODO

Changelog

developmnet version (check out /trunk from repository)

0.2

0.1.1

0.1