Flaxx

I. Presentation

Flaxx is a full featured Fluxbox configuration dedicated to Slackware.

II. Requirements

in order to work properly, flaxx requires the following softwares.

Software	Description
Fluxbox ¹	The Fluxbox Window Manager.
xdgmenumaker	Generates the menu of installed applications.
wmpamgen	Generates the menu of preferred applications.
dtfilemon	Updates the applications menus while running Fluxbox, when needed.
wmhelper	A multi-purpose tool dedicated to window managers like fluxbox.
wmsvmgen	Allows to access storage volumes from a simple menu.
zenity	Allows to display Gtk+ dialog boxes from shell scripts.

Comes as part of Slackware. Note that support of image formats other than XPM (in menus for instance) requires to rebuild Fluxbox with imlib2.
Prebuilt packages of these softwares can be downloaded here.

III. Package installation

To install flaxx, download the latest package revision available here, then, as root, run the command below (replace the tags VERSION and BUILD accordingly) :

$ upgradepkg --install-new flaxx-<VERSION>-noarch-<BUILD>.tgz

To build the package flaxx by hand, download the latest source archive available here, then, run the following commands :

$ tar xf /path/to/flaxx-source-<VERSION>.tar.gz
$ su
$ cd flaxx-<VERSION>
$ ./flaxx.SlackBuild
...

IV. Installing the configuration Flaxx

Once package flaxx is installed, any user can, at any time, (re)install the provided Fluxbox configuration by running the installer flaxx-install, as below :

$ flaxx-install --config /usr/share/flaxx/install.conf

The configuration file /usr/share/flaxx/install.conf provides the (default) installation settings for the configuration flaxx.
To prevent overwrite of existing Fluxbox configuration, the installer flaxx-install makes a backup of ~/.fluxbox directory in ~/.fluxbox.bak_<date>, where <date> is the current date and time returned by the following command :
$ date +%y%m%d_%H%M%S
Backup of user’s Fluxbox directory can be disabled by passing option --no-backup to flaxx-install :
$ flaxx-install --no-backup
type man flaxx-install for more about this installer and the installation settings.

V. Directories and files: Overview

After install of the configuration flaxx, the user’s Fluxbox directory (ie. ~/.fluxbox) should contain the following file and folders.

apps

The per-application configuration file for Fluxbox.
appsmenus-gen

Wrapper script to (re)generate the menus of installed and preferred applications.

Config

:

conf.d/appsmenus-gen.conf
conf.d/

The configuration files directory.
fb-startup-man

A GUI to select, from a checklist in a zenity dialog-box, the modules that must be loaded and executed by Fluxbox startup script.

Config

:

conf.d/fb-startup-man.conf
fbsetbg-gui

A GUI frontend for fbsetbg which allows to select the Fluxbox wallpaper from a file-selection dialog.

Config

:

conf.d/fbsetbg-gui.conf
fluxbox-info

Display Fluxbox informations in a dialog-box.
pref-apps-man

A GUI to choose, from the list of installed applications, which ones must be accessible from the menu of preferred applications.

Config

:

conf.d/pref-apps-man.conf
init

The Fluxbox resources file in which user defaults are stored.
keys

The Fluxbox keyboard shortcuts configuration file.
log.d/

Log files directory.
menus.d/

The Fluxbox menus directory.
overlay

The Fluxbox style overlay file which allows to override some elements of selected style.
startup

The Fluxbox startup script.

Config

:

conf.d/startup.conf

As opposed to the original Fluxbox startup script, user does not have to modify this script to start programs, but only needs to enable the required startup-module(s).
startup.d/

The startup modules directory.
styles/

The Fluxbox user’s styles directory.
tmp.d/

Temporary files directory.

VI. Startup modules

A startup module is a simple bash script which is dynamically loaded by Fluxbox startup script, ie. ~/.fluxbox/startup, to execute action(s) before or after starting Fluxbox.

