ncurses window manager selector Git
Status: Beta
Brought to you by:
al79
File | Date | Author | Commit |
---|---|---|---|
src | 2009-05-13 | Alberto Negri | [6f99c5] Nwm version 1.0.1 |
AUTHORS | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
COPYING | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
ChangeLog | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
INSTALL | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
NEWS | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
README | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
sample.nwm_cfg | 2009-05-13 | Alberto Negri | [1874cb] Nwm-1.0.1 version |
Nwm 1.0.1 --------- ======= 1. Description 2. Requirements 3. Build 4. Run 5. Config file 6. Help 7. Contacts ========= 1. Description ============ Nwm is a simple program that will let you run an x server and then a generic window manager (or other executable) into it. This software is a replacement of selectwm of witch this software would be an extension. Infact selectwm could not run different kind of window manager on different kind of server x. With selectwm you should before run xinit (xorg-x11), but i.e. you could not run xgl too. These because selectwm is designed to starts within .xinitrc, this mean a fixed x server: xorg-x11. While with nwm read lines from a config file, and then show them or in a text mode, or with ncurses library. When user select one line, nwm executes command part contained into that lines. In this way you're not obliged to put nwm into .xinitrc, so nwm is not dependent from a fixed server. This design feature has allowed me to run successfully: fluxbox with xorg, kde with xorg, kde with xgl. ========= 2. Requirements ============ To run Selectwm you need: - C compiler (i used only gcc-3.4.6) - A generic server x (tested only with: xgl and xorg) - ncurses >= 5.5-r2 - imake (used to create standard Makefile) I know that it works on my Linux Box (i686) with Gentoo (it shouldn't be too difficult to run it on another box. If it doesn't work for you, mail me, please). ========= 3. Build ============ To build nwm type (if you're reading this you're already into nwm main folder): 1. cd src/ 2. xmkmf 3. make ========= 4. Run ============ To run nwm simply: ./nwm Usually you may want that binary files resides into your home folder so you have to copy it there: cp nwm $HOME Now you have to run it typing from you home directory: ./nwm don't forget "./". Else you can put nwm binary file to system wide binary directory (like /usr/bin). Then gives to binary file right permissions(as root do): 1. cp nwm /usr/bin/ 2. cd /usr/bin 3. chown root:root nwm 4. chmod a+x nwm Now you'll be able to run it without prefixing "./". As default nwm will looks at user home directory to find a config file named ".nwm", but you can change this behaviour with -c option. ========= 5. Config file ============ As default nwm will looks at ".nwm" file as default config file. You can save your config file into your home directory with that name, so you'll be able to run nwm with: ./nwm #without -c params. At this point you must not modify your .xinitrc. You has only to create a valid config file and use nwm. Into configuration file you should add a description and the command that must be executed, into .selectwmrc fashion. But no timeout are still supported. Each row must contain: <description>=<server x>,<window manager> For example: fluxbox=/usr/bin/xinit,/usr/bin/fluxbox kde=/usr/bin/xinit,/usr/kde/3.5/bin/startkde xgl=/usr/local/overlays/xgl-coffee/startxgl,kde,nvidia fluxbox=/usr/bin/xinit,/home/user//.fluxbox/fluxbox.sh Last row will run a script that contains a custom fluxbox version. In this way you can set up further other tool to run with fluxbox. Config File Examples: 'fluxbox=/usr/bin/xinit,/usr/bin/fluxbox' to run fluxbox into xorg server 'kde=/usr/bin/xinit,/usr/kde/3.5/bin/startkde' to run kde into xorg server 'xgl=/usr/local/overlays/xgl-coffee/startxgl,kde,nvidia' to run kde into xgl 'fluxbox=/usr/bin/xinit,/home/user//.fluxbox/fluxbox.sh' to run your fluxbox script into xorg server. Fluxbox script may contains some command sequence like: /usr/bin/gkrellm2 -w & /usr/bin/wmxmms & /usr/bin/fluxbox Last row is needed, while previous are optional. Nwm is realeased with a default config file. You can look at: sample.nwm_cfg ========= 6. Help ============ If you run nwm with -m | --text-mode option you does not use ncurses library else nwm will automatically use them. If you need to see all nwm options you can type: nwm -h or you can type: nwm --help you'll see following main options: You can also use a few options: -c, --config <cfg> select the config file (default .nwm) -h, --help prints this message -m, --text-mode disable ncurses -t, --tty-number <tty> will run your selection on different display then default(:0) -v, --version prints version information ========= 7. Contacts ============ For any problems feel free to send me a mail at alberto.negri@gmail.com. Thanks for use nwm. Alberto Negri