Metadata-Version: 1.1
Name: pystiler
Version: 0.2.5
Summary: Python simple tiler for non-tiling window managers
Home-page: http://github.com/riley-martine/pystiler
Author: Riley Martine
Author-email: riley.martine.0@gmail.com
License: MIT
Description: Pystiler (a PYthon Simple TILER)
        ================================
        
        .. image:: https://badge.fury.io/py/pystiler.svg
               :target: https://badge.fury.io/py/pystiler
        
        
        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
        
Keywords: window-manager tiling wm command-line cli
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Desktop Environment :: Window Managers