Only executable modules are loaded (and executed), and always according to the alphabetical order.
The modules to load before starting Fluxbox are called pre-startup modules and located in ~/.fluxbox/startup.d.
The modules to load after starting Fluxbox are called post-startup modules and located in ~/.fluxbox/startup.d/post.
When a pre-startup module is moved in ~/.fluxbox/startup.d/post, it become a post-startup module, and vice-versa when it is placed back in ~/.fluxbox/startup.d.

The modules configuration files are stored in ~/.fluxbox/conf.d

1. Startup modules selection

The selection of startup-modules to execute can be done at any time, in one of the following ways :

From the command line, by setting the executable bit of startup-modules accordingly, like in example below :
$ cd ~/.fluxbox/startup.d $ chmod +x 020-numlock.sh 090-compton.sh $ chmod +x 999-mozilla-firefox.sh
With the GUI fb-startup-man, which looks like this:

Note that, in both case, it is required to relog for the changes to take effect.

2. The included startup-modules

A. The pre-startup modules

1. 010-load-res.sh

Loads user’s Xmodmap and Xresources, when present.

`Config`	:	`conf.d/load-res.module.conf`
`Requires`	:	-
`Def. State`	:	disabled

Notes:

User’s resources are usually loaded by user’s .xinitrc or the display manager and thus, it is recommended to enable this module only if required.

2. 020-numlock.sh

Turn on NumLock at startup.

`Config`	:	-
`Requires`	:	numlockx (slackbuild: 14.2)
`Def. State`	:	disabled

3. 030-apps-menus.sh

Regenerates applications-menus and starts service to update them during Fluxbox session, when required.

`Config`	:	`conf.d/apps-menus.module.conf`
`Requires`	:	appsmenus-gen, dtfilemon, wmpamgen, xdgmenumaker ( slackbuild for 14.2)
`Def. State`	:	enabled

4. 040-stovol-menu.sh

Starts wmsvmgen service to access storage volumes under Fluxbox through a menu.

`Config`	:	`conf.d/stovol-menu.module.conf`
`Requires`	:	wmsvmgen
`Def. State`	:	enabled

5. 050-dbus.sh

Starts DBUS session bus, when required.

`Config`	:	-
`Requires`	:	dbus (comes as part of Slackware)
`Def. State`	:	enabled

Notes:

It is highly recommended to enable this module, unless if dbus is started by any other means (.xinitrc).

6. 060-dunst.sh

Starts dunst notification-daemon.

`Config`	:	`conf.d/dunst.module.conf`
`Requires`	:	dunst (slackbuild: 14.2)
`Def. State`	:	disabled

DBUS automatically start a notification daemon when required.
When more than one notification daemon are installed (ex. dunst, xfce4-notifyd), there is no way to force dunst to be started first by DBUS.

Therefore, users who want dunst as default notification-daemon, must enable this module.

7. 070-pulseaudio.sh

Starts PulseAudio.

`Config`	:	`conf.d/pulseaudio.module.conf`
`Requires`	:	PulseAudio (comes as part of Slackware)
`Def. State`	:	enabled

8. 080-vboxclient.sh

Starts VirtualBox Guest Addition X11 Client.

`Config`	:	`conf.d/vboxclient.module.conf`
`Requires`	:	virtualbox
`Def. State`	:	disabled

9. 090-compton.sh

Starts the compositor compton.

`Config`	:	`conf.d/compton.module.conf`
`Requires`	:	compton (slackbuild: 14.2)
`Def. State`	:	disabled

It is highly recommended to install the image viewer feh before enabling this module.

Indeed, compton is not compatible with all image viewers, which can lead to issues (ex: the background wallpaper is not displayed properly and a bunch of error messages are logged in ~/.fluxbox/log.d/compton.log)

10. 095-default-background.sh

Sets Fluxbox wallpaper to default when none is defined for the current X server.

`Config`	:	`conf.d/default-background.module.conf`
`Requires`	:	-
`Def. State`	:	enabled

This module assumes there’s no wallpaper for the current X server when there is no entry in ~/.fluxbox/lastwallpaper related to ${DISPLAY}.

11. 100-dockapps.sh

Places preferred dockapps in the slit.

