Asger Geel Weirsøe 39f384e64b Update README.rst
2020-09-05 10:27:35 +02:00
2020-09-05 10:15:39 +02:00
2020-09-04 16:49:37 +02:00
2020-09-05 10:27:35 +02:00
2020-09-05 10:15:39 +02:00
2020-09-05 10:15:39 +02:00

About
-----

Simple program that looks through the i3 config and finds the bound workspaces for each output, and then opening that workspace on the output, that the mouse is currently on.

Allowing for a more seameless interaction with how workspaces are openend. 

Usage
-----

::

   usage: pi3-smart-switch [-h] -i num
   Openens the [i] number of workspace assigned in the config, on the output the cursor is currently on.


   requred arguments:
     -i, --index      the number index of the workspace that should be openend. 1 =  first workspace in config etc.
Installation
------------

Install using pip (recommended):

::

   pip install pi3-switch

Example config to be inserted into your i3 config.

::

        # Displays
	set $primary DP-2
	set $left HDMI-0
	set $right HDMI-1

	# WOrkspaces
	set $ws1 1:1:Code
	set $ws2 2:2:Code
	set $ws3 3:3:Code
	set $ws4 4:4:Code
	set $ws5 5:5:Code
	set $ws6 6:6:Code
	set $ws7 7:7:Code
	set $ws8 8:8:Code

	set $LeftWs1 1:1:Browser
	set $LeftWs2 2:2:Left
	set $LeftWs3 3:3:Left
	set $LeftWs4 4:4:Left
	set $LeftWs5 5:5:Left
	set $LeftWs6 6:6:Left
	set $LeftWs7 7:7:Left
	set $LeftWs8 8:8:Left

	set $RightWs1 1:1:Right
	set $RightWs2 2:2:Right
	set $RightWs3 3:3:Right
	set $RightWs4 4:4:Right
	set $RightWs5 5:5:Right
	set $RightWs6 6:6:Right
	set $RightWs7 7:7:Right
	set $RightWs8 8:8:Right

	# Workspace assignments
	workspace $ws1 output $primary
	workspace $ws2 output $primary
	workspace $ws3 output $primary
	workspace $ws4 output $primary
	workspace $ws5 output $primary
	workspace $ws6 output $primary
	workspace $ws7 output $primary
	workspace $ws8 output $primary

	workspace $LeftWs1 output $left
	workspace $LeftWs2 output $left
	workspace $LeftWs3 output $left
	workspace $LeftWs4 output $left
	workspace $LeftWs5 output $left
	workspace $LeftWs6 output $left
	workspace $LeftWs7 output $left
	workspace $LeftWs8 output $left

	workspace $RightWs1 output $right
	workspace $RightWs2 output $right
	workspace $RightWs3 output $right
	workspace $RightWs4 output $right
	workspace $RightWs5 output $right
	workspace $RightWs6 output $right
	workspace $RightWs7 output $right
	workspace $RightWs8 output $right

	# Binded
	bindsym $mod+Mod1+1 exec pi3-smart-workspace -i 1
	bindsym $mod+Mod1+2 exec pi3-smart-workspace -i 2
	bindsym $mod+Mod1+3 exec pi3-smart-workspace -i 3
	bindsym $mod+Mod1+4 exec pi3-smart-workspace -i 4
	bindsym $mod+Mod1+5 exec pi3-smart-workspace -i 5
	bindsym $mod+Mod1+6 exec pi3-smart-workspace -i 6
	bindsym $mod+Mod1+7 exec pi3-smart-workspace -i 7
	bindsym $mod+Mod1+8 exec pi3-smart-workspace -i 8


Credits
-------

Thanks to Michał Wieluński for an inspiration (`pi3-switch`_) and
Tony Crisci for an easy-to-use i3 python library (`i3ipc-python`_).

.. _pipsi: https://github.com/mitsuhiko/pipsi
.. _pi3-switch: https://github.com/landmaj/pi3-switch
.. _i3ipc-python: https://github.com/acrisci/i3ipc-python
Description
PyOutputHandler
Readme Apache-2.0 89 KiB
Languages
Python 97.9%
Shell 2.1%