Metadata-Version: 2.1
Name: i3wins
Version: 0.0.3
Summary: Yet another i3 window switcher
Home-page: https://github.com/ylmrx/i3wins
Author: Yoann Lamouroux
Author-email: ylamouroux@ubuntu.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: i3ipc
Requires-Dist: dynmen
Requires-Dist: traitlets

# i3wins/i3lasts

As the name might suggest, this is a wrapper to rofi acting as a window-switcher.

I found `-show window` option to be quite slow, and would often get in the way. On another topic, I use i3 in an XFCE environment (for the PM and such)… and the virtual desktops would conflicts, and be generally weird.

i3wins is fast and won't get in the way.

i3lasts is also a window-switcher, but it keeps track of your focused windows through time. It's insanely effective if you go back and forth a lot. It comes as a server (which need to be running at all time) / client as i3 won't keep track of those.

# Pre-requisites

- i3
- rofi
- a working python3 environment can help
- libi3ipc (`libi3ipc-glib` on ubuntu/debian)

# Installation

I recommand using some virtual environments.

```bash
python3 -m venv new_folder
source new_folder/bin/activate
pip install i3wins
deactivate
```

If you're a more yolo-oriented person : `pip install --user i3wins`

You can now run : `new_folder/bin/i3wins`

# Help !

No help. All options you give to i3wins are directly sent to rofi. 

Check rofi manpage.

# Settings

Here's a snippet from my i3 config:

## i3wins

```
bindsym Mod1+Tab exec "/home/fuzzy/.local/share/virtualenvs/i3switch/bin/i3wins -kb-row-down 'Down,Control+n,Alt+Tab' -kb-accept-entry '!Alt+Tab,!Alt_L,!Alt+Alt_L,Return'"
```

## i3lasts

```
bindsym Mod1+space exec "/home/fuzzy/.local/share/virtualenvs/i3switch/bin/i3lastc"
[...]
exec --no-startup-id "/home/fuzzy/.local/share/virtualenvs/i3switch/bin/i3lasts -kb-row-down 'Down,Control+n,Alt+space,space' -kb-accept-entry '!Alt+space,!Alt_L,!Alt+Alt_L,Return'"
```

Feel free to use it as-is. Or modify it into oblivion.

# Some explanation on the i3 config

Long story made short :
- Faster mode : Hold Alt, then press Tab as many times as needed, when you're where you want : release Tab *then* Alt.
- Not so fast : Hold Alt, then press Tab and release Alt while still holding Tab : the window will stay there, you can search text, scroll, validate with a single press on Alt, or the good'ol Enter key

(the spacebar has the same behavior)

You'll get used to it.

# More swag

## Keys

Have you noticed desktops are displayed with d1, d2, d3, … And that windows are numbered in the relevant order with 'w' ?

Have you noticed how close d and w are close to the tab key ?

… just saying.

## Eyes

- Current desk is pink
- Current window is yellow
- I think you're cool
- Have a mojito.

Colors are hardcoded and were set by yours truly for ecstatic co-workers' high-fives and maximum swaginess in every situation. But they're still designed for darker themes of rofi.

# Todo

- Handles URGENCY,
- tags Fullscreen windows as such,
- deal with vim-marks and more i3-specific concepts (tree depth for examples).
- show current desktop windows in the right order (they are in reverse currently)
- Support for rofi 1.5.4 (allows icons in dmenu mode)



