skip to navigation
skip to content

pystiler 0.3.1

Python simple tiler for non-tiling window managers

The goal of this project is to be able to define tiled workspaces and open them with ease on non-tiling wms.

This is a simple python script which wraps wmctrl to allow for easier tiling.

Bind it to a key or to autowhatever-on-window-creation-hook, create scripts to setup a workspace, or make aliases to quickly move terminals.

Originally a fork of github.com/TheWanderer/stiler but has diverged to the point of countaining almost none of the original code.

Install

Install with

pip3 install pystiler

Usage

You can use the pyst tool to move the active window.

Run simple commands with

pyst move <arg>

Currently arguments are left, right, top, bottom, top_left, bottom_left, top_right, bottom_right, and maximize, all of which do pretty much what you’d expect to the active window.

Run more complex commands with

pyst explicit <screen rows> <screen columns> <first column> <last column> <first row> <last row>

eg.

pyst explicit 2 3 2 2 1 2

defines a screen grid of dimensions 2 rows, 3 columns, and resizes the active window to fill the second column only, first through second row. (so, the window would now occupy the center vertical third of the screen)

and

pyst explicit 3 2 1 2 1 2

defines a screen grid of 3 rows, 2 columns, and resizes the active window to fill the first through second row of the first through second column (the top 2/3 of the screen)

Workspacing

Using this script, you can define and run workspace configs. Workspace configs allow you to set up worksapces where certain applications are opened in positions on the screen.

Pystiler looks for ~/.pystiler.ini for the config file. It uses configparser to parse it. You can generate an example config by running pyst workspace-example. There are three types of config modes:

  • simple, where the application (and optionally, directory) is the same every time, but the locations are different
  • specific, where there may be more than one application, and the directories might be different
  • explicit, where you can use non-named locations using the explicit api.

Start a workspace with pyst workspace $workspacename

Currently, terminaldir does nothing, and neither does explicit. These are on the todo list.

Todos for the project

  • [x] Add top and bottom targets
  • [x] Add [top,bottom][left,right] targets
  • [x] Add simple CLI interface
  • [x] Add simple test cases
  • [x] Make nice python package
  • [x] Add simple workspace config
  • [ ] Add complex workspace config
  • [ ] Allow passing arguments to workspace config
  • [ ] Add coverage
  • [ ] Use logging instead of debug flag
  • [ ] Add tests for window resizing
  • [ ] Make explicit api nicer
  • [ ] Find out why cols and rows reverse and fix it
  • [ ] Find out what’s causing wmctrl to misfire on second call
  • [ ] Find out what bug fixes others have done
  • [ ] Map out final goals of project
  • [ ] Make list of already-resized window IDs to mitigate the resizing problem
  • [ ] Figure out async loading for workspaces
  • [ ] Add code quality review
 
File Type Py Version Uploaded on Size
pystiler-0.3.1-py2.py3-none-any.whl (md5) Python Wheel py2.py3 2017-08-23 9KB
pystiler-0.3.1.tar.gz (md5) Source 2017-08-23 6KB