Python simple tiler for non-tiling window managers
Project description
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. Example:
#!/bin/sh xfce4-terminal && pyst move left xfce4-terminal --working-directory=/var/www && pyst move bottom_right xfce4-terminal --working-directory=/home && pyst move top_right
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
[ ] 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pystiler-0.2.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3724959ceeb204555772eabc1e5c04181509a897c9bbf69719c00b3691eefbcf |
|
MD5 | 19b3f3adf9a0e6001d6dc1934e807700 |
|
BLAKE2b-256 | a9ed923aa0da4a37d3f9691aea4756e0621bbec5721ba425a39ca82d03f85c81 |