Jump to content

WM/DE-05: Fluxbox

Recommended Posts

Browse: [About the FAQ Forum] [Table of Contents] [FAQs] [Contribute] [WM/DE: Window Managers and Desktop Environments]


WM/DE-05: Fluxbox


Original html version, for those who are interested. This board one is the same thing cept it went through find and replace for formatting.



Unofficial Fluxbox FAQ

Making Fluxbox easy



This FAQ applies to the current development series of Fluxbox, it was written using 0.9.10. If you dont have the developmental series you will find that many answers here will not help you. To find out what version of fluxbox you have, open a command line and write:

fluxbox -version



This is the current "stable" version of fluxbox. It is no longer maintained. This is now out of date, it was released in late 2002, and I recommend you update to the latest in the 0.9.x (0.9.9 at writing) series.




This is the current development series of fluxbox. This is much much more feature rich than the older 0.1.14 series and is what I cover throughout this FAQ. It has newer features such as, transparency, pixmap themes, extra theme options as well as many many new additions to functionality, and speed. The 0.9.x series in my opinion, and in my experience, is more stable than the venerable 0.1.14 release. This is currently not considered the official stable release as it lacks in some documentation, translations, still has a handful of bugs to squash and new features to add.


How do I set my wallpaper?


To set wallpapers in fluxbox, you need to use a special tool. Open up the command-line and type


fbsetbg /path/to/wallpaper.jpg


fbsetbg doesnt set the wallaper itself, it uses other programs to set it for you. The purpose of fbsetbg, is to pick the most appropriate program available to set the wallpaper. Not all wallpaper setters support transparency, so fbsetbg picks ones that support transparency over others. If you find that transparency is not working, do a fbsetbg -i and it will tell you if the wallpaper setter you have available doesnt support transparency.


Replace "/path/to/wallpaper.jpg" with the location of the image you want to set as the background. fbsetbg has an array of options, and they are passed:


fbsetbg -fctial /path/to/wallpaper.jpg


The main options you can pass to fbsetbg are below, you only need to pass one:

-f - Set fullscreen wallpaper

-c - Set centered wallpaper

-t - Set tiled wallpaper

-a - Set wallpaper maximised with preserved aspect.

-i - Tell the user the program it is using to set the wallpaper and any pitfalls it might have.

-l - Set last wallpaper

Other options can be found by reading:


man fbsetbg


How do I make fluxbox remember my wallpaper?


To make fluxbox remember your wallpaper, open up "~/.fluxbox/init" and find the line:




And replace it with


session.screen0.rootCommand:    fbsetbg -l  


This will make fluxbox remember your wallpaper by having fbsetbg set the last wallpaper.



How do I make the menu or slit transparent?


One of the touted features of fluxbox is it's transparency abilities. They are not too complicated to change and can make some very cool eyecandy


You can change the level of transparency in the menu, or the menu alpha by right clicking to bring up the fluxbox menu then


Fluxbox menu > Fluxbox > Configure > Menu Alpha


The slit transparency can be found by right clicking the slit or by looking in


Fluxbox menu > Fluxbox > Configure > Slit > Alpha


You can click on the value there to adust it. "0" is fully transparent, "255" is solid. Values in between have varying levels of transparency.


If you find that the menu's transparency does not take effect immediately, try restarting fluxbox.


If restarting fluxbox doesn't fix your problem and you set the transparency to "0", try setting it to "1" and restarting fluxbox. There was a bug in some development versions of fluxbox that made the setting of "0", act like "255".

How do I make the toolbar and windows transparent?


To change the transparency levels of the toolbar, window borders or the slit, you will need to modify your theme. This will change the appearance of the theme and may not be something you wish to do.


First, open the theme's configuration file with your favourite text editor.


This will usually be at




Or if it was made using the older format:




Find these lines and adjust the numeric values to your liking.

toolbar.alpha: 100

window.alpha: 255

Save the theme and then restart fluxbox from your fluxbox menu




Where can I get styles?

Themes, or styles as they are known for fluxbox can be found all over the internet, a good search on Google will turn up a lot of links. Here are some good sites.

Not to long ago there used to be a popular site called fluxmod, it was the home of fluxbox theming and held some of the best pixmap themes around. Unfortnately because of technical problems, it was shut down. You can get a tarball (tar.gz) of all the themes from:




How can I change my fluxbox style?

You can change styles in fluxbox by going into

Fluxbox menu > Fluxbox > Styles


Then selecting whichever one takes your fancy


How do I install a style?

Themes for fluxbox can be distributed and installed in many different ways. The most common way of distributing a fluxbox theme is inside a .tar.gz or .tar.bz2.


For most themes, it is fine to just, download the theme to your /home/username directory and then extract it.


You extract tar.gz with:


tar -zxvf theme.tar.gz


And tar.bz2 with


tar -jxvf theme.tar.bz2


The style should appear in the menu. If the style does not appear in your menu, take a look in your /home/username directory. If you see a folder called styles or pixmaps then your theme takes an extra step to install.

cd ~/.fluxbox/

tar -zxvf ../theme.tar.gz


tar -jxvf ../theme.tar.bz2

The style should be in your menu now. If it isn't, as a last ditch effort, restart fluxbox.


