====== 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 //

===== 1) Downloading and extracting =====


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''

===== 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//

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

===== 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: 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 = "160x20-1120+780"''

I have 1280x800 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 = "100x100+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 &''

===== 4) Examples how Netwmpager can look like =====

{{:netwmpager.png|}}{{:ntwmp150309.png|}}