`Config`	:	`conf.d/dockapps.module.conf`
`Requires`	:	-
`Def. State`	:	disabled

The dockapps to start are specified through variable __DOCKAPPS defined in configuration file conf.d/dockapps.module.conf.
By default, __DOCKAPPS includes 4 entries of type wmalauncher (slackbuild: 14.2) which are respectively configured to start firefox, thunderbird, xterm and htop

B. The post-startup modules

1. 010-blueman-applet.sh

Starts blueman-applet, a tray applet for managing bluetooth.

`Config`	:	`conf.d/blueman-applet.module.conf`
`Requires`	:	blueman (comes as part of Slackware)
`Def. State`	:	enabled

2. 020-hplip-systray.sh

Starts the HP system tray service.

`Config`	:	`conf.d/hplip-systray.module.conf`
`Requires`	:	hplip (comes as part of Slackware)
`Def. State`	:	enabled

Attention, when hp-systray is run before starting Fluxbox, it will not be accessible from the system tray.

3. 030-nm-applet.sh

Starts nm-applet, a system-tray applet for managing network connections.

`Config`	:	`conf.d/nm-applet.module.conf`
`Requires`	:	network-manager-applet (comes as part of Slackware)
`Def. State`	:	enabled

4. 040-pasystray.sh

Starts pasystray, a system-tray applet for PulseAudio.

`Config`	:	`conf.d/pasystray.module.conf`
`Requires`	:	pasystray (slackbuild: 14.2)
`Def. State`	:	disabled

5. 050-xscreensaver.sh

Starts xscreensaver, a screensaver and locker program.

`Config`	:	`conf.d/xscreensaver.module.conf`
`Requires`	:	xscreensaver (comes as part of Slackware)
`Def. State`	:	disabled

6. 060-conky.sh

Starts conky, a light-weight system monitor for X.

`Config`	:	`conf.d/conky.module.conf`
`Requires`	:	conky (slackbuild: 14.2)
`Def. State`	:	disabled

When the compositor compton is used, conky is run with full-transparency, with pseudo-transparency otherwise.
Attention, conky > 1.9.0 does not pass clicks to the root window, which, in case of Fluxbox prevent to open the root menu with a right-click when the mouse is over conky. However, the root menu can still be opened using the additional shortcuts below :
- WinKey + space
- WinKey + RightButton

7. 060-gkrellm.sh

Starts gkrellm, a system monitor for X.

`Config`	:	`conf.d/gkrellm.module.conf`
`Requires`	:	gkrellm (comes as part of Slackware)
`Def. State`	:	disabled

8. 070-analog-clock.sh

Launches the cairo-clock or xonclock widget.

`Config`	:	`conf.d/analog-clock.module.conf`
`Requires`	:	cairo-clock (slackbuild: 14.2), xonclock (slackbuild: 14.2)
`Def. State`	:	disabled

When the compositor compton is used, this module gives precedence to cairo-clock over xonclock, when available.

9. 999-audacious.sh

Launches audacious, a media player.

`Config`	:	`conf.d/audacious.module.conf`
`Requires`	:	audacious (comes as part of Slackware)
`Def. State`	:	disabled

10. 999-chromium.sh

Launches chromium Web browser.

`Config`	:	`conf.d/chromium.module.conf`
`Requires`	:	chromium (AlienBob’s chromium packages)
`Def. State`	:	disabled

11. 999-galculator.sh

Launches galculator, a scientifc calculator.

`Config`	:	-
`Requires`	:	galculator (slackbuild: 14.2)
`Def. State`	:	disabled

12. 999-geany.sh

Launches geany, a lightweight IDE.

`Config`	:	`conf.d/geany.module.conf`
`Requires`	:	geany (slackbuild: 14.2)
`Def. State`	:	disabled

13. 999-gimp.sh

Launches gimp, The GNU Image Manipulation Program.

`Config`	:	`conf.d/gimp.module.conf`
`Requires`	:	gimp (comes as part of Slackware)
`Def. State`	:	disabled

14. 999-google-chrome.sh