How do I make a theme?


If you are interested in creating themes for fluxbox, it is very easy. Grab your favourite text editor, hack some existing theme's file or head over to asenchi's tutorial:

To view it in man format

man fluxstyle


or online here: http://aslan.no-ip.com/~iphitus/misc/themes.html


How do I bind keyboard shortcuts?

To setup keyboard shortcuts, you can use one of the following solutions

The fluxbox man page covers the manual way excellently

You  can  customise  Fluxbox'  key handling through the ~/.fluxbox/keys file.  The file takes the format of :

<modifier> <key> [...] :<operation>


In the example below, Mod1 is the 'Alt' key on the PC keyboard and Mod4 is one of the three extra keys on a pc104 branded with a sickening corporate logo.

# Fluxbox keys file.
# Any line starting with a # is a comment.
Mod1 Tab :NextWindow
Mod1 F1 :Workspace 1
Mod1 F2 :Workspace 2
Mod1 F3 :Workspace 3
Mod1 F4 :Workspace 4
Mod1 F5 :Workspace 5
Mod1 F6 :Workspace 6
Mod1 F7 :Workspace 7
Mod1 F8 :Workspace 8
Mod1 F9 :Workspace 9
Mod4 b :PrevWorkspace
Mod4 c :Minimize
Mod4 r :ExecCommand rxvt
Mod4 v :NextWorkspace
Mod4 x :Close
Mod4 m :RootMenu
Control n Mod1 n :NextTab
None Print :ExecCommand import -window root '%Y-%m-%d_$wx$h.png'; xmessage 'snapshot done'

As you can see from the last line, keybinds can be chained in a fashion similar to emacs keybindings.

Commands  are  caseinsensitive, workspace numbering starts at "1", some commands have synonyms.

To get a list of all the available commands, look in the man page. You can access the man page though the command line by typing:

man fluxbox


The man page is also available online.


How do I change my fluxbox menu?

There are two ways of changing your fluxbox menu, they are:

The fluxbox manual has an extensive section on doing it manually, and it isnt very hard. You can access the man page though the command line by typing:

man fluxbox


The man page is also available online.




How do I get icons on my fluxbox desktop?

Check out these great tutorials by ikaro:

How can I make programs startup when fluxbox starts?

There are two methods of starting a program on startup.

  • /home/username/.fluxbox/apps
  • /home/username/.fluxbox/startup

It doesnt matter which of these two methods you use, most distros support the startup file, and the apps file is supported on every distro.




You can put commands to run whatever programs you want in here. It is a great place to put programs like your dockapps, fbdesk, idesk, gdesklets, torsmo or any other programs you like to have running. The advantage it has over the apps file is that it's a shell script, allowing you to do more.

An example of this is:


gkrellm &
aterm &


The apps file uses a different syntax to the startup file. To make a program startup, in the apps file add


[startup] {programname}


An example of this is:

[startup] {gkrellm}

[startup] {aterm}


How do I start fluxbox from the command line?


If you want to use startx to start fluxbox from the command line, or you have been dumped out to a command line without X, this is how you can start X running fluxbox.


echo exec startfluxbox > ~/.xinitrc


Then run





And X will start, running fluxbox and any programs you set to load in your startup files.


What is the slit?


The slit is a special dock in fluxbox where you can put applications called dockapps. It can be located on any side of the screen, and you can change this and many other features by right clicking it and changing them. These options are also available in the main fluxbox menu under:


Fluxbox menu > Fluxbox > Configure > Slit


Where can I get dockapps for the slit?

You can find many dockapps to put in this area, at:




How do I enable Anti-Aliased fonts?


To enable Anti-Aliased fonts, enable the following option in the Fluxbox menu:


Fluxbox menu > Fluxbox > Configure > Anti-Aliasing


What are fluxbox tabs and how do I use them?


Fluxbox is able to tab windows, just like tabbed browsing in Mozilla browsers. This can be a great way of saving space, organising windows, and its a great feature to show off to your GNOME or KDE friends. These tabs are integrated into the titlebar of a program and are very easy to work with.


To tab one program with another, use your middle mouse button (left and right mouse buttons together if you dont have one) on the titlebar and drag it onto the window you want to have the program tabbed with. It should automatically tab them together and you can choose either one by clicking on it as you would in Mozilla. To untab a program, middle click it's title and drag it away, making sure it is not over any other windows.


How do I make windows borderless?




To set a program to be borderless temporarily, add this line to your /home/username/.fluxbox/keys:


mod1 t :toggledecor


Then using the main fluxbox menu, reload the configuration.


Once you have done that, select the program you want to have temporary borderlessness and type:






If you dont already have one, you will need to create a /home/username/.fluxbox/apps and then add the following lines to it:

[app] (aterm)

[Deco] {NONE}



Replace aterm, with the program you wish to make borderless, then restart fluxbox from its menu.


What do I do if I am having layering problems in Xorg 6.8

If you are having layer problems in fluxbox, where windows aren't raising and lowering as you would like, fix it by changing the following.

Right click slit > Layer > Desktop



When will Fluxbox reach 1.0?

When it needs to. At the moment there is still some work to be done.

Link to comment
Share on other sites


  • Create New...