Wiki

Version 17 (Christoph Kappel, 2010-11-30 22:33)

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 17 Christoph Kappel
Start "Graviton":http://subforge.org/projects/subtle-contrib/wiki/Wiki/edit#Graviton on the commandline via _ruby graviton.rb_. 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 17 Christoph Kappel
The *print* button will show the created new gravities with their color name on the commandline.
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 15 Christoph Kappel
{{color(#00FFFF, cyan)}}
28 15 Christoph Kappel
{{color(#008000, green)}}
29 15 Christoph Kappel
{{color(#808000, olive)}}
30 15 Christoph Kappel
{{color(#008080, teal)}}
31 15 Christoph Kappel
{{color(#0000FF, blue)}}
32 15 Christoph Kappel
{{color(#C0C0C0, silver)}}
33 15 Christoph Kappel
{{color(#00FF00, lime)}}
34 15 Christoph Kappel
{{color(#000080, navy)}}
35 15 Christoph Kappel
{{color(#800080, purple)}}
36 15 Christoph Kappel
{{color(#FF00FF, magenta)}}
37 15 Christoph Kappel
{{color(#800000, maroon)}}
38 15 Christoph Kappel
{{color(#FF0000, red)}}
39 15 Christoph Kappel
{{color(#FFFF00, yellow)}}
40 15 Christoph Kappel
{{color(#808080, gray)}}
41 13 Christoph Kappel

                
42 2 Christoph Kappel
h2. Launcher
43 1

                
44 13 Christoph Kappel
Launcher that combines the 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 2 Christoph Kappel
* Tab completion for programs, views and tags
56 2 Christoph Kappel

                
57 14 Christoph Kappel
h3. Usage
58 14 Christoph Kappel

                
59 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.
60 14 Christoph Kappel

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

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

                
73 2 Christoph Kappel
h3. Examples
74 3 Christoph Kappel

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

                
82 2 Christoph Kappel

                
83 2 Christoph Kappel
h2. Styler
84 2 Christoph Kappel

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

                
87 1
{{lightbox(contrib/styler, Styler)}}
88 1

                
89 17 Christoph Kappel
h3. Usage
90 17 Christoph Kappel

                
91 17 Christoph Kappel
Start "Styler":http://subforge.org/projects/subtle-contrib/wiki/Wiki/edit#Styler on the commandline via _ruby styler.rb_. 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.
92 17 Christoph Kappel

                
93 17 Christoph Kappel
The *print* button will show the new colors on the commandline.
94 17 Christoph Kappel

                
95 2 Christoph Kappel
h2. Subtlefs
96 1

                
97 8 Christoph Kappel
Simple VFS implementation with the help of "Fuse":http://fuse.sourceforge.net.
98 8 Christoph Kappel

                
99 8 Christoph Kappel
h2. Vitag
100 1

                
101 17 Christoph Kappel
Vitag is a helper to edit window/view tagging with any $EDITOR
102 17 Christoph Kappel

                
103 17 Christoph Kappel
h3. Usage
104 17 Christoph Kappel

                
105 1
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.
106 9 Christoph Kappel

                
107 17 Christoph Kappel
h3. Examples
108 1

                
109 11 Christoph Kappel
<pre><code># Views
110 11 Christoph Kappel
@terms #default #terms
111 11 Christoph Kappel
@www #browser
112 11 Christoph Kappel
@gimp #gimp_image #gimp_toolbox #gimp_dock
113 11 Christoph Kappel
@dev #editor
114 10 Christoph Kappel

                
115 11 Christoph Kappel
# Clients
116 11 Christoph Kappel
xterm #terms
117 10 Christoph Kappel
</code></pre>