Wiki

Version 16 (Christoph Kappel, 2010-11-30 22:25)

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

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

                
5 2 Christoph Kappel
Collection of contributed scripts, some are more useful than other.
6 2 Christoph Kappel

                
7 8 Christoph Kappel
These scripts may work, if you encounter any problems please ask in the usual places. You can just clone the repo:
8 4 Christoph Kappel

                
9 4 Christoph Kappel
bq. hg clone http://hg.subforge.org/subtle-contrib
10 4 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 15 Christoph Kappel
Start "Graviton":http://subforge.org/projects/subtle-contrib/wiki/Wiki/edit#Graviton on the commandline via _ruby graviton.rb_ 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. The *print* button will show the created new gravities with their color name on the commandline.
20 15 Christoph Kappel

                
21 15 Christoph Kappel
h3. Colors
22 15 Christoph Kappel

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

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

                
40 2 Christoph Kappel
h2. Launcher
41 1

                
42 13 Christoph Kappel
Launcher that combines the tagging of "subtle":http://subtle.subforge.org with a browser search bar.
43 2 Christoph Kappel

                
44 2 Christoph Kappel
{{lightbox(contrib/launcher, Launcher)}}
45 2 Christoph Kappel

                
46 2 Christoph Kappel
h3. Features
47 2 Christoph Kappel

                
48 2 Christoph Kappel
* Search for stuff via "Google":http://www.google.com (Chrome/Opera/Firefox)
49 2 Christoph Kappel
* Point your browser directly to an uri
50 6 Christoph Kappel
* Launch programs in path
51 2 Christoph Kappel
* Create tags on the fly with *#tag*
52 2 Christoph Kappel
* Create views on the fly with *@view*
53 2 Christoph Kappel
* Tab completion for programs, views and tags
54 2 Christoph Kappel

                
55 14 Christoph Kappel
h3. Usage
56 14 Christoph Kappel

                
57 14 Christoph Kappel
Either call it like @ruby [email protected] from commandline or via "grab":http://subforge.org/wiki/subtle/Grabs from "subtle":http://subtle.subforge.org.
58 14 Christoph Kappel

                
59 16 Christoph Kappel
<pre>{{hide}}<code class="ruby">
60 14 Christoph Kappel
begin<
61 14 Christoph Kappel
  require "#{ENV["HOME"]}/path/to/launcher.rb"
62 14 Christoph Kappel
rescue LoadError => error
63 14 Christoph Kappel
  puts error
64 14 Christoph Kappel
end<
65 14 Christoph Kappel

                
66 16 Christoph Kappel
grab "W-x" do
67 16 Christoph Kappel
  Launcher::Launcher.instance.run
68 16 Christoph Kappel
end
69 14 Christoph Kappel
</code></pre>
70 14 Christoph Kappel

                
71 2 Christoph Kappel
h3. Examples
72 3 Christoph Kappel

                
73 12 Christoph Kappel
|_. Insert             |_. Description                                                                    |
74 12 Christoph Kappel
| subtle wm            | Change to browser view and search for _subtle wm_ via "Google":http://google.com |
75 12 Christoph Kappel
| urxvt @editor        | Open urxvt on view @editor with dummy tag                                        |
76 12 Christoph Kappel
| urxvt @editor #work  | Open urxvt on view @editor with tag _work_                                       |
77 12 Christoph Kappel
| urxvt #work          | Open urxvt and tag with tag _work_                                               |
78 12 Christoph Kappel
| urx<hit tab>         | Open urxvt (tab completion)                                                      |
79 2 Christoph Kappel

                
80 2 Christoph Kappel

                
81 2 Christoph Kappel
h2. Styler
82 2 Christoph Kappel

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

                
85 1
{{lightbox(contrib/styler, Styler)}}
86 2 Christoph Kappel

                
87 4 Christoph Kappel
h2. Subtlefs
88 2 Christoph Kappel

                
89 1
Simple VFS implementation with the help of "Fuse":http://fuse.sourceforge.net.
90 8 Christoph Kappel

                
91 8 Christoph Kappel
h2. Vitag
92 8 Christoph Kappel

                
93 12 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_ 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.
94 9 Christoph Kappel

                
95 9 Christoph Kappel
Example:
96 1

                
97 11 Christoph Kappel
<pre><code># Views
98 11 Christoph Kappel
@terms #default #terms
99 11 Christoph Kappel
@www #browser
100 11 Christoph Kappel
@gimp #gimp_image #gimp_toolbox #gimp_dock
101 11 Christoph Kappel
@dev #editor
102 10 Christoph Kappel

                
103 11 Christoph Kappel
# Clients
104 11 Christoph Kappel
xterm #terms
105 10 Christoph Kappel
</code></pre>