Musca is controlled by issuing text commands, via one of:
Create a new group called name, and switch to it.
bind <on/off> <Modifier>+<Key> <command>
Bind a Musca command to a key combination with on, and remove it again with off. If the argument to off is all, it clears the bound key list. The command argument is only needed for on`.
(toggle) Turn the current frame border on and off.
(toggle) Set the current frame as a catch-all, where all new windows will open.
client hints <on/off>
(toggle) Whether to respect X size hints for the current application window, such as PMinSize, PMaxSize, PResizeInc, PBaseSize, PAspect.
Launch the dmenu Musca command input.
cycle <local> <next/prev>
Cycle a hidden window into the current frame. local means cycle only windows previously displayed in the current frame. next or prev specify the direction, defaulting to next. Both arguments are optional.
(toggle) Dedicate the current frame to the current app, so that no new windows will open there.
Delete a group by name or by number.
Export a description (group name and frame layout) of the current group to file.
Execute as shell command.
Change focus to a frame in the specified direction.
Resize frame vertically.
hook <on/off> <pattern> <command>
Bind a Musca command to any other Musca command matching pattern.
Split frame horizontally.
Politely close the client window via a close event. When the optional argument number or name is given, kill the associated window, otherwise kill the current frame. Press again to forcibly kill it.
Import a description from file into the current group.
manage <on/off> <name>
(toggle) Set whether the window class called name is managed or ignored.
Move the current window to the group called name or to the group number.
Rename the current group.
Remove all other frames except the current one, resizing it to full screen.
pad <left> <right> <top> <bottom>
Set the current group screen padding in pixels.
Raise and focus a window in the current group by number (order opened) or
Trigger a screen refresh for the focused frame and window. Some apps dislike being resized into a frame immediately on startup and might need a nudge.
Remove the current frame and resize others to fill the gap.
Resize the current frame in the specified direction.
Execute a file consisting of Musca commands. The file must contain one command per line. Lines starting with hash # are comments and blank lines are acceptable.
Display text via the method in the 'notify' setting.
Switch to screen number. This is zero based, and should match the order in which screens are defined in xorg.conf.
set <setting> <value>
Set a Musca variable. See [[Settings/settings]] for a list of variable names.
Launch the dmenu shell command input.
Output a system table for diagnostic purposes.
Note: When calling show commands in background scripts, it is best to prefix the command with silent to suppress the output also being directed to Musca's notify setting. Eg:
$ musca -c "silent show groups"
Allow minimizing/iconifying a window. A normal raise <name/id> will restore the window.
Move current window into the frame to the left, right, up and down respectively.
Swap current window with the contents of the frame to the left, right, up and down respectively.
Launch the dmenu window or group switcher.
Revert the last frame layout change.
Switch to a group called by its name or to a group by its number. name has precedence over number. When (other), (prev) or (next), switch to the previously focused, previous or next group respectively.
Split frame vertically.
Resize frame horizontally.