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.

Copy link

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.

Copy link

UnwarySage commented Nov 16, 2018

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

this error can be fixed be installing automake


This comment has been minimized.

Copy link

kittenparry commented Feb 13, 2019

Works pretty well. Thanks!

Also, in README they suggest 0 pixels for titlebars. What is the difference between 0 and 2?

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