Launches google-chrome Web browser.

`Config`	:	`conf.d/google-chrome.module.conf`
`Requires`	:	chrome (slackbuild: latest)
`Def. State`	:	disabled

15. 999-grsync.sh

Launches grsync, a GUI frontend for rsync.

`Config`	:	`conf.d/grsync.module.conf`
`Requires`	:	grsync (slackbuild: 14.2)
`Def. State`	:	disabled

16. 999-libreoffice-calc.sh

Launches libreoffice-calc, the spreadsheet component of the LibreOffice suite.

`Config`	:	`conf.d/libreoffice-calc.module.conf`
`Requires`	:	libreoffice (slackbuild: 14.2)
`Def. State`	:	disabled

17. 999-libreoffice-writer.sh

Launches libreoffice-writer, the word-processor component of the LibreOffice suite.

`Config`	:	`conf.d/libreoffice-writer.module.conf`
`Requires`	:	libreoffice (slackbuild: 14.2)
`Def. State`	:	disabled

18. 999-mozilla-firefox.sh

Launches Mozilla Firefox Web browser.

`Config`	:	`conf.d/mozilla-firefox.module.conf`
`Requires`	:	mozilla-firefox (comes as part of Slackware)
`Def. State`	:	disabled

19. 999-mozilla-thunderbird.sh

Launches Mozilla Thunderbird mail application.

`Config`	:	`conf.d/mozilla-thunderbird.module.conf`
`Requires`	:	mozilla-thunderbird (comes as part of Slackware)
`Def. State`	:	disabled

20. 999-mplayer.sh

Launches gmplayer, a GUI front ends for mplayer.

`Config`	:	`conf.d/mplayer.module.conf`
`Requires`	:	MPlayer (comes as part of Slackware)
`Def. State`	:	disabled

21. 999-smplayer.sh

Launches SMPlayer, a graphical front-end for MPlayer.

`Config`	:	`conf.d/smplayer.module.conf`
`Requires`	:	smplayer (slackbuild: 14.2)
`Def. State`	:	disabled

22. 999-thunar.sh

Launches Thunar, a file manager.

`Config`	:	`conf.d/thunar.module.conf`
`Requires`	:	Thunar (comes as part of Slackware)
`Def. State`	:	disabled

23. 999-uxterm.sh

Launches uxterm, an X terminal emulator for Unicode (UTF-8).

`Config`	:	`conf.d/uxterm.module.conf`
`Requires`	:	xterm (comes as part of Slackware)
`Def. State`	:	disabled

24. 999-virtualbox.sh

:Launches virtualbox, a virtualizer for x86 hardware.

`Config`	:	-
`Requires`	:	virtualbox
`Def. State`	:	disabled

25. 999-xfe.sh

Launches xfe, an MS-Explorer like file manager for X.

`Config`	:	`conf.d/xfe.module.conf`
`Requires`	:	xfe (slackbuild: 14.2)
`Def. State`	:	disabled

3. Implementing startup modules

Users who want to implementes their own startup-modules should follow the rules below :

The startup-module names should have the following syntax :
<rank>-<module-basename>.sh
rank is a 3 digits number which defines the module loading rank. This can be changed at any time to force a module to be loaded before or after (some) other module(s).
The startup-modules configuration files should be in ~/.fluxbox/conf.d and should have the following syntax:
<module-basename>.module.conf
A startup-module should start with an header including :
- a short description of the module specified using tags DESC, like in the following example :
  # DESC:This module is dedicated to run # DESC:the following actions: ...
- the name of its configuration file, if any, specified using the tag MCFG, as in example below :
  # MCFG: sample.module.conf
Any startup-module which starts a process in the background that must be stopped when Fluxbox exits, must register this process by calling register_process().
The startup-modules must do their job as quickly as possible, otherwise user might feel Fluxbox is stuck.
The startup-modules must never execute the command exit.

Notes:

The following variables and functions, defined in Fluxbox startup script, can be useful in startup modules and/or startup modules configuration files:

Variables:

