Instantly share code, notes, and snippets.

What would you like to do?
A simple installation guide for i3-gaps

Installing i3-gaps


i3-gaps has some packages that are required for it to work so install these things:

sudo apt install libxcb1-dev libxcb-keysyms1-dev libpango1.0-dev libxcb-util0-dev libxcb-icccm4-dev libyajl-dev libstartup-notification0-dev libxcb-randr0-dev libev-dev libxcb-cursor-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev autoconf xutils-dev libtool 

You also need to install libxcb-xrm-dev, but I got Unable to locate package libxcb-xrm-dev when trying to install from the apt repositories on Ubuntu 16.04. If this happens to you, just install it from source using these commands:

mkdir tmp
cd /tmp
git clone
cd xcb-util-xrm
git submodule update --init
./ --prefix=/usr
sudo make install


gaps also needs to be installed from source so run these commands:

cd /tmp
git clone i3-gaps
cd i3-gaps
git checkout gaps && git pull
autoreconf --force --install
rm -rf build
mkdir build
cd build
../configure --prefix=/usr --sysconfdir=/etc
sudo make install

Now i3-gaps should be installed.


To enable gaps you need to set some variables in your i3 config.

gaps inner <# of pixels>
gaps outer <# of pixels>

Add this to get rid of titlebars because gaps doen't work with titlebars:

for_window [class="^.*"] border pixel 2

Refresh i3 and you're good to go!


This comment has been minimized.

lokeshh commented Nov 12, 2018

Works without any problem. Thanks!

I want to suggest 10 as the number of pixels if you have no idea what it should be.


This comment has been minimized.

UnwarySage commented Nov 16, 2018

autoreconf: failed to run aclocal: No such file or directory

this error can be fixed be installing automake

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment