File:  [NetBSD Developer Wiki] / wikisrc / fluxbox.mdwn
Revision 1.1: download - view: text, annotated - select for diffs
Mon Nov 21 03:22:58 2011 UTC (2 years, 5 months ago) by mspo
Branches: MAIN
CVS tags: HEAD
finish importing the pages from my findings in the pkgsrc.se wiki

Fluxbox is yet another windowmanager for X. 

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

#  Install Fluxbox 

To install fluxbox use its package provided in pkgsrc [wm/fluxbox](ftp://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/wm/fluxbox/README.html): 
    

    # cd /usr/pkgsrc/wm/fluxbox
    # make install
    

When installation is finished, define fluxbox by creating _.xinit_ file in user home directory: 
    
    # cd /root
    # vi .xinitrc
    

The typical contents of this file is: 
    
    exec fluxbox
    

To make further tunes per your needs, you can create fluxbox directory and place into it your configuration files. 
    
    # mkdir /home/myuser/.fluxbox
    
    

Tipical configuration is _/root/.fluxbox/menu_ file, with following contents: 
    
    # Generated by fluxbox-generate_menu
    #
    # If you read this it means you want to edit this file manually, so here
    # are some useful tips:
    #
    # - You can add your own menu-entries to ~/.fluxbox/usermenu
    #
    # - If you miss apps please let me know and I will add them for the next
    #   release.
    #
    # - The -r option prevents removing of empty menu entries and lines which
    #   makes things much more readable.
    #
    # - To prevent any other app from overwriting your menu
    #   you can change the menu name in .fluxbox/init to:
    #     session.menuFile: /home/you/.fluxbox/my-menu
    [begin] (TMT Fluxbox-0.9.10)
         [exec] (konqueror) {konqueror}
         [exec] (mozilla) {mozilla}
         [exec] (Open Office) {soffice}
         [exec] (Kword) {kword}
         [exec] (Kspread) {kspread}
         [exec] (kwrite) {kwrite}
         [exec] (Calculator) {kcalc}
         [exec] (vmware) {vmware}
         [exec] (mc) {xterm -e mc}
         [exec] (notes) {knotes}
         [exec] (Work time) {karm}
         [exec] (Organizer) {korganizer}
         [separator]
    [submenu] (CD, Floppy)
         [exec] (My-Files) {konqueror /mnt}
         [separator]
         [exec] (Mount-CD) {mount_cd9660 /dev/cd0a /mnt/cdrom}
         [exec] (UNmount-CD) {cd ~ && umount -f /dev/cd0a}
         [exec] (xcdroast) {xcdroast}
         [separator]
         [exec] (Mount-Floppy) {mount_msdos /dev/fd0a /mnt/floppy}
         [exec] (UNmount-Floppy) {cd ~ && umount -f /dev/fd0a}
         [exec] (format floppy) {kfloppy}
    [end]
    [submenu] (Internet)
         [exec] (netscape) {netscape}
         [exec] (HTML editor) {quanta}
         [exec] (Dictionary) {kdict}
         [exec] (Kmail) {kmail}
         [exec] (Kmail-korn) {korn}
         [exec] (Instant-messanger) {kopete}
         [exec] (KPPP) {kppp}
         [exec] (KPPP logview) {kppplogview}
    [end]
    [submenu] (Education)
         [exec] (Type tutor) {ktouch}
         [exec] (Mendileev) {kalzium}
         [exec] (Planetarium) {kstars}
    [end]
    [submenu] (Graphics)
         [exec] (Quikshow) {kuickshow}
         [exec] (Kview) {kview}
         [exec] (PDF) {kpdf}
         [exec] (GhostView-pdf) {kghostview}
         [exec] (FAX) {kdeprintfax}
         [exec] (Faxview) {kfax}
         [exec] (Scaner) {kooka}
         [exec] (Snap shot) {ksnapshot}
         [exec] (Icon editor) {kiconedit}
         [exec] (gimp) {gimp}
         [exec] (Paint) {kolourpaint}
         [exec] (ColorEdit) {kcoloredit}
         [exec] (ColorPiker) {kcolorchooser}
         [exec] (Rooler) {kruler}
    [end]
    [submenu] (Multimedia)
         [exec] (Audio mixer) {kmix}
         [exec] (Recorder) {krec}
         [exec] (Player kboodle) {kaboodle}
         [exec] (Player noatun) {noatun}
         [exec] (Player juk) {juk}
         [exec] (CD Player kscd) {kscd}
         [exec] (CD Ripper) {kaudiocreator}
         [separator]
         [exec] (DVI) {kviewshell dvi}
    [end]
    [submenu] (Games)
         [exec] (Pokker) {kpoker}
         [exec] (Passiance) {kpat}
         [exec] (Shi-sen-seo) {kshisen}
         [exec] (Mahjong) {kmahjongg}
         [exec] (Reversi) {kreversi}
         [exec] (Sokoban) {ksokoban}
         [exec] (Atomic) {katomic}
         [exec] (Backgammon) {kbackgammon}
         [exec] (Mineswiper) {kmines}
         [exec] (Sea battle) {kbattleship}
         [exec] (Color lines) {klines}
         [exec] (Potato boy) {ktuberling}
    [end]
    [submenu] (System)
         [exec] (Archivator ark) {ark}
         [exec] (X-terminal) {xterm}
         [exec] (K-konsole) {konsole}
         [exec] (Run ...) {fbrun }
         [exec] (vi) {xterm -e vi}
         [exec] (Emacs) {emacs}
         [exec] (Kate) {kate}
         [exec] (Wallet) {kwalletmanager}
         [exec] (Find file) {kfind}
         [exec] (Disk info) {kdf}
         [exec] (System monitor) {ksysguard}
         [exec] (K-Cron) {kcron}
         [exec] (Hex-edit) {khexedit}
    [end]
         [separator]
         [exec] (reboot) {exec reboot}
         [exec] (POWER-OFF) {exec poweroff}
    [end]
    

And general configuration appearance file _/root/.fluxbox/init_ also can be created with following contents: 
    
    session.screen0.toolbar.maxOver:        false
    session.screen0.toolbar.tools:  workspacename, prevworkspace, nextworkspace,  iconbar, systemtray, prevwindow, nextwindow, clock
    session.screen0.toolbar.placement:      BottomCenter
    session.screen0.toolbar.layer:  Desktop
    session.screen0.toolbar.visible:        true
    session.screen0.toolbar.height: 0
    session.screen0.toolbar.autoHide:       false
    session.screen0.toolbar.onTop:  False
    session.screen0.toolbar.widthPercent:   66
    session.screen0.toolbar.onhead: 0
    session.screen0.overlay.lineWidth:      1
    session.screen0.overlay.lineStyle:      LineSolid
    session.screen0.overlay.joinStyle:      JoinMiter
    session.screen0.overlay.capStyle:       CapNotLast
    session.screen0.iconbar.mode:   Workspace
    session.screen0.iconbar.alignment:      Relative
    session.screen0.iconbar.iconWidth:      70
    session.screen0.iconbar.usePixmap:      true
    session.screen0.tab.rotatevertical:     True
    session.screen0.tab.placement:  Top
    session.screen0.tab.height:     16
    session.screen0.tab.width:      64
    session.screen0.tab.alignment:  Left
    session.screen0.slit.direction: Vertical
    session.screen0.slit.maxOver:   false
    session.screen0.slit.autoHide:  false
    session.screen0.slit.placement: BottomRight
    session.screen0.slit.layer:     Dock
    session.screen0.slit.onTop:     False
    session.screen0.slit.onhead:    0
    session.screen0.slit.alpha:     255
    session.screen0.focusNewWindows:        true
    session.screen0.menuDelay:      0
    session.screen0.menuDelayClose: 0
    session.screen0.focusModel:     ClickToFocus
    session.screen0.opaqueMove:     false
    session.screen0.workspacewarping:       true
    session.screen0.menuAlpha:      255
    session.screen0.rowPlacementDirection:  LeftToRight
    session.screen0.imageDither:    false
    session.screen0.windowMenu:
    session.screen0.fullMaximization:       false
    session.screen0.resizeMode:
    session.screen0.focusLastWindow:        true
    session.screen0.workspaces:     4
    session.screen0.strftimeFormat: %l:%M
    session.screen0.decorateTransient:      false
    session.screen0.menuMode:       Delay
    session.screen0.clickRaises:    true
    session.screen0.autoRaise:      false
    session.screen0.desktopwheeling:        true
    session.screen0.antialias:      false
    session.screen0.sloppywindowgrouping:   true
    session.screen0.colPlacementDirection:  TopToBottom
    session.screen0.showwindowposition:     true
    session.screen0.edgeSnapThreshold:      0
    session.screen0.workspaceNames: one,two,three,four,
    session.screen0.rootCommand:
    session.screen0.windowPlacement:        RowSmartPlacement
    session.titlebar.left:  Stick
    session.titlebar.right: Minimize Maximize Close
    session.styleFile:      /home/tnt/.fluxbox/styles/TNT
    session.cacheLife:      5l
    session.colorsPerChannel:       4
    session.opaqueMove:     False
    session.updateDelayTime:        0
    session.cacheMax:       200l
    session.imageDither:    True
    session.groupFile:
    session.menuFile:       ~/.fluxbox/menu
    session.ignoreBorder:   false
    session.useMod1:        true
    session.keyFile:        ~/.fluxbox/keys
    session.autoRaiseDelay: 250
    session.numLayers:      13
    session.doubleClickInterval:    250
    session.tabs:   true
    session.tabsAttachArea: Window
    session.iconbar:        true
    session.slitlistFile:
    session.configVersion:  1
    

#  Additional features 

  * You can add kxkb language keyboard layout switching, by inserting into _/home/YourUser/.xinit_ file additional line. It would looks like this: 
    
    kxkb &
    exec fluxbox
    

  * To setup desired background, you have to install image viewer first, for an example: 
<pre><code>    
# cd /usr/pkgsrc/graphics/feh
# make install
</code></pre>    

Your background file should be of *.png or *.jpg format. It has to be downloaded into _/home/YourUser/.fluxbox/backgrounds/_ directory. 

Further you have to insert following line into _/home/YourUser/.fluxbox/init_ file: 
    
    session.screen0.rootCommand:   fbsetbg -f /home/tnt/.fluxbox/backgrounds/TN0uLb.jpg	
    

where _TN0uLb.jpg_ is your wallpaper file. 

#  See also 

Official Fluxbox web site: [fluxbox](http://fluxbox.sourceforge.net/)


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