Difference between revisions of "Subtle"

From ArchWiki
Jump to: navigation, search
m (added subtle thread links (moved from Comparison of Tiling Window Managers)
(the default config of sublet changed, sublets do not need to be enabled manually anymore)
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Tiling WMs (English)]]
+
[[Category:Tiling WMs]]
{{i18n|Subtle}}
+
[[de:Subtle]]
 +
[[ko:Subtle]]
 
From [http://subforge.org/projects/subtle Subtle project page]:
 
From [http://subforge.org/projects/subtle Subtle project page]:
 
:''Subtle is a manual tiling window manager with a rather uncommon approach of tiling: Instead of relying on predefined layouts, Subtle divides the screen into a grid with customizable slots (called gravities).''
 
:''Subtle is a manual tiling window manager with a rather uncommon approach of tiling: Instead of relying on predefined layouts, Subtle divides the screen into a grid with customizable slots (called gravities).''
  
Subtle is programmed in [[Ruby]] for [[Xorg]].
+
Subtle is configured with [[Ruby]] for [[Xorg]].
  
 
{{Note|This article only explain the basics of Subtle. In depth information and tutorials exist at the [http://subforge.org/projects/subtle Subtle project page].}}
 
{{Note|This article only explain the basics of Subtle. In depth information and tutorials exist at the [http://subforge.org/projects/subtle Subtle project page].}}
  
 
==Installing==
 
==Installing==
The [http://www.archlinux.org/packages/community/i686/subtle/ Subtle package] is available in the [[Community]] repository. It can be installed with [[pacman]].
+
The {{pkg|subtle}} package is available in the [[Official Repositories|official repositories]]. It can be installed with [[pacman]].
# pacman -S subtle
+
 
A [http://aur.archlinux.org/packages.php?ID=13139 developer snapshot] is available in the [http://aur.archlinux.org AUR].
+
A developer snapshot is available in the [[AUR]] named {{AUR|subtle-hg}}.
  
 
==Starting Subtle==
 
==Starting Subtle==
To start Subtle add {{ic|exec subtle}} to your {{ic|.xinitrc}} file and launch Xorg. Remember that Subtle does not provide any icons or menus, and the only predefined key binding that opens a terminal is Super + Return, which will open [[URxvt]]. So if you don’t have URxvt, either install it or change the configuration file before starting. If you need to exit Subtle press Super + Control + Q.
+
To start Subtle add {{ic|exec subtle}} to your {{ic|.xinitrc}} file and launch Xorg. Remember that Subtle does not provide any icons or menus, and the only predefined key binding that opens a terminal is {{ic|Super+Enter}}, which will open [[URxvt]]. So if you do not have URxvt, either install it or change the configuration file before starting. If you need to exit Subtle press {{ic|Super+Ctrl+q}}.
  
 
==Basic function==
 
==Basic function==
Line 37: Line 38:
  
 
===Installing sublets===
 
===Installing sublets===
To install a sublet, type the following command in a teminal:
+
To install a sublet, type the following command in a terminal:
 
  $ sur install <name of sublet>
 
  $ sur install <name of sublet>
  
Line 45: Line 46:
  
 
===Enabling sublets===
 
===Enabling sublets===
After installation you need to enable it in {{ic|subtle.rb}}. Look for a series of lines similar to the ones below:
+
By default all sublets are displayed in the top right corner. You can change this behavior in {{ic|subtle.rb}} by removing {{ic|:sublets}} from the screen config and adding your sublets like this:
<pre>
+
{{bc|<nowiki>
 
screen 1 do
 
screen 1 do
 
  top [ :title, :spacer, :views ]
 
  top [ :title, :spacer, :views ]
 
  bottom [ :mpd, :wifi, :battery ]
 
  bottom [ :mpd, :wifi, :battery ]
 
end
 
end
</pre>
+
</nowiki>}}
 
Then just add the sublets name in the same fashion as the other ones, like this:
 
Then just add the sublets name in the same fashion as the other ones, like this:
<pre>
+
{{bc|<nowiki>
 
  bottom [ :mpd,  :<name of sublet>, :wifi, :battery ]
 
  bottom [ :mpd,  :<name of sublet>, :wifi, :battery ]
</pre>
+
</nowiki>}}
 
It can of course be inserted at a place by your own choice.
 
It can of course be inserted at a place by your own choice.
  
Line 61: Line 62:
 
* [http://subforge.org/projects/subtle Subtle project page]
 
* [http://subforge.org/projects/subtle Subtle project page]
 
* [http://sur.subforge.org Sublets archive]
 
* [http://sur.subforge.org Sublets archive]
*[https://bbs.archlinux.org/viewtopic.php?id=71783 The subtle thread]
+
* [https://bbs.archlinux.org/viewtopic.php?id=71783 The subtle thread]
*[https://bbs.archlinux.org/viewtopic.php?id=112486 Share your Subtle desktop!]
+
* [https://bbs.archlinux.org/viewtopic.php?id=112486 Share your Subtle desktop!]
 
* [[xinitrc]]
 
* [[xinitrc]]
* [[Start X at boot]]
+
* [[Start X at Login]]
 
* [[Window Manager]]
 
* [[Window Manager]]

Revision as of 09:29, 4 December 2013

From Subtle project page:

Subtle is a manual tiling window manager with a rather uncommon approach of tiling: Instead of relying on predefined layouts, Subtle divides the screen into a grid with customizable slots (called gravities).

Subtle is configured with Ruby for Xorg.

Note: This article only explain the basics of Subtle. In depth information and tutorials exist at the Subtle project page.

Installing

The subtle package is available in the official repositories. It can be installed with pacman.

A developer snapshot is available in the AUR named subtle-hgAUR.

Starting Subtle

To start Subtle add exec subtle to your .xinitrc file and launch Xorg. Remember that Subtle does not provide any icons or menus, and the only predefined key binding that opens a terminal is Super+Enter, which will open URxvt. So if you do not have URxvt, either install it or change the configuration file before starting. If you need to exit Subtle press Super+Ctrl+q.

Basic function

When windows are opened they are matched against a set of user-defined rules to get proper position and size. The process of applying these rules can be broken down in three main parts:

  • View
  • Gravity
  • Tag

Views are the environment in which the windows will be placed. Much like ordinary desktop surfaces. Defining the actual rules for a window is accomplished with a tag. In tags you also determine the gravity to be used. Gravities control the size and position of windows.

Note: When configuring Subtle you actually need to declare these elements in reverse order. Gravity, tag then view.

Configuration

Subtle will search for subtle.rb in your $XDG_CONFIG_HOME path. If it is non-existant it will load a default file from your $XDG_CONFIG_DIRS path. It is preferable to copy this file to your $XDG_CONFIG_HOME/subtle directory instead of using the default.

The default file will contain numerous gravities, tags and views. This is an excellent place to start when designing your own environment. Applications without matching tags will be placed on the view containing the default tag, if no view posses it, they are automatically placed on the first view.

To check your configuration file for potential errors, simply run the following command:

$ subtle -k

Sublets

Sublets are tiny apps that appear in the Subtle panels. They can be used to control various applications and show system stats.

Installing sublets

To install a sublet, type the following command in a terminal:

$ sur install <name of 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.

Enabling sublets

By default all sublets are displayed in the top right corner. You can change this behavior in subtle.rb by removing :sublets from the screen config and adding your sublets like this:

screen 1 do
 top [ :title, :spacer, :views ]
 bottom [ :mpd, :wifi, :battery ]
end

Then just add the sublets name in the same fashion as the other ones, like this:

 bottom [ :mpd,  :<name of sublet>, :wifi, :battery ]

It can of course be inserted at a place by your own choice.

See also