Musca has a list of settings that can be altered on the fly using the set <name> <value> command:
set border_focus Orange
| Name | Default | Description |
|---|---|---|
| border_focus | Blue | Border colour for focused frames in tiling mode, and focused windows in stacking mode. |
| border_unfocus | Dim Gray | Border colour for unfocused frames in tiling mode, and unfocused windows in stacking mode. |
| border_dedicate_focus | Red | Border colour for focused dedicated frames in tiling mode. |
| border_dedicate_unfocus | Dark Red | Border colour for unfocused dedicated frames in tiling mode. |
| border_catchall_focus | Green | Border colour for focused catchall frames in tiling mode. |
| border_catchall_unfocus | Dark Green | Border colour for unfocused catchall frames in tiling mode. |
| border_width | 1 | Width in pixels of frame borders in tiling mode, and window borders in stacking mode. The minimum value is 0. |
| frame_min_wh | 100 | Minimum width and height in pixels of frames and managed windows. |
| frame_resize | 20 | Size in pixels of a frame resize step. Setting this smaller will make resizing operations smoother, but also slower and increase load. |
| startup | .musca_start | (optional, only in config.h) Path to a file containing Musca commands to run at start up. The default setting is relative to the working directory; ie, Musca will use $HOME/.musca_start only if Musca is started from $HOME, which is the usual method for login managers. The file must contain one command per line. Lines starting with hash # are comments and blank lines are acceptable. |
| dmenu | dmenu -i -b | Command to run to launch dmenu along with any customize appearance arguments. This can be replaced by another launcher so long as it accepts a list of \n terminated items on stdin and returns a single line on stdout. |
| switch_window | sed 's/^/raise /' | $MUSCA -i | The command to run once the user has selected a window number and name from dmenu. |
| switch_group | sed 's/^/use /' | $MUSCA -i | The command to run once the user has selected a group name from dmenu. |
| run_musca_command | $MUSCA -i | The command to run when the user has entered a Musca command via dmenu. |
| run_shell_command | sed 's/^/exec /' | $MUSCA -i | The command to run when the user has entered a shell command via dmenu. |
| notify | echo cat | The command to run to send the user a message. By default Musca just writes to stdout. ''Note: Prefix Musca commands with '''silent''' to supress notification messages for the duration of the command.'' |
| stack_mouse_modifier | Mod4 | The modifier key to use in stacking mode, along with mouse buttons 1 and 3, to move and resize windows respectively. |
| focus_follow_mouse | 0 | (toggle) Set to 1 to enable. |
| window_open_frame | current | When set to current, new windows always open in the currently focused frame. When set to empty, new windows will try to find an empty frame to use. |
| window_open_focus | 1 | (toggle) Set to 0 to prevent new windows from taking the input focus. |
| window_size_hints | 1 | (toggle) Set to 0 to disable size hints checks for new windows. This can still be overridden on a per client basis using the [[Commands#client|client]] command. |
| command_buffer_size | 4096 | Size in bytes of the allocated buffer for passing commands and results to and from musca -c and musca -i. |
| notify_buffer_size | 4096 | Size in bytes of the allocated buffer for passing messages to the command defined in the notify setting. |
| frame_display_hidden | 1 | When set to 0, empty frames will stay empty until a window is manually selected. When set to 1, empty frames will automatically display the first available hidden window. When set to 2, empty frames will automatically display only windows previously displayed in this frame. |
| frame_split_focus | current | When splitting a frame, current indicates focus should remain with the original frame and window, while new indicates focus should switch to the newly created frame. |
| group_close_empty | 0 | When navigating away from an empty group, 1 indicates the group should be automatically dropped, while 0 indicates it should remain. |
2013-01-04 eof