FLUXBOX_DIR
Path to fluxbox user’s directory.

CONFIG_DIR
Path to the configuration directory.

MODULES_DIR
Path to the pre-startup modules directory.

POST_MODULES_DIR
Path to the post-startup modules directory.

LOG_DIR
Path to the logfiles directory.

TEMP_DIR
Path to the temporary files directory.

CMOD_NAME
Name of startup module being loaded/run, if any.

CMOD_TYPE
Type (PRE or POST) of startup module being loaded/run, if any.

FLUXBOX_PID
Fluxbox’s PID or -1 when Fluxbox has not started yet.

Functions:

is_enabled()
Checks if a double-states variable is enabled.

log_infos()
Logs a message into Fluxbox startup’s logfile.

is_fluxbox_running()
Checks if Fluxbox is (still) running.

register_process()
Registers informations about a process.

is_process_registered()
Checks if a process has been registered.

load_module_settings()
Loads settings of a given module.

VII. Menus

This configuration comes with the following menus (in menus.d/).

1. `root.menu`

This is the Fluxbox root menu. There are many ways to access this menu :

OnDesktop: RightButton
WinKey + RightButton (anywhere)
WinKey + space

Here is a screen-capture of this menu:

The application shortcuts at the top of that menu, the option Applications, and the option Run … are part of the menu apps.menu.
The option storage volumes gives access to the menu of connected storage volumes which is dynamically generated by service wmsvmgen, started by startup-module 040-stovol-menu.sh, and which looks like as below :

This menu can also be accessed through keyboard shortcut WinKey + v.

2. `apps.menu`

This menu gives access to :

The menu of preferred applications
The menu of installed applications
The option to run a given command

This menu is part of the Fluxbox root menu and can also be accessed through the keyboard shortcut: WinKey + a

Here is a screen-capture of this menu:

The menus of preferred and installed applications are :
- Generated by script appsmenus-gen which is executed, when required, by startup module 030-apps-menus.sh.
- Maintained up-to-date during Fluxbox sessions by an instance of dtfilemon started by the startup-module 030-apps-menus.sh.
The script appsmenus-gen generates the menus of installed and preferred applications by running xdgmenumaker and wmpamgen, respectively.
The list of preferred applications are specified in wmpamgen configuration file, i.e. conf.d/wmpamgen.conf.

When this list is modified, the menu of preferred applications must be regenerated, through the option Refresh applications menus in menu Tools, or by running appsmenus-gen from the command line, as below :
$ ~/.fluxbox/appsmenus-gen --pref-apps-menu
To choose which ones of the installed applications must be accessible from the menu of preferred applications, the GUI pref-apps-man can also be used :

3. `fluxbox.menu`

This is the menu which allows to configure Fluxbox, select a style, …. It is part of the Fluxbox root menu and can also be accessed through the keyboard shortcut: WinKey + f

Here is a screen-capture of this menu:

4. `layout.menu`

This is the windows layout menu. It is part of the menu "Fluxbox" and can also be accessed through the keyboard shortcut: WinKey + l

Here is a screen-capture of this menu:

5. `tools.menu`

This is the tools menu which gives access to useful tools and options. It is part of the menu "Fluxbox" and can also be accessed through the keyboard shortcut: WinKey + t.

Here is a screen-capture of this menu:

The option Startup manager runs fb-startup-man.
The option Preferred applications manager runs pref-apps-man.
The option Refresh applications menus runs appsmenus-gen to force regeneration of menus of preferred and installed applications.
The option Desktop wallpaper runs fbsetbg-gui which is a GUI to select the Fluxbox wallpaper from a file-selection dialog.

6. `session.menu`

This is the session menu which allows to log out, lock the screen, suspend, hibernate, reboot, shutdown the system. It is part of the Fluxbox root menu and can also be accessed through the keyboard shortcut: WinKey + s.

Here is a screen-capture of this menu:

To lock the screen the command "xscreensaver-command -lock" is run. If that fails, the command xlock is run.

VIII. Keyboard shortcuts

