COMA(1)

NAME
coma - a keyboard driven, tiling window manager

SYNOPSIS
coma [-c] config

DESCRIPTION
coma is a keyboard driven tiling window manager. By default the window manager will attempt to create 484 pixel frames on your screen. This is wide enough to fit 80-column xterms inside of them when using the default 'fixed' font.

These defaults can be overwritten using the configuration file.

CONFIGURATION
The configuration file by default exists in $HOME/.comarc but can be given on the command line with the [-c] flag.

The following options can be configured:

font (default: fixed:pixelsize=13:style=bold)
    The font to be used by coma for status bars and input.

frame-layout (default: default)
    Change frame layout. options: small-large, default. The gap between frames and from the top and bottom of the screen.

frame-gap (default: 10)
    The gap between frames and from the top and bottom of the screen.

frame-bar (default: 20)
    The height of the bar at the bottom of the frames.

frame-count (default: auto).
    The number of frames to create (by default coma will create frames until they no longer fit on-screen).

frame-width (default: 484)
    The width of each frame.

frame-height (default: fill)
    The height of each frame.

frame-offset (default: 0)
    The X offset where you want things to be created from.

bind
    Bind the given key to the action specified. (see key bindings below). If the action is prefixed with cmd: the keybinding will execute that command via the coma-run internal instead.

    Example: bind frame-next p

color
    Set the color for the specified type (see colors below).

    Example: color client-active "#55007a"

prefix (default: C-t)
    Configure the prefix key. The format of this key is in the form of MOD-KEY.

    Allowed MODs: C (Control), S (Shift), M (mod1), M2 (mod2), M3 (mod3), M4 (mod4).

KEY BINDINGS
All key bindings start with the prefix key which by default is C-t. The prefix key can be configured in the configuration file.

These are the default key bindings for all actions:

C-t c (coma-terminal)
    Start a new xterm in the current frame

C-t h (frame-prev)
    Move to the next frame

C-t l (frame-next)
    Move to the previous frame

C-t space (frame-popup)
    Open and close the popup frame

C-t z (frame-zoom)
    Zoom/unzoom the current frame

C-t s (frame-split)
    Split the current frame vertically (can be done only once)

C-t m (frame-merge)
    Merge a vertically split frame back together into one

C-t f (frame-split-next)
    Toggle between the upper and lower part of a vertical split

C-t i (frame-move-client-left)
    Move the active client to the left

C-t o (frame-move-client-right)
    Move the active client to the right

C-t r (coma-restart)
    Restart coma

C-t q (coma-client-list)
    Display client quick selection list

C-t k (client-kill)
    Kill the active client (no warning will be presented)

C-t p (client-prev)
    Swap to the previous client in the frame

C-t n (client-next)
    Swap to the next client in the frame

C-t e (coma-run)
    Opens an input window and runs the given command when RETURN is hit

C-t colon (coma-command)
    Runs an internal WM command

COLORS
Colors must be in RGB format prefixed with a pound character and quoted in double quotes:

color client-active "#ffffff"

The following colors can be configured:

client-active
    The border color for the current active client.

client-inactive
    The border color for inactive clients.

frame-bar
    The color for the frame bars.

frame-bar-directory
    The directory path of the active client.

frame-bar-client-active
    The text color for the active client in the frame bar.

frame-bar-client-inactive
    The text color for the inactive client in the frame bar.

AUTHORS
coma was written by Joris Vink <joris@coders.se>