Note: this wiki is no longer maintained. If you have any questions related to this wiki, please post them on the CrunchBang forums.
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.
Here is where you get the Netwmpager: http://ftp.osuosl.org/pub/gentoo/distfiles/netwmpager-1.11.tar.bz2
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
$ 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
Now you're in netwmpager-1.11 folder and we can start actual installing.
And result should be something like this:
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
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
So we assume that everything went well and possible problems are solved. We can carry on.
After that as root (it will ask your password).
$ sudo make install
Hopefully everything went well.
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: http://crunchbanglinux.org/pastebin/147
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 autostart.sh (main menu → preferences → Openbox Config → Edit autostart.sh)