Netwmpager HowTo

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: http://tldp.org/LDP/LG/current/smith.html

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

$ wget http://ftp.osuosl.org/pub/gentoo/distfiles/netwmpager-1.11.tar.bz2

$ 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.

$ ./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

creating config.mk

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

LDFLAGS:

Installation Directories:

bindir: /usr/local/bin

datadir: /usr/local/share

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

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.

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:

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”

Colours

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

Other

Launching it: alt+f2 and type netwmpager

You can also add it in autostart.sh (main menu → preferences → Openbox Config → Edit autostart.sh)

netwmpager &