Below the tables of the keyboard shortcuts defined in configuration file ~/.fluxbox/keys.

1. Window focus shortcuts

Action	Shortcut(s)
Focus next window	`Alt` + `Tab` `OnToolBar:` `Ctrl` + `WheelDown`
Focus prev. window	`Shift` + `Alt` + `Tab` `OnToolBar:` `Ctrl` + `WheelUp`
Focus window on left	`WinKey` + `Left`
Focus window on right	`WinKey` + `Right`
Focus window above	`WinKey` + `Up`
Focus window below	`WinKey` + `Down`

2. Window commands shortcuts

Action	Shortcut(s)
Open window menu	`Alt` + `Space` `OnTitleBar:` `RightButton`
Close window	`Alt` + `F4`
Kill window	`Ctrl` + `Alt` + `Escape`
Shade/Unshade window	`WinKey` + `PgUp` `WinKey` + `PgDn`
Stick/Unstick window	`WinKey` + `Scroll-Lock`

3. Window tabs shortcuts

Action	Shortcut(s)
Attach/Detach window	`OnTitleBar:` `Ctrl` + `DragLeftButton`
Detach current tab	`Ctrl` + `WinKey` + `Tab`
Select a tab	`OnTitleBar:` `LeftButton`
Next tab	`WinKey` + `Tab`
Prev tab	`Shift` + `WinKey` + `Tab`
Go tab #n	`WinKey` + `1\|2\|3\|4\|5\|6\|7\|8\|9\|0`

4. Window sizing shortcuts

Action	Shortcut(s)
Minimize window	`Alt` + `F9`
Maximize window	`Alt` + `F10` `OnTitleBar:` `LeftButton` x2
Maximize window horz.	`Shift` + `Alt` + `F10` `OnTitleBar:` `Shift` + `Alt` + `LeftButton` x2
Maximize window vert.	`Alt` + `WinKey` + `F10` `OnTitleBar:` `Alt` + `WinKey` + `LeftButton` x2
Fullscreen	`Alt` + `F11`
Resize	`OnWindow:` `WinKey` + `DragLeftButton` `OnTitleBar:` `WinKey` + `DragLeftButton`
Resize^{(with grips)}	`OnLeftGrip:` `DragLeftButton` `OnRightGrip:` `DragLeftButton`
Resize^{(no focus change)}	`OnWindow:` `Ctrl` + `WinKey` + `DragLeftButton` `OnTitleBar:` `Ctrl` + `WinKey` + `DragLeftButton`
Resize^(keyboard)	`Shift` + `Ctrl` + `WinKey` + `Left` `Shift` + `Ctrl` + `WinKey` + `Right` `Shift` + `Ctrl` + `WinKey` + `Up` `Shift` + `Ctrl` + `WinKey` + `Down`

5. Window movement shortcuts

Action	Shortcut(s)
Move window	`OnWindow:` `Alt` + `DragLeftButton` `OnTitleBar:` `DragLeftButton`
Move window^{(no focus change)}	`OnWindow:` `Ctrl` + `Alt` + `DragLeftButton` `OnTitleBar:` `Ctrl` + `Alt` + `DragLeftButton`
Move window^(keyboard)	`Ctrl` + `Alt` + `WinKey` + `Left` `Ctrl` + `Alt` + `WinKey` + `Right` `Ctrl` + `Alt` + `WinKey` + `Up` `Ctrl` + `Alt` + `WinKey` + `Down`

6. Window layout shortcuts

Action	Shortcut(s)
Curr. Window on left edge	`Alt` + `WinKey` + `Left`
Curr. Window on right edge	`Alt` + `WinKey` + `Right`
Curr. Window on up edge	`Alt` + `WinKey` + `Up`
Curr. Window on down edge	`Alt` + `WinKey` + `Down`
Arrange windows vert.	`Shift` + `WinKey` + `v`
Arrange windows horz.	`Shift` + `WinKey` + `h`
Stack windows left	`Shift` + `WinKey` + `Left`
Stack windows right	`Shift` + `WinKey` + `Right`
Stack windows up	`Shift` + `WinKey` + `Up`
Stack windows down	`Shift` + `WinKey` + `Down`

7. Menus shortcuts

Action	Shortcut(s)
Hide menus	`OnDesktop:` `LeftButton`
Windows menu	`OnDesktop:` `Alt` + `RightButton` `Alt` + `WinKey` + `RightButton` `WinKey` + `w`
Workspaces menu	`OnDesktop:` `MiddleButton` `OnDesktop:` `Ctrl` + `RightButton` `Ctrl` + `WinKey` + `RightButton` `WinKey` + `k`
Root menu	`OnDesktop:` `RightButton` `WinKey` + `RightButton` `WinKey` + `space`
Applications menu	`WinKey` + `a`
Fluxbox menu	`WinKey` + `f`
Layout menu	`WinKey` + `l`
Tools menu	`WinKey` + `t`
Session menu	`WinKey` + `s`
Storage volumes menu	`WinKey` + `v`

8. Applications shortcuts

Action	Shortcut(s)
xterm	`Alt` + `F1`
fbrun	`Alt` + `F2`
htop	`Alt` + `Ctrl` + `Del`

htop is run with an xterm instance using classname xterm_htop_emergency so that htop is automatically put on layer #2 (AboveDock) and centered on the screen (see per-application configuration file apps about this setting).

9. Workspace shortcuts

Action	Shortcut(s)
Show desktop	`WinKey` + `d`
Go prev. workspace	`OnDesktop:` `Ctrl` + `WheelUp` `Ctrl` + `WinKey` + `Left`
Go next workspace	`OnDesktop:` `Ctrl` + `WheelDown` `Ctrl` + `WinKey` + `Right`
Go workspace #n	`Ctrl` + `WinKey` + `1\|2\|3\|4\|5\|6\|7\|8\|9\|0`
Send current window to prev workspace	`WinKey` + `m` + `WinKey` + `Left`
Send current window to next workspace	`WinKey` + `m` + `WinKey` + `Right`
Send current window to workspace #n	`WinKey` + `m` + `WinKey` + `1\|2\|3\|4\|5\|6\|7\|8\|9\|0`
Go to prev workspace with current window	`WinKey` + `g` + `WinKey` + `Left`
Go to next workspace with current window	`WinKey` + `g` + `WinKey` + `Right`
Go to workspace #n with current window	`WinKey` + `g` + `WinKey` + `1\|2\|3\|4\|5\|6\|7\|8\|9\|0`

10. Multimedia shortcuts

These shortcuts work only on system with a multimedia keyboard.

Action	Shortcut(s)
Mute master volume	`MultimediaKey:` `XF86AudioMute`
Lower master volume^(5%)	`MultimediaKey:` `XF86AudioLowerVolume`
Raise master volume^(5%)	`MultimediaKey:` `XF86AudioRaiseVolume`

11. Fluxbox shortcuts

Action	Shortcut(s)
Exit with confirmation	`Ctrl` + `WinKey` + `x`
Restart Fluxbox	`Ctrl` + `WinKey` + `r`
Reconfigure Fluxbox	`Ctrl` + `WinKey` + `c`
Reload Fluxbox style	`Ctrl` + `WinKey` + `y`

12. Tools shortcuts

Action	Shortcut(s)
Full screenshot	`PrtScr`
Full screenshot^{(timeout=30s)}	`Shift` + `PrtScr`
Window screenshot	`Ctrl` + `PrtScr`
Region screenshot	`Alt` + `PrtScr`

13. Power shortcuts

Action	Shortcut(s)
Suspend	`Ctrl` + `WinKey` + `s`
Hibernate	`Ctrl` + `WinKey` + `h`
Reboot	`Ctrl` + `WinKey` + `b`
Shutdown	`Ctrl` + `WinKey` + `u`

IX. Fluxbox styles

flaxx comes with the following fluxbox styles, which are accessible from root menu > Fluxbox > User Styles.

All these styles comes with two sets of icon max: The first uses a rectangle to represent the action and is named max-rec, the second uses two triangles, is named max-tri and is selected by default.

