Annotation of wikisrc/tutorials/x11/fluxbox.mdwn, revision 1.2

1.1       nia         1: Fluxbox is yet another windowmanager for X. 
                      2: 
                      3: It is based on the Blackbox 0.61.1 code. Fluxbox looks like blackbox and handles styles, colors, window placement, and similar things exactly like blackbox (100% theme/style compatibility). 
                      4: 
                      5: #  Install Fluxbox 
                      6: 
1.2     ! nia         7: To install fluxbox use its package provided in pkgsrc [wm/fluxbox](//cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/wm/fluxbox/): 
1.1       nia         8:     
                      9: 
                     10:     # cd /usr/pkgsrc/wm/fluxbox
                     11:     # make install
                     12:     
                     13: 
                     14: When installation is finished, define fluxbox by creating _.xinit_ file in user home directory: 
                     15:     
                     16:     # cd /root
                     17:     # vi .xinitrc
                     18:     
                     19: 
                     20: The typical contents of this file is: 
                     21:     
                     22:     exec fluxbox
                     23:     
                     24: 
                     25: To make further tunes per your needs, you can create fluxbox directory and place into it your configuration files. 
                     26:     
                     27:     # mkdir /home/myuser/.fluxbox
                     28:     
                     29:     
                     30: 
                     31: Tipical configuration is _/root/.fluxbox/menu_ file, with following contents: 
                     32:     
                     33:     # Generated by fluxbox-generate_menu
                     34:     #
                     35:     # If you read this it means you want to edit this file manually, so here
                     36:     # are some useful tips:
                     37:     #
                     38:     # - You can add your own menu-entries to ~/.fluxbox/usermenu
                     39:     #
                     40:     # - If you miss apps please let me know and I will add them for the next
                     41:     #   release.
                     42:     #
                     43:     # - The -r option prevents removing of empty menu entries and lines which
                     44:     #   makes things much more readable.
                     45:     #
                     46:     # - To prevent any other app from overwriting your menu
                     47:     #   you can change the menu name in .fluxbox/init to:
                     48:     #     session.menuFile: /home/you/.fluxbox/my-menu
                     49:     [begin] (TMT Fluxbox-0.9.10)
                     50:          [exec] (konqueror) {konqueror}
                     51:          [exec] (mozilla) {mozilla}
                     52:          [exec] (Open Office) {soffice}
                     53:          [exec] (Kword) {kword}
                     54:          [exec] (Kspread) {kspread}
                     55:          [exec] (kwrite) {kwrite}
                     56:          [exec] (Calculator) {kcalc}
                     57:          [exec] (vmware) {vmware}
                     58:          [exec] (mc) {xterm -e mc}
                     59:          [exec] (notes) {knotes}
                     60:          [exec] (Work time) {karm}
                     61:          [exec] (Organizer) {korganizer}
                     62:          [separator]
                     63:     [submenu] (CD, Floppy)
                     64:          [exec] (My-Files) {konqueror /mnt}
                     65:          [separator]
                     66:          [exec] (Mount-CD) {mount_cd9660 /dev/cd0a /mnt/cdrom}
                     67:          [exec] (UNmount-CD) {cd ~ && umount -f /dev/cd0a}
                     68:          [exec] (xcdroast) {xcdroast}
                     69:          [separator]
                     70:          [exec] (Mount-Floppy) {mount_msdos /dev/fd0a /mnt/floppy}
                     71:          [exec] (UNmount-Floppy) {cd ~ && umount -f /dev/fd0a}
                     72:          [exec] (format floppy) {kfloppy}
                     73:     [end]
                     74:     [submenu] (Internet)
                     75:          [exec] (netscape) {netscape}
                     76:          [exec] (HTML editor) {quanta}
                     77:          [exec] (Dictionary) {kdict}
                     78:          [exec] (Kmail) {kmail}
                     79:          [exec] (Kmail-korn) {korn}
                     80:          [exec] (Instant-messanger) {kopete}
                     81:          [exec] (KPPP) {kppp}
                     82:          [exec] (KPPP logview) {kppplogview}
                     83:     [end]
                     84:     [submenu] (Education)
                     85:          [exec] (Type tutor) {ktouch}
                     86:          [exec] (Mendileev) {kalzium}
                     87:          [exec] (Planetarium) {kstars}
                     88:     [end]
                     89:     [submenu] (Graphics)
                     90:          [exec] (Quikshow) {kuickshow}
                     91:          [exec] (Kview) {kview}
                     92:          [exec] (PDF) {kpdf}
                     93:          [exec] (GhostView-pdf) {kghostview}
                     94:          [exec] (FAX) {kdeprintfax}
                     95:          [exec] (Faxview) {kfax}
                     96:          [exec] (Scaner) {kooka}
                     97:          [exec] (Snap shot) {ksnapshot}
                     98:          [exec] (Icon editor) {kiconedit}
                     99:          [exec] (gimp) {gimp}
                    100:          [exec] (Paint) {kolourpaint}
                    101:          [exec] (ColorEdit) {kcoloredit}
                    102:          [exec] (ColorPiker) {kcolorchooser}
                    103:          [exec] (Rooler) {kruler}
                    104:     [end]
                    105:     [submenu] (Multimedia)
                    106:          [exec] (Audio mixer) {kmix}
                    107:          [exec] (Recorder) {krec}
                    108:          [exec] (Player kboodle) {kaboodle}
                    109:          [exec] (Player noatun) {noatun}
                    110:          [exec] (Player juk) {juk}
                    111:          [exec] (CD Player kscd) {kscd}
                    112:          [exec] (CD Ripper) {kaudiocreator}
                    113:          [separator]
                    114:          [exec] (DVI) {kviewshell dvi}
                    115:     [end]
                    116:     [submenu] (Games)
                    117:          [exec] (Pokker) {kpoker}
                    118:          [exec] (Passiance) {kpat}
                    119:          [exec] (Shi-sen-seo) {kshisen}
                    120:          [exec] (Mahjong) {kmahjongg}
                    121:          [exec] (Reversi) {kreversi}
                    122:          [exec] (Sokoban) {ksokoban}
                    123:          [exec] (Atomic) {katomic}
                    124:          [exec] (Backgammon) {kbackgammon}
                    125:          [exec] (Mineswiper) {kmines}
                    126:          [exec] (Sea battle) {kbattleship}
                    127:          [exec] (Color lines) {klines}
                    128:          [exec] (Potato boy) {ktuberling}
                    129:     [end]
                    130:     [submenu] (System)
                    131:          [exec] (Archivator ark) {ark}
                    132:          [exec] (X-terminal) {xterm}
                    133:          [exec] (K-konsole) {konsole}
                    134:          [exec] (Run ...) {fbrun }
                    135:          [exec] (vi) {xterm -e vi}
                    136:          [exec] (Emacs) {emacs}
                    137:          [exec] (Kate) {kate}
                    138:          [exec] (Wallet) {kwalletmanager}
                    139:          [exec] (Find file) {kfind}
                    140:          [exec] (Disk info) {kdf}
                    141:          [exec] (System monitor) {ksysguard}
                    142:          [exec] (K-Cron) {kcron}
                    143:          [exec] (Hex-edit) {khexedit}
                    144:     [end]
                    145:          [separator]
                    146:          [exec] (reboot) {exec reboot}
                    147:          [exec] (POWER-OFF) {exec poweroff}
                    148:     [end]
                    149:     
                    150: 
                    151: And general configuration appearance file _/root/.fluxbox/init_ also can be created with following contents: 
                    152:     
                    153:     session.screen0.toolbar.maxOver:        false
                    154:     session.screen0.toolbar.tools:  workspacename, prevworkspace, nextworkspace,  iconbar, systemtray, prevwindow, nextwindow, clock
                    155:     session.screen0.toolbar.placement:      BottomCenter
                    156:     session.screen0.toolbar.layer:  Desktop
                    157:     session.screen0.toolbar.visible:        true
                    158:     session.screen0.toolbar.height: 0
                    159:     session.screen0.toolbar.autoHide:       false
                    160:     session.screen0.toolbar.onTop:  False
                    161:     session.screen0.toolbar.widthPercent:   66
                    162:     session.screen0.toolbar.onhead: 0
                    163:     session.screen0.overlay.lineWidth:      1
                    164:     session.screen0.overlay.lineStyle:      LineSolid
                    165:     session.screen0.overlay.joinStyle:      JoinMiter
                    166:     session.screen0.overlay.capStyle:       CapNotLast
                    167:     session.screen0.iconbar.mode:   Workspace
                    168:     session.screen0.iconbar.alignment:      Relative
                    169:     session.screen0.iconbar.iconWidth:      70
                    170:     session.screen0.iconbar.usePixmap:      true
                    171:     session.screen0.tab.rotatevertical:     True
                    172:     session.screen0.tab.placement:  Top
                    173:     session.screen0.tab.height:     16
                    174:     session.screen0.tab.width:      64
                    175:     session.screen0.tab.alignment:  Left
                    176:     session.screen0.slit.direction: Vertical
                    177:     session.screen0.slit.maxOver:   false
                    178:     session.screen0.slit.autoHide:  false
                    179:     session.screen0.slit.placement: BottomRight
                    180:     session.screen0.slit.layer:     Dock
                    181:     session.screen0.slit.onTop:     False
                    182:     session.screen0.slit.onhead:    0
                    183:     session.screen0.slit.alpha:     255
                    184:     session.screen0.focusNewWindows:        true
                    185:     session.screen0.menuDelay:      0
                    186:     session.screen0.menuDelayClose: 0
                    187:     session.screen0.focusModel:     ClickToFocus
                    188:     session.screen0.opaqueMove:     false
                    189:     session.screen0.workspacewarping:       true
                    190:     session.screen0.menuAlpha:      255
                    191:     session.screen0.rowPlacementDirection:  LeftToRight
                    192:     session.screen0.imageDither:    false
                    193:     session.screen0.windowMenu:
                    194:     session.screen0.fullMaximization:       false
                    195:     session.screen0.resizeMode:
                    196:     session.screen0.focusLastWindow:        true
                    197:     session.screen0.workspaces:     4
                    198:     session.screen0.strftimeFormat: %l:%M
                    199:     session.screen0.decorateTransient:      false
                    200:     session.screen0.menuMode:       Delay
                    201:     session.screen0.clickRaises:    true
                    202:     session.screen0.autoRaise:      false
                    203:     session.screen0.desktopwheeling:        true
                    204:     session.screen0.antialias:      false
                    205:     session.screen0.sloppywindowgrouping:   true
                    206:     session.screen0.colPlacementDirection:  TopToBottom
                    207:     session.screen0.showwindowposition:     true
                    208:     session.screen0.edgeSnapThreshold:      0
                    209:     session.screen0.workspaceNames: one,two,three,four,
                    210:     session.screen0.rootCommand:
                    211:     session.screen0.windowPlacement:        RowSmartPlacement
                    212:     session.titlebar.left:  Stick
                    213:     session.titlebar.right: Minimize Maximize Close
                    214:     session.styleFile:      /home/tnt/.fluxbox/styles/TNT
                    215:     session.cacheLife:      5l
                    216:     session.colorsPerChannel:       4
                    217:     session.opaqueMove:     False
                    218:     session.updateDelayTime:        0
                    219:     session.cacheMax:       200l
                    220:     session.imageDither:    True
                    221:     session.groupFile:
                    222:     session.menuFile:       ~/.fluxbox/menu
                    223:     session.ignoreBorder:   false
                    224:     session.useMod1:        true
                    225:     session.keyFile:        ~/.fluxbox/keys
                    226:     session.autoRaiseDelay: 250
                    227:     session.numLayers:      13
                    228:     session.doubleClickInterval:    250
                    229:     session.tabs:   true
                    230:     session.tabsAttachArea: Window
                    231:     session.iconbar:        true
                    232:     session.slitlistFile:
                    233:     session.configVersion:  1
                    234:     
                    235: 
                    236: #  Additional features 
                    237: 
                    238:   * You can add kxkb language keyboard layout switching, by inserting into _/home/YourUser/.xinit_ file additional line. It would looks like this: 
                    239:     
                    240:     kxkb &
                    241:     exec fluxbox
                    242:     
                    243: 
                    244:   * To setup desired background, you have to install image viewer first, for an example: 
                    245: <pre><code>    
                    246: # cd /usr/pkgsrc/graphics/feh
                    247: # make install
                    248: </code></pre>    
                    249: 
                    250: Your background file should be of *.png or *.jpg format. It has to be downloaded into _/home/YourUser/.fluxbox/backgrounds/_ directory. 
                    251: 
                    252: Further you have to insert following line into _/home/YourUser/.fluxbox/init_ file: 
                    253:     
                    254:     session.screen0.rootCommand:   fbsetbg -f /home/tnt/.fluxbox/backgrounds/TN0uLb.jpg        
                    255:     
                    256: 
                    257: where _TN0uLb.jpg_ is your wallpaper file. 
                    258: 
                    259: #  See also 
                    260: 
                    261: Official Fluxbox web site: [fluxbox](http://fluxbox.sourceforge.net/)
                    262: 

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb