Metadata-Version: 2.1
Name: launch-on-workspace
Version: 1.0.0
Summary: Launch applications on a given workspace and given monitor in Linux
Home-page: https://github.com/xblahoud/launch_on_workspace
Author: Fanda Blahoudek
Author-email: fandikb+low@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown

# Launch-on-workspace
Launch applications on a specified workspace in Linux.

The script [launcher](launcher.py) implements several useful functions that can launch (in a scriptable manner) applications on designated workspaces on X in Linux. Relies on [wmctrl](http://tripie.sweb.cz/utils/wmctrl/) to manipulate windows on workspaces.

The scripts [displays](displays.py) moves windows to displays in similar manner. Right now it relies on [xrandr](https://www.x.org/wiki/Projects/XRandR/) to get mapping of displays to workspace coordinates. You can use it even without `xrandr` by supplying the right coordinates for `wmctrl` by yourself.

The script [custom_launchers](custom_launchers.py) uses the functionality of [launcher](launcher.py) to provide functions that launch specific programs. They serve as an easy abstraction from some implementation details for non-standard situations. The motivation for these is threefold:
 1. Some programs need carefull treatment as they (a) use some temporary window at startup and we actually want to move the second one (`texstudio`), or (b) you usually have some other instances running in the system and no new process is created (`firefox`)
 2. It simplifies supplying arguments (`terminal`)
 3. Some applications need 2 or more windows to be moved (`jupyter-lab`)
Currently, we have functions for launching:
 * `gnome-terminal`
 * `firefox`
 * `jupyter_lab`
 * `texstudio`
All these functions return the IDs of windows they create so they can be further positioned on monitors using the functions from [displays](displays.py).

## Requirements
* Python 3.6+
* [wmctrl](http://tripie.sweb.cz/utils/wmctrl/)
* [xrandr](https://www.x.org/wiki/Projects/XRandR/)
* and compatible window manager 

tested with Gnome 3.34.1 on Ubuntu 19.10

## Examples
The following command launches a new window of Firefox that opens YouTube on workspace 2 (in wmctrl) which is a workspace 3 in Gnome. It is then moved to display connected to DisplayPort#1 (name "DP-1" in `xrandr`) and switched to fullscreen mode.

```python
import launch_on_workspace as low

wid = low.firefox(2, "youtube.com")
low.move_win_to_display(wid, "DP-1", "full")
```

The following command opens a gedit on workspace 4 in Gnome
```python
low.launch_and_move(['gedit'], 3)
```


