Metadata-Version: 2.0
Name: raiseorlaunch
Version: 0.1.0
Summary: Run-or-raise-application-launcher for i3 window manager.
Home-page: https://github.com/open-dynaMIX/raiseorlaunch
Author: Fabio Rämi
Author-email: fabio@dynamix-tontechnik.ch
License: MIT
Description-Content-Type: UNKNOWN
Keywords: i3 run-or-raise launcher navigation
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: POSIX :: Linux
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Requires-Dist: i3-py

# raiseorlaunch

Run-or-raise-application-launcher for i3 window manager.  
If a specified application is already running, it will just focus the window. 
If not, it will run the application.

It's also possible to specify a workspace. That way only this workspace will
be used to raise and launch.  
workspace_auto_back_and_forth - if enabled - remains functional.  
It's also possible to use the scratchpad.

You can specify a window class, instance and/or title.

raiseorlaunch is intended to be used with i3-shortcuts.

It depends on [i3-py](https://github.com/ziberna/i3-py)


## Usage and options

```
usage: raiseorlaunch [-h] [-i] [-w WORKSPACE] [-r] [-e COMMAND] [-c WM_CLASS]
                     [-s WM_INSTANCE] [-t WM_TITLE] [--version]

Run-or-raise-application-launcher for i3 window manager.

optional arguments:
  -h, --help            show this help message and exit
  -i, --ignore-case     ignore case.
  -w WORKSPACE, --workspace WORKSPACE
                        workspace to use.
  -r, --scratch         use scratchpad
  -e COMMAND, --exec COMMAND
                        command to execute. If omitted, -c, -s or -t will be
                        used (lower-case). Careful: The command will not be
                        checked prior to execution!
  -c WM_CLASS, --class WM_CLASS
                        the window class.
  -s WM_INSTANCE, --instance WM_INSTANCE
                        the window instance.
  -t WM_TITLE, --title WM_TITLE
                        the window title.
  --version             show program's version number and exit
```


## Examples

```
raiseorlaunch -c Firefox -s Navigator
```
Run or raise Firefox.

```
raiseorlaunch -w SL -c Sublime_text -s sublime_text -e subl
```
This uses the workspace SL for sublime text.

```
raiseorlaunch -r -c SpeedCrunch
```
Here we raise or launch SpeedCrunch and use the scratchpad.


