Return to fluxbox.mdwn CVS log

Up to [NetBSD Developer Wiki] / wikisrc / tutorials / x11

Update for README.html transition

    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: 
    7: To install fluxbox use its package provided in pkgsrc [wm/fluxbox](//cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/wm/fluxbox/): 
    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: