Wiki

Version 25 (Christoph Kappel, 2011-01-02 17:48)

1 2 Christoph Kappel
h1. Subtle-contrib
2 2 Christoph Kappel

                
3 13 Christoph Kappel
{{>toc}}
4 13 Christoph Kappel

                
5 23 Christoph Kappel
Contrib is just a collection of scripts for "subtle":http://subtle.subforge.org, currently there is no package available and you need to clone the repository to a place you are comfortable with:
6 1

                
7 1
bq. hg clone http://hg.subforge.org/subtle-contrib
8 4 Christoph Kappel

                
9 23 Christoph Kappel
_These scripts may work, if you encounter any problems please ask in the usual places._
10 23 Christoph Kappel

                
11 13 Christoph Kappel
h2. Graviton
12 13 Christoph Kappel

                
13 15 Christoph Kappel
Graviton is a helper to create custom gravities visually.
14 13 Christoph Kappel

                
15 13 Christoph Kappel
{{lightbox(contrib/graviton, Graviton)}}
16 1

                
17 15 Christoph Kappel
h3. Usage
18 15 Christoph Kappel

                
19 23 Christoph Kappel
Start "Graviton":http://subforge.org/projects/subtle-contrib/wiki/Wiki/edit#Graviton on the commandline via @ruby [email protected] Then just draw rectangles on the grid like e.g. via the rectangular masking tool from "GIMP":http://www.gimp.org/. Every new rectangle will have a different color to make it easier to distingish between each. To resize a rectangle press the left mouse button on one of the corners and move the mouse.
20 1

                
21 25 Christoph Kappel
The *print* button will display the created new gravities with their color name in a format that can be used in the config of "subtle":http://subtle.subforge.org.
22 17 Christoph Kappel

                
23 15 Christoph Kappel
h3. Colors
24 15 Christoph Kappel

                
25 15 Christoph Kappel
Following colors are used in "Graviton":http://subforge.org/projects/subtle-contrib/wiki/Wiki/edit#Graviton in given order:
26 15 Christoph Kappel

                
27 22 Christoph Kappel
{{color(#00FFFF, cyan)}}
28 22 Christoph Kappel
{{color(#008000, green)}}
29 22 Christoph Kappel
{{color(#808000, olive)}}
30 22 Christoph Kappel
{{color(#008080, teal)}}
31 22 Christoph Kappel
{{color(#0000FF, blue)}}
32 22 Christoph Kappel
{{color(#C0C0C0, silver)}}
33 22 Christoph Kappel
{{color(#00FF00, lime)}}
34 21 Christoph Kappel
{{color(#000080, navy)}}
35 22 Christoph Kappel
{{color(#800080, purple)}}
36 22 Christoph Kappel
{{color(#FF00FF, magenta)}}
37 22 Christoph Kappel
{{color(#800000, maroon)}}
38 22 Christoph Kappel
{{color(#FF0000, red)}}
39 22 Christoph Kappel
{{color(#FFFF00, yellow)}}
40 22 Christoph Kappel
{{color(#808080, gray)}}
41 13 Christoph Kappel

                
42 2 Christoph Kappel
h2. Launcher
43 1

                
44 24 Christoph Kappel
Launcher that combines modes/tagging of "subtle":http://subtle.subforge.org with a browser search bar.
45 2 Christoph Kappel

                
46 2 Christoph Kappel
{{lightbox(contrib/launcher, Launcher)}}
47 2 Christoph Kappel

                
48 2 Christoph Kappel
h3. Features
49 2 Christoph Kappel

                
50 2 Christoph Kappel
* Search for stuff via "Google":http://www.google.com (Chrome/Opera/Firefox)
51 2 Christoph Kappel
* Point your browser directly to an uri
52 6 Christoph Kappel
* Launch programs in path
53 2 Christoph Kappel
* Create tags on the fly with *#tag*
54 2 Christoph Kappel
* Create views on the fly with *@view*
55 19 Christoph Kappel
* Set modes on the fly with *+* = full, *^* = float and *** = stick
56 2 Christoph Kappel
* Tab completion for programs, views and tags
57 2 Christoph Kappel

                
58 14 Christoph Kappel
h3. Usage
59 14 Christoph Kappel

                
60 23 Christoph Kappel
Either call it like @ruby [email protected] from commandline or add following loader and "grab":http://subforge.org/wiki/subtle/Grabs to your "subtle":http://subtle.subforge.org config.
61 14 Christoph Kappel

                
62 16 Christoph Kappel
<pre>{{hide}}<code class="ruby">
63 18 Christoph Kappel
begin
64 14 Christoph Kappel
  require "#{ENV["HOME"]}/path/to/launcher.rb"
65 19 Christoph Kappel

                
66 19 Christoph Kappel
  # Set fonts
67 19 Christoph Kappel
  Subtle::Contrib::Launcher.fonts = [
68 19 Christoph Kappel
    "xft:DejaVu Sans Mono:pixelsize=80:antialias=true",
69 19 Christoph Kappel
    "xft:DejaVu Sans Mono:pixelsize=12:antialias=true"
70 19 Christoph Kappel
  ]
71 14 Christoph Kappel
rescue LoadError => error
72 18 Christoph Kappel
  puts error
73 14 Christoph Kappel
end
74 16 Christoph Kappel

                
75 1
grab "W-x" do
76 19 Christoph Kappel
  Subtle::Contrib::Launcher.run
77 16 Christoph Kappel
end
78 14 Christoph Kappel
</code></pre>
79 14 Christoph Kappel

                
80 2 Christoph Kappel
h3. Examples
81 3 Christoph Kappel

                
82 12 Christoph Kappel
|_. Insert             |_. Description                                                                    |
83 12 Christoph Kappel
| subtle wm            | Change to browser view and search for _subtle wm_ via "Google":http://google.com |
84 12 Christoph Kappel
| urxvt @editor        | Open urxvt on view @editor with dummy tag                                        |
85 12 Christoph Kappel
| urxvt @editor #work  | Open urxvt on view @editor with tag _work_                                       |
86 1
| urxvt #work          | Open urxvt and tag with tag _work_                                               |
87 19 Christoph Kappel
| +urxvt               | Open urxvt and set full mode                                                     |
88 19 Christoph Kappel
| ^urxvt               | Open urxvt and set floating mode                                                 |
89 19 Christoph Kappel
| *urxvt               | Open urxvt and set sticky mode                                                   |
90 12 Christoph Kappel
| urx<hit tab>         | Open urxvt (tab completion)                                                      |
91 2 Christoph Kappel

                
92 2 Christoph Kappel

                
93 2 Christoph Kappel
h2. Styler
94 2 Christoph Kappel

                
95 2 Christoph Kappel
Helper to create or change "subtle":http://subtle.subforge.org color themes.
96 1

                
97 1
{{lightbox(contrib/styler, Styler)}}
98 1

                
99 17 Christoph Kappel
h3. Usage
100 17 Christoph Kappel

                
101 25 Christoph Kappel
Start "Styler":http://subforge.org/projects/subtle-contrib/wiki/Wiki/edit#Styler on the commandline via @ruby [email protected] It will display a preview of the current colors of "subtle":http://subtle.subforge.org and various color buttons to change them via a color chooser.
102 17 Christoph Kappel

                
103 17 Christoph Kappel
The *print* button will show the new colors on the commandline.
104 17 Christoph Kappel

                
105 8 Christoph Kappel
h2. Vitag
106 1

                
107 25 Christoph Kappel
Vitag is a helper to edit window/view tagging with any editor (*$EDITOR*)
108 17 Christoph Kappel

                
109 17 Christoph Kappel
h3. Usage
110 17 Christoph Kappel

                
111 25 Christoph Kappel
Helper that provides a way to change the tags of all views and windows at once. It basically just opens your favorite editor via editor set in *$EDITOR* and prints every view and running client followed by it's tags. When the tags are changed and the file saved it will send the changes to "subtle":http://subtle.subforge.org in one single event per view/client and non-existing tags will be created accordingly.
112 9 Christoph Kappel

                
113 17 Christoph Kappel
h3. Examples
114 1

                
115 11 Christoph Kappel
<pre><code># Views
116 11 Christoph Kappel
@terms #default #terms
117 11 Christoph Kappel
@www #browser
118 11 Christoph Kappel
@gimp #gimp_image #gimp_toolbox #gimp_dock
119 11 Christoph Kappel
@dev #editor
120 10 Christoph Kappel

                
121 11 Christoph Kappel
# Clients
122 11 Christoph Kappel
xterm #terms
123 10 Christoph Kappel
</code></pre>