The selection of one or the other is done with the following symlinks in the directory "pixmaps" of the style:

max.xpm
max-hi.xpm
max-lo.xpm

1. classic-catalina-blue

2. classic-charcoal

3. classic-deepsky

4. classic-manatee

5. classic-mariner

6. classic-matisse

7. classic-polo-blue

8. classic-sanjuan

9. clean-charcoal

10. clean-deepsky

11. clean-manatee

X. Fluxbox issues and Troubleshooting

If something does not work as expected when running Fluxbox with the configuration flaxx, first check the log file startup.log in \~/.fluxbox/log.d.

If this does not help, check the other logfiles in ~/.fluxbox/log.d that could contain informations related to the encountered issue.

Finally, check the log file ~/.xsession-errors (or ~/.xsession-errors._0, or ~/.xsession-errors._1).

1. Fluxbox crash

Sometimes, Fluxbox exits abprutly when moving a window to another workspace using the shortcuts Send current window to … and Go to … with current window (see workspace shortcuts).

The only clue about that is the following error message logged in ~/.xsession-errors :

free(): invalid pointer

2. fbsetbg can’t find wallpaper

Sometimes, the following message can be displayed at Fluxbox startup whereas the wallpaper well exist :

fbsetbg: Can't find wallpaper <X>

This is mainly encountered when the wallpaper is referenced more than once in file ~/.fluxbox/lastwallpaper.

The easiest way to fix that issue is to remove the superfluous occurence(s) of the wallpaper.

Flaxx

I. Presentation

II. Requirements

III. Package installation

IV. Installing the configuration Flaxx

V. Directories and files: Overview

VI. Startup modules

1. Startup modules selection

2. The included startup-modules

A. The pre-startup modules

1. 010-load-res.sh

2. 020-numlock.sh

3. 030-apps-menus.sh

4. 040-stovol-menu.sh

5. 050-dbus.sh

6. 060-dunst.sh

7. 070-pulseaudio.sh

8. 080-vboxclient.sh

9. 090-compton.sh

10. 095-default-background.sh

11. 100-dockapps.sh

B. The post-startup modules

1. 010-blueman-applet.sh

2. 020-hplip-systray.sh

3. 030-nm-applet.sh

4. 040-pasystray.sh

5. 050-xscreensaver.sh

6. 060-conky.sh

7. 060-gkrellm.sh

8. 070-analog-clock.sh

9. 999-audacious.sh

10. 999-chromium.sh

11. 999-galculator.sh

12. 999-geany.sh

13. 999-gimp.sh

14. 999-google-chrome.sh

15. 999-grsync.sh

16. 999-libreoffice-calc.sh

17. 999-libreoffice-writer.sh

18. 999-mozilla-firefox.sh

19. 999-mozilla-thunderbird.sh

20. 999-mplayer.sh

21. 999-smplayer.sh

22. 999-thunar.sh

23. 999-uxterm.sh

24. 999-virtualbox.sh

25. 999-xfe.sh

3. Implementing startup modules

VII. Menus

1. root.menu

2. apps.menu

3. fluxbox.menu

4. layout.menu

5. tools.menu

6. session.menu

VIII. Keyboard shortcuts

1. Window focus shortcuts

2. Window commands shortcuts

3. Window tabs shortcuts

4. Window sizing shortcuts

5. Window movement shortcuts

6. Window layout shortcuts

7. Menus shortcuts

8. Applications shortcuts

9. Workspace shortcuts

10. Multimedia shortcuts

11. Fluxbox shortcuts

12. Tools shortcuts

13. Power shortcuts

IX. Fluxbox styles

1. classic-catalina-blue

2. classic-charcoal

3. classic-deepsky

4. classic-manatee

5. classic-mariner

6. classic-matisse

7. classic-polo-blue

8. classic-sanjuan

9. clean-charcoal

10. clean-deepsky

1. `root.menu`

2. `apps.menu`

3. `fluxbox.menu`

4. `layout.menu`

5. `tools.menu`

6. `session.menu`