Subtle is a manual tiling window manager with a rather uncommon approach of tiling: Per default there is no typical layout enforcement, windows are placed on a position (gravity) in a custom grid. The user can change the gravity of each window either directly per grabs or with rules defined by tags in the config.
Currently there are two different packages available:
On start subtle will check if a config file is available in the typical XDG paths and use it. A local config is preferred over a system wide. (See Template:Codeline)
Then it will have a look for sublets in the XDG paths too and load them accordingly. (See Template:Codeline)
No system wide sublets will be loaded per default.
- To create a user config just create $XDG_CONFIG_HOME/subtle and copy the latest config from the dist folder into it. To do this, type the following command into the console:
- To enable sublets create $XDG_DATA_HOME/subtle/sublets and create symlinks to the sublets. (Load order is alphabetically)
Always compare your existing config with the one of the repository/tarball to get the latest options.
This and more info can be found on the subtle website.
Checking the Configuration Syntax
If an error is in the subtle config, subtle may not start.
To check if your config contains errors, simply type in the command: Template:Cli.
The appearance of subtle, that is, the colors of the panels, subtlets and other such elements are configured according to what is set in the *Colors* section (in subtle stable) and in the *Styles* section (in subtle-hg). Note that theme configurations for subtle stable and subtle-hg are different.
Sublets are tiny apps that appear in the subtle panels. They can be used to show the battery state, the volume, control mpd, among other purposes.
To install a sublet, open a terminal window and type the following command: Template:Cli
Example: Template:Cli This will install the mpd sublet.
For a list of sublets, go to the sur website.
After you have installed a sublet, you must invoke it in the ~subtle.rb~ configuration.
Look for a series of lines similar to the one below: Template:File
What is inside the brackets is shown on the respective panel.
The appearance of a sublet is determined through the Template:Filename configuration. Information as to how to format the sublet is usually provided in the terminal output when installing the sublet.
Here is an example, using the clock sublet: Template:File
Note that you can change the colors of the sublet and also what information it shows in the panel.
Here is another example, using the ~weather~ sublet: Template:File
Each sublet has its own parameters and formatting options you can change to your taste.
If you have problems, suggestions or just want to talk about subtle feel free to join #subtle on irc.freenode.org or drop a mail to _unexist_ at _dorfelite_ dot _net_.