I am a big fan of i3 window manager -- it is fast, it has a minimalistic design, and if you add a couple of simple tools and scripts it really replaces complex desktop environments. The main purpose of this repository is to gather such tools and share them with other i3 users.
Also, Michael has very strong opinions about the amount of features and functions that i3 should have. Well, that's his baby, however, I do not share that strictness. Having said that, I would also like to have a collection of patches which work, but which will be never merged due to ideological reasons.
Further down I will describe the extras I found interesting, and I hope to get some more stuff from you guys!
- Patches
- dmenu replacements
- Nagbar replacements
i3lockrelated- Windows related
- Workspace related
- Status bar related
- Vim syntax for i3 config
- Scratchpad manager
This is an ancient patch from Kevin Murphy that was never merged in. I didn't had a chance to test if it still works, but I like the idea.
The file i3bar-xbm-icons.patch is a patch that adds support for xbm icons to
i3bar. The patch adds two fields to the IPC protocol of i3bar which are:
icon and icon_color.
Here is a picture how it looks like:
Here is a configuration file for conky in order to produce the picture from above.
- Xlib has a function to draw xbm, but it didn't work for me, so I am using something like putpixel to draw the pixels of the parsed image.
- Caching. Currently the pictures are parsed every time the status changes, which is every second or so. It doesn't waste a lot of CPU, however a tiny hash-table would be much cleaner.
The makefile-gcc-opt.patch increases default optimisation level. This patch
assumes that you are going to use GCC compiler, however it should work with
icc -gcc and with clang as well.
0x2493 kept a set of small patches to customise borders, i3bar and window header sizes and use extract cwd from focused window. He had a repository on github, later moved it to bitbucket and then deleted it. These patches are now available locally:
-
cwd-execextracts current working directory from the focused window before spawning the child. That would allow to have smarterMod + return, which may open a new terminal with cwd taken from the old one. -
smart-borderdoesn't draw a border around the window it is the only window on a workspace. -
tiny-barremoves extra spaces around the font in i3bar, which makes the i3bar tinier. -
tiny-titlesremoves extra spaces around the font in window titles.
Maris Muja created a patch to draw an application icon in the left corner of the window bar. Please have a look at his i3wm repository, you can find some more patches there.
alessandro-g89 has created a patch that makes it possible to use desktop windows (with wallpaper and icons) created by file managers like Natutilus, PCManFMM and others. Please find some brief instructions here on how to use the patch as well as suggestions for further improvements.
dmenu replacements
Sean Pringle's rofi is a generic very powerful dmenu-like tool that can be used for all kinds of custom launchers, e.g. window switching, running commands, ssh sessions, etc. It is fully configurable and well-maintained.
Also, consider these two rofi-related scripts to apply colorscheme from i3 config file to rofi, and to create a shutdown menu that can be used as a replacement for nagbar.
The file i3-exit is a python script that throws a simple menu in the middle of
the active workspace which allows you to chose your action on exit. It uses
i3-py to find out an active space and
geometry and it uses dzen2 to draw a menu.
Here is a picture of how it looks like:
- Sometimes the keys does not go to the application. Don't really know why. It might be a problem of dzen2 itself, it might be the case that i3 switches the focus as the mouse cursor is not on the window. Don't know.
Here is another version of i3-exit
created by Ivan Tsybulin. He uses pygtk with
buttons and have much more sophisticated choices than the previous script does.
The i3lock-wrapper is a simple shell script that uses i3lock and
imagemagick. It grabs a
screenshot, blurs it and launches i3lock with it. The blurring constant is chosen
in such a way that hides the text, but leaves the overall structure of windows etc.
If you don't know that it's a screensaver, the first instinct is to adjust settings of
your monitor. Very nice.
Here is a picture of how it looks like:
For Arch Linux users here is an AUR created by Thiago Perrotta.
Ivan Tsybulin created a patch for i3lock which centners images in case their size is smaller than the screen resolution.
These two scripts make it possible to focus on one of the open widnows.
A list of open windows is piped to dmenu and the focus is moved to the
chosen one. One implementation can be found in
Jure Ziberna i3-py/examples
repository. The script is called winmenu.py.
Another implementation can be found in quickswitch-for-i3 repository.
- Unicode characters are not rendered properly. Probably it has something to do
with the encoding that
dmenuexpects.
AladW have created a patch that makes it possilbe to close a window via the middle mouse click.
Cameron Leger created a set of scripts that make it possible to:
- rename/renumber workspaces
- move workspaces
- go to a workspace
The scripts can be bound to the keys of your choice which gives a convenient interface to i3 features that otherwise are available only via i3-input.
In Jure Ziberna i3-py/examples
there is a wsbar.py script which is a Python replacement for wsbar from the i3 repository.
enkore is maintaining a python framework called i3pystatus which replaces i3status. A very similar thing can be done using conky; however,
this tool is tailor-made for i3bar. Its modular design makes it possilbe to contribute functionality
as Python modules which can be imported later in the output-generator.
py3status has a similiar name, but uses a different
approach: it wraps i3status and adds extra functionality via Python modules. It is maintained
by ultrabug.
bumblebee-status by
Tobias Witek is a replacement for i3status
written in python. It has a large number of modules and it doesn't require any configuration: a user only
passes a list of modules she wants to see on the statusline, and the tool figures
out all the details.
gpix13 created a shell script to generate a status bar
which is later displayed by dzen. Here is a screenshot of the bar generated from
status.sh:
- Here is a general problem with
dzen-- it doesn't have a support for tray. So the alternatives are either to show dzen and i3bar, which is a waste of space, or using something else for tray. - Most of the output here, can be obtained from
conky. Wouldn't it be faster?
Wang Chao created
a script that parses the output of i3status and appends it with icons and some extra
information. The outpus is piped to dzen is displaying the output. Here is how it looks like:
Here is a very nice set of xbm icons which you can hopefully steal :)
Vivien Didelot maintains the
i3blocks project.
i3blocks is highly flexible status line for the i3. It handles
clicks, signals and language-agnostic user scripts. The content of each block
(e.g. time, battery status, network state, ...) is the output of a command provided
by the user. Blocks are updated on click, at a given interval of time or on a
given signal, also specified by the user. It aims to respect the i3bar protocol,
providing customization such as text alignment, urgency, color, and more. See this
wiki for more details.
lynks-- is maintaining an i3bar replacement called lifebar. This is a i3bar-like panel combined with a
functionality of i3status. It enables transparency by default and is fully configurable.
The project is in its early stages but it is being actively developed. Here is a default
liefbar screenshot:
Michael Carlberg created a tool called polybar which is customizable status bar. It comes with a set of modules that can be turned on and off in the config file to alter appearance of the status bar, similarly to conky. The status bar is very configurable and a number of custom user modules are available. Note that one can always pipe a custom command in the bar. The tool and modules are written in C++.
Emanuel Guével wrote a syntax file for i3 config.
In order to use it you can add # vim:filetype=i3 as a comment to your i3 config
file, or you can do it manually. Another option is to recognise the path to the i3
config and write an autocmd: autocmd BufEnter *i3/config setlocal filetype=i3
Mustafa Gezen created a manager for i3 scratchpad called zx. The manager makes it possible to track the windows that are currently in the scratchpad.