Wiki

Version 20 (Christoph Kappel, 2011-01-02 17:07)

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 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 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.
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 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.
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 17 Christoph Kappel
Vitag is a helper to edit window/view tagging with any $EDITOR
108 17 Christoph Kappel

                
109 17 Christoph Kappel
h3. Usage
110 17 Christoph Kappel

                
111 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.
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>