Skip to main content

open text in a browser contextually

Project description


smartopen is a command line program that will transform text according
to handlers to URLs and open them


``smartopen --help`` displays the program usage:

Usage: smartopen [options]

-h, --help show this help message and exit
-c CONFIG, --config=CONFIG
config file to read
-u, --url print the first url handled
-a, --all print all handlers that match the query
name of the handler to use, in order
--print-handlers print all handlers in order they would be tried

smartopen reads text from standard input or command line arguments.
The handlers are then iterated through in a configurable order and, if
the handler can transform the text into a URL, the URL is then
processed. Unless otherwise specified by command line options
(e.g. --url, --all), the first matching URL is then opened in firefox.


smartopen has a pluggable system of configurable handlers. The
setuptools entry point ``[smartopen.locations]`` is an extension point
for the handlers. Several handlers come with smartopen, or you can
write your own.

URL: a resolvable URL
Google: a google search
Wikipedia: a Wikipedia article
GoogleMaps: an address in google maps



smartopen uses a configuration file that defines the order of the
handlers and their behavior.

A simple example is shown here:

Interfacing With Your Environment

While smartopen is useful of its own right, its utility may be
enhanced by using as part of an environment. For instance, I run the
fluxbox window manager which allows the use of hotkeys. By binding
smartopen to ``Ctrl+Alt+s`` and using ``xclip``, I can open a URL that is
mappable to a smartopen handler with a keyboard shortcut. The
relevant line from my ``~/.fluxbox/keys`` file reads:

Control Mod1 s :ExecCommand /home/jhammel/python/ "$(xclip -o)" # smartopen


Posterity is gained...

I mostly wrote smartopen to help me. That it has.
However...a few things....

- better way of setting up handlers?
- really, i want to push down to choose what i think the handler is,
but only should we I release the hand that Jesus becomes Magic
(sorry, I hate the movie too)

....and more?

Was reading about catfish....e.g.

file search tool that support several different engines

A file search tool using different backends which is configurable via
the command line.

This program acts as a frontend for different file search engines.
The interface is intentionally lightweight and simple. But it takes
configuration options from the command line.

Currently find, locate, tracker, strigi, pinot, and beagle are
supported as backends

Should a pluggable thing that takes text and finds
both *the handler* and *what to do with it*???

I mean, short of it being a neural network anyway....

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
smartopen-0.2.tar.gz (9.2 kB) Copy SHA256 hash SHA256 Source None May 1, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page