Note: this wiki is no longer maintained. If you have any questions related to this wiki, please post them on the CrunchBang forums.

Translations of this page?:

Z-edit HOWTO Install and Configure Netwmpager

does it still work?

Netwmpager is a small pager and easy to configure but not very well documented.

For those who are not familiar with installing applications from source. The three commands we are going to use.

  • You run configure (you usually have to type ./configure as most people don't have the current directory in their search path). This builds a new Makefile.
  • Type make This builds the program. That is, make would be executed, it would look for the first target in Makefile and do what the instructions said. The expected end result would be to build an executable program.
  • Now, as root, type make install. This again invokes make, make finds the target install in Makefile and files the directions to install the program.

- from:

1) Downloading and extracting

Here is where you get the Netwmpager:

Note: you need libxft-dev.

So open terminal (for example terminator) and type there:

sudo apt-get install libxft-dev

I download everything first in my downloads folder:

$ cd ~/downloads

$ wget

$ tar -xvf netwmpager-1.11.tar.bz2

After extracting ($ tar -xvf netwmpager-1.11.tar.bz2) go to “netwmpager-1.11” folder.

$ cd netwmpager-1.11

2) Installing

Now you're in netwmpager-1.11 folder and we can start actual installing.

$ ./configure

And result should be something like this:

xxx@xxx:~/downloads/netwmpager-1.11$ ./configure

checking for program gcc… /usr/bin/gcc

checking for CC flag -std=gnu99 -pipe -Wall -Wshadow -Wcast-align -Wpointer-arith -Wundef -Wmissing-prototypes -Wredundant-decls… yes

checking for CC flag -Wdeclaration-after-statement… yes

checking for CC flag -Wold-style-definition… yes

checking for CC flag -Wno-pointer-sign… yes

checking if CC can generate dependency information… yes

checking for program pkg-config… /usr/bin/pkg-config

checking xft (pkg-config)… yes

checking CFLAGS for xft… -I/usr/include/freetype2

checking LIBS for xft… -lXft


Compiler Settings:

CC: gcc

LD: gcc

CFLAGS: -O2 -std=gnu99 -pipe -Wall -Wshadow -Wcast-align -Wpointer-arith -Wundef -Wmissing-prototypes -Wredundant-decls -Wdeclaration-after-statement -Wold-style-definition -Wno-pointer-sign -MMD -MP -MF .dep-$@ -DDEBUG=0


Installation Directories:

bindir: /usr/local/bin

datadir: /usr/local/share


So we assume that everything went well and possible problems are solved. We can carry on.

$ make

After that as root (it will ask your password).

$ sudo make install

Hopefully everything went well.

3) Configuring

As mentioned in the beginning, you can configure Netwmpager to look the way you want. The example config file is in ”/usr/local/share/netwmpager”

$ cd /usr/local/share/netwmpager

$ cp config-example ~/.config/netwmpager/config

Open the config file with your favourite editor (vim, leafpad, gedit…):

$ leafpad ~/.config/netwmpager/config

Here is my Netwmpager config:

I will not go thru whole config file, but I will mention few points that may cause problems.


geometry = “160×20-1120+780”

I have 1280×800 screen and above example positions it exactly in the left bottom corner, and it is 160px wide and 20px high. But if you want to have netwmpager as 100 x 100px square in the right top corner, you would have:

geometry = “100×100+1180-700”


At first sight colour codes may look bit odd. But they're normal hexadecimal colour codes just with slashes. So for example:

#47774E is 47/77/4E


Launching it: alt+f2 and type netwmpager

You can also add it in (main menu → preferences → Openbox Config → Edit

netwmpager &

4) Examples how Netwmpager can look like

netwmpager_howto.txt · Last modified: 2012/05/24 09:23 by machinebacon
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Share Alike 3.0 Unported

Powered by DokuWiki. Hosted by Linode.
Copyright © 2010 CrunchBang Linux.
Proudly powered by Debian GNU/Linux.
Debian is a registered trademark of Software in the Public Interest, Inc.