unexist.dev

h1. FAQ

{{toc}}

h2.  How do I start program xyz?

There are several way how to start a certain programm, here are the most common:

* Start your program via your $HOME/.xinitrc:

<pre><code class="ruby">

subtle &

PID=$!

sleep 2

urxvt

wait $PID

</code></pre>

* Start your program via [[grab]]:

<pre><code class="ruby">

"A-x" => "urxvt"

</code></pre>

_"dmenu":http://tools.suckless.org/dmenu is added as default launcher in the distributed config to make it more convenient._

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT view tag    #< Tag view 'view' with tag 'tag'

subtler -vT client tag  #< Tag client 'client' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")      #< Tag view 'view' with tag 'tag'

</code></pre>

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag           #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag   #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")    #< Tag view 'view' with tag 'tag'

</code></pre>

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")      #< Tag view 'view' with tag 'tag'

</code></pre>

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How does subtle match clients?

[[Subtle]] matches the {{color(#ff0000, WM_NAME)}} and the {{color(#0000ff, WM_CLASS)}} property of a window and not the title. This to ensure the match is correct. 

There are several ways to get these values, here are the most common:

* "xprop":http://www.xfree86.org/current/xprop.1.html: Just select the window and have a look for the WM_CLASS line which usually look like this:

p{class:pre}. WM_CLASS(STRING) = "{{color(#ff0000, urxvt)}}", "{{color(#0000ff, URxvt)}}")

* [[subtler]]: Run *[[subtler]] -cl* and look for the matching line:

p{class:pre}. 0x800007 * 1 1020x374 2 1 --- {{color(#ff0000, urxvt)}} ({{color(#0000ff,URxvt)}})

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")      #< Tag view 'view' with tag 'tag'

</code></pre>

[[Grabs]]:

<pre><code class="ruby">

def move_view(client, view_id)

  begin

    cur  = current_view

    view = views[view_id - 1]

    begin

      tag = find_tag(view.name)

    rescue

      tag = add_tag(view.name)

    end

    # Remove client from current tag

    if(client.has_tag?(cur.name))

      client.untag(cur.name)

    end

    # Tag new view with itself

    if(!view.has_tag?(tag))

      view.tag(tag)

    end

    # Finally add tag to client

    client.tag(tag)

  rescue => err

    puts err

  end

end

GRABS = {

  "A-F1" => lambda { |c| move_view(c, 1) },

  "A-F2" => lambda { |c| move_view(c, 2) },

  "A-F3" => lambda { |c| move_view(c, 3) },

  "A-F4" => lambda { |c| move_view(c, 4) }

}

</code></pre>

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")      #< Tag view 'view' with tag 'tag'

</code></pre>

Or with [[grabs]] and "Ruby":http://www.ruby-lang.org lambdas:

[[Grabs]]:

<pre><code class="ruby">

def move_view(client, view_id)

  begin

    cur  = current_view

    view = views[view_id - 1]

    begin

      tag = find_tag(view.name)

    rescue

      tag = add_tag(view.name)

    end

    # Remove client from current tag

    if(client.has_tag?(cur.name))

      client.untag(cur.name)

    end

    # Tag new view with itself

    if(!view.has_tag?(tag))

      view.tag(tag)

    end

    # Finally add tag to client

    client.tag(tag)

  rescue => err

    puts err

  end

end

GRABS = {

  "A-F1" => lambda { |c| move_view(c, 1) },

  "A-F2" => lambda { |c| move_view(c, 2) },

  "A-F3" => lambda { |c| move_view(c, 3) },

  "A-F4" => lambda { |c| move_view(c, 4) }

}

</code></pre>

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")      #< Tag view 'view' with tag 'tag'

</code></pre>

Please also have a look at the [[recipes]] wiki page which also includes two examples how to move clients.

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I set a wallpaper in subtle?

[[subtle]] itself has no own functionality to set a wallpaper, _~/.xinitrc_ is perfectly suited for this. 

Due the design of [[subtle]] sets background color of the root window and therefore overwrites any root pixmap set before. 

This can be bypassed with this:

<pre><code class="ruby">subtle &

PID=$!

display -window root pixmap.png

wait $PID

</code></pre>

h2.  How do I set a wallpaper in subtle?

[[subtle]] itself has no own functionality to set a wallpaper, _~/.xinitrc_ is perfectly suited for this. 

Due the design of [[subtle]] sets background color of the root window and therefore overwrites any root pixmap set before. 

This can be bypassed with this:

<pre><code class="ruby">subtle &

PID=$!

display -window root pixmap.png

wait $PID

</code></pre>

Or just comment out the background line.

h2.  How do I run a java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to MToolkit, which is known to work with non-reparenting windows managers like [[subtle]]. Dependend on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

s = Subtlext::Subtle.new            #< Connect to subtle

s.find_client("client").tag("tag")  #< Tag client 'client' with tag 'tag'

s.find_view("view").tag("tag")      #< Tag view 'view' with tag 'tag'

</code></pre>

Please also have a look at the [[recipes]] wiki page which also includes two examples how to move clients.

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I start program xyz?

There are several way how to start a certain programm, here are the most common:

* Start your program via your $HOME/.xinitrc:

<pre><code class="ruby">

subtle &

PID=$!

sleep 2

urxvt

wait $PID

</code></pre>

* Start your program via [[grab]]:

<pre><code class="ruby">

"A-x" => "urxvt"

</code></pre>

_"dmenu":http://tools.suckless.org/dmenu is added as default launcher in the distributed config to make it more convenient._

h2.  How do I run a java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to MToolkit, which is known to work with non-reparenting windows managers like [[subtle]]. Dependend on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

h2.  How do I run a java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to MToolkit, which is known to work with non-reparenting windows managers like [[subtle]]. Dependend on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

In case both doesn't work there is a third option: The JDK internally uses a hardcoded list of window managers that are non-reparenting, the "suckless":http://suckless.org made the tool "wmname":http://tools.suckless.org/wmname to change the name of the wm and just lie to Java. 

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

h2.  How do I run a java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to MToolkit, which is known to work with non-reparenting windows managers like [[subtle]]. Dependend on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

In case both doesn't work there is a third option: The JDK internally uses a hardcoded list of window managers that are non-reparenting, the "suckless":http://suckless.org guys made the tool "wmname":http://tools.suckless.org/wmname to change the name of the wm and just lie to Java. 

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

Subtlext::Tag.new("tag").save       #< Add new tag 'tag'

Subtlext::Client["client"] + "tag"  #< Tag client 'client' with tag 'tag'

Subtlext::View["view"] + "tag"      #< Tag view 'view' with tag 'tag'

</code></pre>

Please also have a look at the [[recipes]] wiki page which also includes two examples how to move clients.

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[Tags|tagging system]] and is initially usually done in the [[config]].

You can change tags either with [[subtler]] or [[subtlext]] per runtime:

[[Subtler]]:

<pre><code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

[[Subtlext]]:

<pre><code class="ruby">

Subtlext::Tag.new("tag").save       #< Add new tag 'tag'

Subtlext::Client["client"] + "tag"  #< Tag client 'client' with tag 'tag'

Subtlext::View["view"] + "tag"      #< Tag view 'view' with tag 'tag'

</code></pre>

Please also have a look at the [[recipes]] wiki page which also includes two examples how to move clients.

In _/usr/share/subtle/scripts_ is a tagging example script with the help of "dmenu":http://tools.suckless.org/dmenu.

h2.  How do I add tags to console based programs?

Generally [[subtle]] can apply [[Tagging|tags]] based on the {{color(#0000ff, WM_NAME)}} and both {{color(#ff0000, WM_CLASS)}} components. Console based programs like "irssi":http://irssi.org can be started like this and will change the {{color(#0000ff, WM_NAME)}} of the terminal:

<pre><code class="bash">urxvt -e irssi</code></pre>

Inspecting the terminal with "xprop":http://www.xfree86.org/current/xprop.1.html:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "urxvt")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

So if we want to tag this window there are some things that should be considered:

* "irssi":http://irssi.org updates the {{color(#0000ff, WM_NAME)}} only

* [[Tagging]] matches per default both {{color(#ff0000, WM_CLASS)}} components ({{color(#aa0000, instance)}} and {{color(#ff00ff, class)}} name)

* [[Tagging|Tags]] are applied when a window is mapped - that is *before* the terminal launches "irssi":http://irssi.org

To safely [[Tagging|tag]] it's better to change the {{color(#aa0000, instance)}} name of the terminal like this:

<pre><code class="bash">urxvt -name irssi -e irssi</code></pre>

This results in following (via "xprop":http://www.xfree86.org/current/xprop.1.html):

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

A [[Tagging|tag]] for this could be:

<pre><code class="ruby">tag "irssi" do

  match "irssi"

end</code></pre>

Please keep in mind, that the {{color(#ff0000, WM_CLASS)}} {{color(#ff00ff, class)}} name is still *URxvt* and will match others [[Tagging|tags]] too.

h2.  How do I tag console based programs?

Generally [[subtle]] can apply [[Tagging|tags]] based on the {{color(#0000ff, WM_NAME)}} and both {{color(#ff0000, WM_CLASS)}} components. Console based programs like "irssi":http://irssi.org can be started like this and will change the {{color(#0000ff, WM_NAME)}} of the terminal:

<pre><code class="bash">urxvt -e irssi</code></pre>

Inspecting the terminal with "xprop":http://www.xfree86.org/current/xprop.1.html:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "urxvt")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

So if we want to tag this window there are some things that should be considered:

* "irssi":http://irssi.org updates the {{color(#0000ff, WM_NAME)}} only

* [[Tagging]] matches per default both {{color(#ff0000, WM_CLASS)}} components ({{color(#aa0000, instance)}} and {{color(#ff00ff, class)}} name)

* [[Tagging|Tags]] are applied when a window is mapped - that is *before* the terminal launches "irssi":http://irssi.org

To safely [[Tagging|tag]] it's better to change the {{color(#aa0000, instance)}} name of the terminal like this:

<pre><code class="bash">urxvt -name irssi -e irssi</code></pre>

This results in following (via "xprop":http://www.xfree86.org/current/xprop.1.html):

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

A [[Tagging|tag]] for this could be:

<pre><code class="ruby">tag "irssi" do

  match "irssi"

end</code></pre>

Please keep in mind, that the {{color(#ff0000, WM_CLASS)}} {{color(#ff00ff, class)}} name is still *URxvt* and will match others [[Tagging|tags]] too.

h2.  How does subtle match clients?

[[subtle]] matches the {{color(#ff0000, WM_NAME)}} and the {{color(#0000ff, WM_CLASS)}} property of a window and not the title. This to ensure the match is correct. 

There are several ways to get these values, here are the most common:

Select the window with "xprop":http://www.xfree86.org/current/xprop.1.htmland have a look for the {{color(#ff0000, WM_NAME)}} and {{color(#0000ff, WM_CLASS)}} lines which usually look like this:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "urxvt"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

Run *[[subtler]] -cl* and look for the matching line:

<pre><code class="bash">0x800007 * 1 1020x374 2 1 --- {{color(#ff0000, urxvt)}} ({{color(#0000ff,URxvt)}})</code></pre>

h2.  How does subtle match clients?

[[subtle]] matches the {{color(#ff0000, WM_NAME)}} and the {{color(#0000ff, WM_CLASS)}} property of a window and not the title. This to ensure the match is correct. 

There are several ways to get these values, here are the most common:

Select the window with "xprop":http://www.xfree86.org/current/xprop.1.htmland have a look for the {{color(#ff0000, WM_NAME)}} and {{color(#0000ff, WM_CLASS)}} lines which usually look like this:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "urxvt"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

Run *[[subtler]] -cl* and look for the matching line:

<pre><code class="bash">0x800007 * 1 1020x374 2 1 --- {{color(#ff0000, urxvt)}} ({{color(#0000ff,URxvt)}})</code></pre>

h2.  How can I use subtle without numpad?

Per default [[subtle]] uses the numpad, because it's easier to remind the different postions when you can see them. Generally this is just a suggestion, it's up to you to change the grabs to your needs - any keys will work. 

Keys that also have proven to work well are *q-w-e*, *a-s-d* and *y-x-c*:

<pre><code class="ruby">grab "W-q", [ :top_left,     :top_left66,     :top_left33     ]

grab "W-w", [ :top,          :top66,          :top33          ]

grab "W-e", [ :top_right,    :top_right66,    :top_right33    ]

grab "W-a", [ :left,         :left66,         :left33         ]

grab "W-s", [ :center,       :center66,       :center33       ]

grab "W-d", [ :right,        :right66,        :right33        ]

grab "W-y", [ :bottom_left,  :bottom_left66,  :bottom_left33  ]

grab "W-x", [ :bottom,       :bottom66,       :bottom33       ]

grab "W-c", [ :bottom_right, :bottom_right66, :bottom_right33 ]

</code></pre>

You can find more about assigning keys [[Grabs|here]].

h2.  How do I tag console based programs?

Generally [[subtle]] can apply [[Tagging|tags]] based on the {{color(#0000ff, WM_NAME)}} and both {{color(#ff0000, WM_CLASS)}} components. Console based programs like "irssi":http://irssi.org can be started like this and will change the {{color(#0000ff, WM_NAME)}} of the terminal:

<pre><code class="bash">urxvt -e irssi</code></pre>

Inspecting the terminal with "xprop":http://www.xfree86.org/current/xprop.1.html:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "urxvt")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

So if we want to tag this window there are some things that should be considered:

* "irssi":http://irssi.org updates the {{color(#0000ff, WM_NAME)}} only

* [[Tagging]] matches per default both {{color(#ff0000, WM_CLASS)}} components ({{color(#aa0000, instance)}} and {{color(#ff00ff, class)}} name)

* [[Tagging|Tags]] are applied when a window is mapped - that is *before* the terminal launches "irssi":http://irssi.org

To safely [[Tagging|tag]] it's better to change the {{color(#aa0000, instance)}} name of the terminal like this:

<pre><code class="bash">urxvt -name irssi -e irssi</code></pre>

This results in following (via "xprop":http://www.xfree86.org/current/xprop.1.html):

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

A [[Tagging|tag]] for this could be:

<pre><code class="ruby">tag "irssi" do

  match "irssi"

end</code></pre>

Please keep in mind, that the {{color(#ff0000, WM_CLASS)}} {{color(#ff00ff, class)}} name is still *URxvt* and will match other [[Tagging|tags]] too.

h2.  How do I tag console based programs?

Generally [[subtle]] can apply [[Tagging|tags]] based on the {{color(#0000ff, WM_NAME)}} and both {{color(#ff0000, WM_CLASS)}} components. Console based programs like "irssi":http://irssi.org can be started like this and will change the {{color(#0000ff, WM_NAME)}} of the terminal:

<pre><code class="bash">urxvt -e irssi</code></pre>

Inspecting the terminal with "xprop":http://www.xfree86.org/current/xprop.1.html:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "urxvt")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

So if we want to tag this window there are some things that should be considered:

* "irssi":http://irssi.org updates the {{color(#0000ff, WM_NAME)}} only

* [[Tagging]] matches per default both {{color(#ff0000, WM_CLASS)}} components ({{color(#aa0000, instance)}} and {{color(#ff00ff, class)}} name)

* [[Tagging|Tags]] are applied when a window is mapped - that is *before* the terminal launches "irssi":http://irssi.org

To safely [[Tagging|tag]] it's better to change the {{color(#aa0000, instance)}} name of the terminal like this:

<pre><code class="bash">urxvt -name irssi -e irssi</code></pre>

This results in following (via "xprop":http://www.xfree86.org/current/xprop.1.html):

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

A [[Tagging|tag]] for this could be:

<pre><code class="ruby">tag "irssi" do

  match :instance => "irssi"

end</code></pre>

Please keep in mind, that the {{color(#ff0000, WM_CLASS)}} {{color(#ff00ff, class)}} name is still *URxvt* and will match other [[Tagging|tags]] too.

h2.  How do I run a program on startup?

Let's say you want urxvt to start after subtle, and for some reason @echo "urxvt" >> ~/.xinitrc@ is just not cutting it. Using the :start hook and Subtlext we can simulate autostart like so:

<pre>

on :start do

  Subtlext::Subtle.spawn "urxvt"

end

</pre>

h2.  How can I use subtle without numpad?

Per default [[subtle]] uses the numpad, because it's easier to remind the different postions when you can see them. Generally this is just a suggestion, it's up to you to change the grabs to your needs - any keys will work. 

Keys that also have proven to work well are *q-w-e*, *a-s-d* and *y-x-c*:

<pre><code class="ruby">grab "W-q", [ :top_left,     :top_left66,     :top_left33     ]

grab "W-w", [ :top,          :top66,          :top33          ]

grab "W-e", [ :top_right,    :top_right66,    :top_right33    ]

grab "W-a", [ :left,         :left66,         :left33         ]

grab "W-s", [ :center,       :center66,       :center33       ]

grab "W-d", [ :right,        :right66,        :right33        ]

# QWERTZ

grab "W-y", [ :bottom_left,  :bottom_left66,  :bottom_left33  ]

# QWERTY

grab "W-z", [ :bottom_left,  :bottom_left66,  :bottom_left33  ]

grab "W-x", [ :bottom,       :bottom66,       :bottom33       ]

grab "W-c", [ :bottom_right, :bottom_right66, :bottom_right33 ]

</code></pre>

You can find more about assigning keys [[Grabs|here]].

h2.  How do I tag console based programs?

Generally [[subtle]] can apply [[Tagging|tags]] based on the {{color(#0000ff, WM_NAME)}} and both {{color(#ff0000, WM_CLASS)}} components. Console based programs like "irssi":http://irssi.org can be started like this and will change the {{color(#0000ff, WM_NAME)}} of the terminal:

<pre><code class="bash">urxvt -e irssi</code></pre>

Inspecting the terminal with "xprop":http://www.xfree86.org/current/xprop.1.html:

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "urxvt")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

So if we want to tag this window there are some things that should be considered:

* "irssi":http://irssi.org updates the {{color(#0000ff, WM_NAME)}} only

* [[Tagging]] matches per default both {{color(#ff0000, WM_CLASS)}} components ({{color(#aa0000, instance)}} and {{color(#ff00ff, class)}} name)

* [[Tagging|Tags]] are applied when a window is mapped - that is *before* the terminal launches "irssi":http://irssi.org

To safely [[Tagging|tag]] it's better to change the {{color(#aa0000, instance)}} name of the terminal like this:

<pre><code class="bash">urxvt -name irssi -e irssi</code></pre>

This results in following (via "xprop":http://www.xfree86.org/current/xprop.1.html):

<pre><code class="bash">{{color(#0000ff, WM_NAME)}}(STRING) = "irssi"

{{color(#ff0000, WM_CLASS)}}(STRING) = {{color(#aa0000, "irssi")}}, {{color(#ff00ff, "URxvt")}}</code></pre>

A [[Tagging|tag]] for this could be:

<pre><code class="ruby">tag "irssi" do

  match :instance => "irssi"

end</code></pre>

Please keep in mind, that the {{color(#ff0000, WM_CLASS)}} {{color(#ff00ff, class)}} name is still *URxvt* and will match other [[Tagging|tags]] too. To avoid that there is the *exclude* match, it works similar to the normal match but excludes certain windows:

<pre><code class="ruby">tag "terms" do

  exclude :instance => "irssi"

end</code></pre>

h2.  Why does program XYZ appears/turns as/to a gray canvas?

Generally, this happens, when a program needs a specific aspect ratio and [[subtle]] sets a gravity that violates this. Windows can tell the window manager about this kind of preferences via their size hints and [[subtle]] can honor those:

# Enable size hints globally with the _:resize_ option

  <pre>{{hide}}<code class="ruby">set :resize, true</code></pre>

# Enable this per program via [[tagging|tag]]

  <pre>{{hide}}<code class="ruby">tag "name"

  match  "name"

  resize true

end

h2.  How can I delete a sublet manually?

[[Sublets]] usually consist of a **.rb* file, a **.spec* file and one or more icons. All these files can be found in their respective folder in @$XDG_DATA_HOME/subtle@ resp. @~/.local/share/subtle@. After deleting the [[sublets|sublet]] files the cache of [[sur]] needs to be updated or otherwise [[sur]] will think the [[sublets|sublet]] is still installed: @sur update -l@

h2.  How can I manually delete a sublet?

[[Sublets]] usually consist of a **.rb* file, a **.spec* file and one or more icons. All these files can be found in their respective folder in @$XDG_DATA_HOME/subtle@ resp. @~/.local/share/subtle@. After deleting the [[sublets|sublet]] files the cache of [[sur]] needs to be updated or otherwise [[sur]] will think the [[sublets|sublet]] is still installed: @sur update -l@

h2.  Where is the output window of flash in fullscreen?

For flash, browsers seem to use window instance and class names that doesn't match the browser values. Therefore the windows will usually appear on the default view.

Following names are currently in use:

|_. Browser |_. WM_NAME            |_. WM_CLASS                                 |

| Firefox   | <unknown>            | "<unknown>", "<unknown>"                   |

| Chromium  | exe                  | "exe", "Exe"                               |

| Opera     | "operapluginwrapper" | "operapluginwrapper", "Operapluginwrapper" |

The easiest way to avoid that is to add a [[tagging|tag]] that makes these windows sticky:

<pre>{{hide}}<code class="ruby">tag "flash" do

  match "<unkown>|exe|operapluginwrapper"

  stick true

end</code></pre>

h2.  How do I run a program on startup/autostart?

Let's say you want "urxvt":http://software.schmorp.de/pkg/rxvt-unicode.html to start after [[subtle]], and for some reason @echo "urxvt" >> ~/.xinitrc@ is just not cutting it. Using the *:start* hook and [[subtlext]] we can simulate autostart like so:

<pre>{{hide}}<code class="ruby">

on :start do

  Subtlext::Subtle.spawn "urxvt"

end

</pre></code>

h2.  How do I start program xyz?

There are several way how to start a certain programm, here are the most common:

* Start your program via your $HOME/.xinitrc:

<pre><code class="ruby">

subtle &

PID=$!

sleep 2

urxvt

wait $PID

</code></pre>

* Start your program via [[grabs]]:

<pre><code class="ruby">

"A-x" => "urxvt"

</code></pre>

Additionally there are many launchers available like "dmenu":http://tools.suckless.org/dmenu and there is even a launcher especially designed for [[subtle]], you can find it in "subtle-contrib":http://subforge.org/projects/subtle-contrib/wiki#Launcher.

h2.  How do I start program XYZ?

There are several way how to start a certain programm, here are the most common:

* Start your program via your $HOME/.xinitrc:

<pre><code class="ruby">

subtle &

PID=$!

sleep 2

urxvt

wait $PID

</code></pre>

* Start your program via [[grabs]]:

<pre><code class="ruby">

"A-x" => "urxvt"

</code></pre>

Additionally there are many launchers available like "dmenu":http://tools.suckless.org/dmenu and there is even a launcher especially designed for [[subtle]], you can find it in "subtle-contrib":http://subforge.org/projects/subtle-contrib/wiki#Launcher.

h2.  Why does program XYZ appears/turns as/to a gray canvas?

Generally, this happens, when a program needs a specific aspect ratio and [[subtle]] sets a gravity that violates this. Windows can tell the window manager about this kind of preferences via their size hints and [[subtle]] can honor those.

There are two possible ways:

# Enable size hints globally with the _:resize_ option

  <pre>{{hide}}<code class="ruby">set :resize, true</code></pre>

# Enable this per program via [[tagging|tag]]

  <pre>{{hide}}<code class="ruby">tag "name"

  match  "name"

  resize true

end

h2.  Why does program XYZ appears/turns as/to a gray canvas?

Generally, this happens, when a program needs a specific aspect ratio and [[subtle]] sets a gravity that violates this. Windows can tell the window manager about this kind of preferences via their size hints and [[subtle]] can honor those.

There are two possible ways:

# Enable size hints globally with the _:resize_ option

  <pre>{{hide}}<code class="ruby">set :resize, true</code></pre>

# Enable this per program via [[tagging|tag]]

  <pre>{{hide}}<code class="ruby">tag "name"

  match  "name"

  resize true

end

h2.  How do I run a java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to MToolkit, which is known to work with non-reparenting windows managers like [[subtle]]. Depending on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

In case both doesn't work there is a third option: The JDK internally uses a hardcoded list of window managers that are non-reparenting, the "suckless":http://suckless.org guys made the tool "wmname":http://tools.suckless.org/wmname to change the name of the wm and just lie to Java. 

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

h2.  How do I set a wallpaper in subtle?

On start, [[subtle]] sets a background color (_if set_) to the root window and therefore *overwrites* any root pixmap set before. To avoid this, you just need to comment out the *:background* line from your config.

[[subtle]] itself has no and will never have either an autostart or way to set a wallpaper directly. Normally you just want to setup your X session and and not [[subtle]]. Your _~/.xinitrc_ is the right place for stuff like this.

A background can easily set with a tool like "feh":http://linuxbrit.co.uk/software/feh/.

h2.  How can I use subtle without numpad?

Per default [[subtle]] uses the numpad, because it's easier to remind the different postions when you can see them. Generally this is just a suggestion, it's up to you to change the grabs to your needs - any keys will work. 

Keys that also have proven to work well are *q-w-e*, *a-s-d* and *y-x-c*:

<pre>{{hide}}<code class="ruby">grab "W-q", [ :top_left,     :top_left66,     :top_left33     ]

grab "W-w", [ :top,          :top66,          :top33          ]

grab "W-e", [ :top_right,    :top_right66,    :top_right33    ]

grab "W-a", [ :left,         :left66,         :left33         ]

grab "W-s", [ :center,       :center66,       :center33       ]

grab "W-d", [ :right,        :right66,        :right33        ]

# QWERTZ

grab "W-y", [ :bottom_left,  :bottom_left66,  :bottom_left33  ]

# QWERTY

grab "W-z", [ :bottom_left,  :bottom_left66,  :bottom_left33  ]

grab "W-x", [ :bottom,       :bottom66,       :bottom33       ]

grab "W-c", [ :bottom_right, :bottom_right66, :bottom_right33 ]

</code></pre>

You can find more about assigning keys [[Grabs|here]].

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[tagging]]. There are many ways to change tags per runtime, common is to use either [[subtler]] or [[subtlext]].

h2.  subtler

[[subtler]] can be used on the commandline:

<pre>{{hide}}<code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

h2.  subtlext

[[subtlext]] requires basic "ruby":http://ruby-lang.org knowledge:

<pre>{{hide}}<code class="ruby">require "subtle/subtlext"

tag = Subtlext::Tag.new("tag").save  #< Add new tag 'tag'

Subtlext::Client["client"] + "tag"   #< Tag client 'client' with tag 'tag'

Subtlext::View["view"] + "tag"       #< Tag view 'view' with tag 'tag'

</code></pre>

h2.  Snippets

The [[snippets]] wiki page includes examples how to "move":http://subforge.org/wiki/subtle/Snippets#Move-windows windows to another view.

h2.  Contrib

h3. Vitag

"subtle-contrib":http://subforge.org/projects/subtle-contrib/wiki contains "vitag":http://subforge.org/projects/subtle-contrib/wiki#Vitag, a script to change the [[tagging|tags]] of windows and views with an editor.

h3. Launcher

The "launcher":http://subforge.org/projects/subtle-contrib/wiki#Launcher uses quite the opposite way, instead of moving a window to a certain screen it just provides a way to launch a window directly on the right view with the correct [[tagging|tags]].

h2.  Stick

Most of the time, setting the window to *stick* does the trick too. Stick just displays the window on all views until the mode is disabled again. This can be done with [[grabs]] (default keys: W-s) or with [[subtler]]. (click on the window: subtler -cXS)

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via the [[tagging]]. There are many ways to change tags per runtime, common is to use either [[subtler]] or [[subtlext]].

h2.  subtler

[[subtler]] can be used on the commandline:

<pre>{{hide}}<code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

h2.  subtlext

[[subtlext]] requires basic "ruby":http://ruby-lang.org knowledge:

<pre>{{hide}}<code class="ruby">require "subtle/subtlext"

tag = Subtlext::Tag.new("tag").save  #< Add new tag 'tag'

Subtlext::Client["client"] + "tag"   #< Tag client 'client' with tag 'tag'

Subtlext::View["view"] + "tag"       #< Tag view 'view' with tag 'tag'

</code></pre>

h2.  Snippets

The [[snippets]] wiki page includes examples how to "move":http://subforge.org/wiki/subtle/Snippets#Move-windows windows to another view.

h2.  Contrib

h3. Vitag

"subtle-contrib":http://subforge.org/projects/subtle-contrib/wiki contains "vitag":http://subforge.org/projects/subtle-contrib/wiki#Vitag, a script to change the [[tagging|tags]] of windows and views with an editor.

h3. Launcher

The "launcher":http://subforge.org/projects/subtle-contrib/wiki#Launcher uses quite the opposite way, instead of moving a window to a certain screen it just provides a way to launch a window directly on the right view with the correct [[tagging|tags]].

h2.  Stick

Most of the time, setting the window to *stick* does the trick too. Stick just displays the window on all views until the mode is disabled again. This can be done with [[grabs]] (default keys: *W-s*) or with [[subtler]]. (click on the window: @subtler -cXS@)

h2.  How do I move program xyz to view abc?

Placement in [[subtle]] is +strict+ and completely done via [[tagging]]. There are many ways to change [[tagging|tags]] per runtime, common is to use either [[subtler]] or [[subtlext]].

h2.  subtler

[[subtler]] can be used on the commandline:

<pre>{{hide}}<code class="ruby">

subtler -ta tag         #< Add new tag 'tag'

subtler -cT client tag  #< Tag client 'client' with tag 'tag'

subtler -vT view tag    #< Tag view 'view' with tag 'tag'

</code></pre>

h2.  subtlext

[[subtlext]] requires basic "ruby":http://ruby-lang.org knowledge:

<pre>{{hide}}<code class="ruby">require "subtle/subtlext"

tag = Subtlext::Tag.new("tag").save  #< Add new tag 'tag'

Subtlext::Client["client"] + "tag"   #< Tag client 'client' with tag 'tag'

Subtlext::View["view"] + "tag"       #< Tag view 'view' with tag 'tag'

</code></pre>

h2.  Snippets

The [[snippets]] wiki page includes examples how to "move":http://subforge.org/wiki/subtle/Snippets#Move-windows windows to another view.

h2.  Contrib

h3. Vitag

"subtle-contrib":http://subforge.org/projects/subtle-contrib/wiki contains "vitag":http://subforge.org/projects/subtle-contrib/wiki#Vitag, a script to change the [[tagging|tags]] of windows and views with an editor.

h3. Launcher

The "launcher":http://subforge.org/projects/subtle-contrib/wiki#Launcher uses quite the opposite way, instead of moving a window to a certain screen it just provides a way to launch a window directly on the right view with the correct [[tagging|tags]].

h2.  Stick

Most of the time, setting the window to *stick* does the trick too. Stick just displays the window on all views until the mode is disabled again. This can be done with [[grabs]] (default keys: *W-s*) or with [[subtler]]. (click on the window: @subtler -cXS@)

h2.  How do I run a java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to _MToolkit_, which is known to work with non-reparenting windows managers like [[subtle]]. Depending on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

In case both doesn't work there is a third option: The JDK internally uses a hardcoded list of window managers that are non-reparenting, the "suckless":http://suckless.org guys made the tool "wmname":http://tools.suckless.org/wmname to change the name of the wm and just lie to Java. 

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

bq. Note: Many problems only affect the "JRE":http://www.oracle.com/technetwork/java/javase/downloads/index.html and can be avoided by using the "OpenJDK":http://openjdk.java.net.

h2.  Why does program XYZ appears/turns as/to a gray canvas?

Generally, this happens, when a program needs a specific aspect ratio and [[subtle]] sets a gravity that violates this. Windows can tell the window manager about this kind of preferences via their size hints and [[subtle]] can honor those.

There are two possible ways:

# Enable size hints globally with the _:resize_ option

  <pre>{{hide}}<code class="ruby">set :resize, true</code></pre>

# Enable this per program via [[tagging|tag]]

  <pre>{{hide}}<code class="ruby">tag "name"

  match  "name"

  resize true

end

.bq Note: This can happen with "java":http://java.com too, see "here":http://subforge.org/ezfaq/show/subtle?faq_id=14 for more information.

h2.  How do I run a Java program?

"Java":http://java.com *expects* a certain behaviour (_reparenting of client windows_) of a window manager which is not part of any standard, therefore some "Java":http://java.com programs just show a white canvas.

If this happens just try to start your program like this:

<pre><code class="shell">AWT_TOOLKIT=MToolkit program</code></pre>

This changes the default tookit of "Java":http://java.com to _MToolkit_, which is known to work with non-reparenting windows managers like [[subtle]]. Depending on your "OpenJDK":http://openjdk.java.net version and your architecture this may either lead to a segmentation fault or your "OpenJDK":http://openjdk.java.net just has no support for *MToolkit*. In this case check if your distribution has applied a patch for this issue which allows something like this to change the default behaviour:

<pre><code class="shell">_JAVA_AWT_WM_NONREPARENTING=1 program</code></pre>

In case both doesn't work there is a third option: The JDK internally uses a hardcoded list of window managers that are non-reparenting, the "suckless":http://suckless.org guys made the tool "wmname":http://tools.suckless.org/wmname to change the name of the wm and just lie to Java. 

Generally this problem is really long lasting, see here: 

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6511454

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508650

bq. Note: Many problems only affect the "JRE":http://www.oracle.com/technetwork/java/javase/downloads/index.html and can be avoided by using the "OpenJDK":http://openjdk.java.net.

h2.  Why does program XYZ appears/turns as/to a gray canvas?

Generally, this happens, when a program needs a specific aspect ratio and [[subtle]] sets a gravity that violates this. Windows can tell the window manager about this kind of preferences via their size hints and [[subtle]] can honor those.

There are two possible ways:

# Enable size hints globally with the _:resize_ option

  <pre>{{hide}}<code class="ruby">set :resize, true</code></pre>

# Enable this per program via [[tagging|tag]]

  <pre>{{hide}}<code class="ruby">tag "name"

  match  "name"

  resize true

end</code></pre>

bq. Note: This can happen with "java":http://java.com too, see "here":http://subforge.org/ezfaq/show/subtle?faq_id=14 for more information.

h2.  Why does program XYZ appears/turns as/to a gray canvas?

Generally, this happens, when a program needs a specific aspect ratio and [[subtle]] sets a gravity that violates this. Windows can tell the window manager about this kind of preferences via their size hints and [[subtle]] can honor those.

There are two possible ways:

# Enable size hints globally with the _:resize_ option

  <pre>{{hide}}<code class="ruby">set :resize, true</code></pre>

# Enable this per program via [[tagging|tag]]

  <pre>{{hide}}<code class="ruby">tag "name"

  match  "name"

  resize true

end</code></pre>