Difference between revisions of "Subtle"

From ArchWiki
Jump to: navigation, search
m (Sublets)
Line 146: Line 146:
  
 
For a list of sublets, go to the [http://sur.subforge.org sur website].
 
For a list of sublets, go to the [http://sur.subforge.org sur website].
 +
 +
{{Note|If you install a sublet as root, you will not be able to invoke the sublet as a regular user. Sublets used by non-root accounts must be installed under the user.}}
  
 
===Sublet Configuration===
 
===Sublet Configuration===
Line 184: Line 186:
 
}}
 
}}
  
Each sublet has its own parameters and formatting options you can change to your taste.  
+
Each sublet has its own parameters and formatting options you can change to your taste.
  
 
== Contact ==
 
== Contact ==
  
 
If you have problems, suggestions or just want to talk about [http://subforge.org/projects/subtle subtle] feel free to join '''#subtle''' on '''irc.freenode.org''' or drop a mail to _unexist_ at _dorfelite_ dot _net_.
 
If you have problems, suggestions or just want to talk about [http://subforge.org/projects/subtle subtle] feel free to join '''#subtle''' on '''irc.freenode.org''' or drop a mail to _unexist_ at _dorfelite_ dot _net_.

Revision as of 21:27, 15 June 2011


Introduction

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.

Installation

Currently there are two different packages available:

The stable version is in community and can be installed with pacman, the developer snapshot is in AUR and needs either a special tool like yaourt, clyde or packer or can be installed manually.

Configuration

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:

Template:Cli

  • 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.

Note: The default keybindings use the numeric keypad for selecting window size-positions ("gravities") which is awkward on a laptop where NumLock will be required, so laptop users will want to rebind these functions - the default config contains an alternate methods for this.

Themes

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.

In the Template:Filename for subtle stable, look for lines that look similar to what is shown below to change the appearance of the panels, etc.: Template:File

In the Template:Filename of the subtle-hg build, look for the lines below: Template:File

Sublets

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.

Installing Sublets

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.

Note: If you install a sublet as root, you will not be able to invoke the sublet as a regular user. Sublets used by non-root accounts must be installed under the user.

Sublet Configuration

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.

Sublet Appearance

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.

Contact

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_.