Subtle-contrib¶

• Subtle-contrib
  • Graviton
    • Usage
    • Colors
  • Launcher
    • Features
    • Usage
    • Examples
  • Styler
    • Usage
  • Vitag
    • Usage
    • Examples

Collection of contributed scripts, some are more useful than other.

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

hg clone http://hg.subforge.org/subtle-contrib

Graviton¶

Graviton is a helper to create custom gravities visually.

Usage¶

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

Colors¶

Following colors are used in Graviton in given order:

cyan green olive teal blue silver lime navy purple magenta maroon red yellow gray

Launcher¶

Launcher that combines the tagging of subtle with a browser search bar.

Features¶

• Search for stuff via Google (Chrome/Opera/Firefox)
• Point your browser directly to an uri
• Launch programs in path
• Create tags on the fly with #tag
• Create views on the fly with @view
• Set modes on the fly with + = full, ^ = float and * = stick
• Tab completion for programs, views and tags

Usage¶

Either call it like ruby launcher.rb from commandline or via grab from subtle.

Numbers: on /off 1 begin
 2   require "#{ENV["HOME"]}/path/to/launcher.rb" 
 3 
 4   # Set fonts
 5   Subtle::Contrib::Launcher.fonts = [
 6     "xft:DejaVu Sans Mono:pixelsize=80:antialias=true",
 7     "xft:DejaVu Sans Mono:pixelsize=12:antialias=true" 
 8   ]
 9 rescue LoadError => error
10   puts error
11 end
12 
13 grab "W-x" do
14   Subtle::Contrib::Launcher.run
15 end

Examples¶

Insert	Description
subtle wm	Change to browser view and search for subtle wm via Google
urxvt @editor	Open urxvt on view @editor with dummy tag
urxvt @editor #work	Open urxvt on view @editor with tag work
urxvt #work	Open urxvt and tag with tag work
+urxvt	Open urxvt and set full mode
^urxvt	Open urxvt and set floating mode
*urxvt	Open urxvt and set sticky mode
urx<hit tab>	Open urxvt (tab completion)

Styler¶

Helper to create or change subtle color themes.

Usage¶

Start Styler on the commandline via ruby styler.rb. It will display a preview of the current colors of subtle and various color buttons to change them via a color chooser.

The print button will show the new colors on the commandline.

Vitag¶

Vitag is a helper to edit window/view tagging with any $EDITOR

Usage¶

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 in one single event per view/client and non-existing tags will be created accordingly.

Examples¶

# Views
@terms #default #terms
@www #browser
@gimp #gimp_image #gimp_toolbox #gimp_dock
@dev #editor

# Clients
xterm #terms