comparison README.txt @ 14:a62fbff067f8

start bringing this whole thing up to speed
author Jeff Hammel <jhammel@mozilla.com>
date Wed, 01 May 2013 06:56:12 -0700
parents 7328744920de
children 12db2d46722d
comparison
equal deleted inserted replaced
13:f11ce7b1a349 14:a62fbff067f8
1 smartopen 1 smartopen
2 ========= 2 =========
3 3
4 smartopen is a command line program that will transform text according 4 smartopen is a command line program that will transform text according
5 to handlers to URLs and open them 5 to handlers to URLs and open them
6
6 7
7 Usage 8 Usage
8 ----- 9 -----
9 10
10 ``smartopen --help`` displays the program usage: 11 ``smartopen --help`` displays the program usage:
41 URL: a resolvable URL 42 URL: a resolvable URL
42 Google: a google search 43 Google: a google search
43 Wikipedia: a Wikipedia article 44 Wikipedia: a Wikipedia article
44 GoogleMaps: an address in google maps 45 GoogleMaps: an address in google maps
45 46
47 etc.
48
46 49
47 Configuration 50 Configuration
48 ------------- 51 -------------
49 52
50 smartopen uses a configuration file that defines the order of the 53 smartopen uses a configuration file that defines the order of the
51 handlers and their behavior. 54 handlers and their behavior.
55
56 A simple example is shown here:
57 http://k0s.org/hg/smartopen/file/tip/smartopen.ini
52 58
53 59
54 Interfacing With Your Environment 60 Interfacing With Your Environment
55 --------------------------------- 61 ---------------------------------
56 62
57 While smartopen is useful of its own right, its utility may be 63 While smartopen is useful of its own right, its utility may be
58 enhanced by using as part of an environment. For instance, I run the 64 enhanced by using as part of an environment. For instance, I run the
59 fluxbox window manager which allows the use of hotkeys. By binding 65 fluxbox window manager which allows the use of hotkeys. By binding
60 smartopen to Ctrl+Alt+s and using xclip, I can open a URL that is 66 smartopen to ``Ctrl+Alt+s`` and using ``xclip``, I can open a URL that is
61 mappable to a smartopen handler with a keyboard shortcut. The 67 mappable to a smartopen handler with a keyboard shortcut. The
62 relevant line from my ~/.fluxbox/keys file reads: 68 relevant line from my ``~/.fluxbox/keys`` file reads:
63 69
64 Control Mod1 s :ExecCommand /home/jhammel/python/smartopen.py "$(xclip -o)" # smartopen 70 Control Mod1 s :ExecCommand /home/jhammel/python/smartopen.py "$(xclip -o)" # smartopen
65 71
66 72
73 ----
74
75
76 Posterity is gained...
77 ----------------------
78
79 I mostly wrote smartopen to help me. That it has.
80 However...a few things....
81
82 - better way of setting up handlers?
83 - really, i want to push down to choose what i think the handler is,
84 but only should we I release the hand that Jesus becomes Magic
85 (sorry, I hate the movie too)
86
87 ....and more?
88
89 Was reading about catfish....e.g.
90 http://www.addictivetips.com/ubuntu-linux-tips/catfish-file-searching-tool-for-ubuntu-linux/
91 ...
92
93 """
94 file search tool that support several different engines
95
96 A file search tool using different backends which is configurable via
97 the command line.
98
99 This program acts as a frontend for different file search engines.
100 The interface is intentionally lightweight and simple. But it takes
101 configuration options from the command line.
102
103 Currently find, locate, tracker, strigi, pinot, and beagle are
104 supported as backends
105 """.
106
107 Should smartopen....be a pluggable thing that takes text and finds
108 both *the handler* and *what to do with it*???
109
110 I mean, short of it being a neural network anyway....