On startup, larswm will look for the file $HOME/.larswmrc. You can tell it to read a different file with the -f command line switch.
Following is a complete list of all resources recognised by larswm and used to set user preferences on startup. In addition to these, you can configure the keyboard shortcuts using resources, but these are mostly self documenting if you print out a default .larswmrc with the -defaults command line option.
Table D-1. Available Resources
| Resource | Description |
|---|---|
| larswm.border: integer | Width of the window borders in pixels, 0-128, default 2. |
| larswm.tile_pad: integer | How many pixels to leave between windows when tiling, 0-128, default 2. |
| larswm.foreground: string | Foreground color, default black. |
| larswm.background: string | Background color, default white. |
| larswm.font: string | Menu and status bar font, default fixed |
| larswm.terminal: string | Command for opening a new terminal window, default xterm. |
| larswm.desktops: integer | How many virtual desktops per screen, 1-16, default 4. |
| larswm.dtname.#: string | Virtual desktop name |
| larswm.#.#.tile_resize: boolean | Resize windows when tiling, default True. |
| larswm.#.#.left_track_width: integer | Percent of screen width used by the left track, 5-95, default 65. |
| larswm.#.#.skip_focus: boolean | Start in Skip Focus mode, default True. |
| larswm.#.#.clickthru: boolean | Start in Clickthru mode, default True. |
| larswm.sticky_notile: boolean | Make all windows on the untiled subdesktop sticky, default False. |
| larswm.application.#: string | Define the command used to start an application. For use with keyboard shortcuts. |
| larswm.floatclass.#: string | Make window class float above all other windows. |
| larswm.toolclass.#: string | Treat window class as a tool. |
| larswm.stickyclass.#: string | Make window class be visible on all virtual desktops. |
| larswm.dotileclass.#: string | Assign window class to the tiled subdesktop. |
| Caution |
Resources ending with a number means you need to provide a unique index for each resource of that type. Use numbers between 0 and 63. |
Tip: Resources with two numbers in the middle of the name means you can optionally limit that resource to a specific screen and/or virtual desktop. Please see the section called Screen and/or virtual desktop specific preferences for more information on this.
Tip: All of the options that take a window class as an argument takes an optional instance, specified after a tilde. As an example, if you do this:
then only the main browser windows will be tiled, and not all the other types, like download progress etc.
Resources with two numbers right after the larswm tag means you can optionally limit that resource to a specific screen and/or virtual desktop. The following table lists the combinations, highest precedence first:
Table D-2. Resource Precedence
| Format | Screens Affected | Desktops Affected |
|---|---|---|
| larswm.S.D.resource | S | D |
| larswm.S.?.resource | S | All |
| larswm.?.D.resource | All | D |
| larswm.?.?.resource | All | All |
| larswm*resource | All | All |
Tip: Since more specific resources takes precedence over less specific, you could do this:
This would enable skip_focus only on virtual desktop number 3 on the first screen.