| nettime's_surfin_bird on Mon, 1 Feb 2016 23:52:37 +0100 (CET) |
[Date Prev] [Date Next] [Thread Prev] [Thread Next] [Date Index] [Thread Index]
| <nettime> Surfraw - Shell Users' Revolutionary Front Rage Against the Web |
< https://surfraw.alioth.debian.org/ >
______ _ _ ______ _______ ______ _______ _ _ _
/ _____)(_) (_)(_____ \ (_______)(_____ \ (_______)(_)(_)(_)
( (____ _ _ _____) ) _____ _____) ) _______ _ _ _
\____ \ | | | || __ / | ___) | __ / | ___ || || || |
_____) )| |___| || | \ \ | | | | \ \ | | | || || || |
(______/ \_____/ |_| |_||_| |_| |_||_| |_| \_____/
Surfraw - Shell Users' Revolutionary Front Rage Against the Web
[1]About Surfraw | [2]News | [3]List of Elvi | [4]Downloading |
[5]Installation | [6]Usage | [7]Configuration | [8]Development and
Support
Oh Baybee
I need some
Deep Linking
Let us go
Surfin' in the raw!
__________________________________________________________________
About Surfraw
Surfraw provides a fast unix command line interface to a variety of
popular WWW search engines and other artifacts of power. It reclaims
google, altavista, babelfish, dejanews, freshmeat, research index,
slashdot and [9]many others from the false-prophet, pox-infested
heathen lands of html-forms, placing these wonders where they belong,
deep in unix heartland, as god loving extensions to the shell.
Surfraw abstracts the browser away from input. Doing so lets it get on
with what it's good at. Browsing. Interpretation of linguistic forms is
handed back to the shell, which is what it, and human beings are good
at. Combined with [10]netscape-remote or incremental text browsers,
such as [11]lynx, [12]links or [13]w3m, along with [14]screen a Surfraw
liberateur is capable of navigating speeds that leave GUI tainted
idolaters agape with fear and wonder.
For example:
$ surfraw google -results=100 RMS, GNU, which is sinner, which is sin?
$ sr wikipedia surfraw
$ sr austlii -method=phrase dog like
$ /usr/lib/surfraw/rhyme -method=perfect Julian
__________________________________________________________________
News
Current surfraw version: [15]2.2.9
Tue Dec 10 15:49:46 GMT 2013 - surfraw 2.2.9
* New elvi:
+ S - search using w3_custom_search (see below)
+ cisco - search Cisco documentation
+ debcodesearch - search Debian codebase
+ github - search github
+ gmane - search mailing lists
+ jquery - search jQuery documentation
+ mdn - search Mozilla Developer Network
+ mysqldoc - search MySQL documentation
+ oraclesearch - search Oracle documentation
+ pgdoc - search PostgreSQL documentation
+ phpdoc - search PHP documentation
+ pin - search pinboard.in
+ wolfram - search Wolfram Alpha
+ yacy - search YaCy P2P search engines, including ScienceNet
* Changed elvi:
+ aur - uses HTTPS by default, use -no-https to disable
+ deblists
o Removed options -author, -lists, -lang
o added options -ml (message links) and -mv (list view)
+ duckduckgo:
o removed -p (clashes with global print option), use -safe
instead
o stopped -l[ucky] from clobbering -lh
+ google: changed -g option to -G to avoid clash with -g for
graphical view
* Fixed elvi: ask, ctan, deli, genportage, jamendo, javasun, openbsd
musicbrainz, rae, slashdot, slinuxdoc
* Removed elvi for dead sites: happypenguin, scroogle, sunonesearch
(replaced by oraclesearch)
* w3_custom_search
+ elvi that use a search engine as a backend with site: and
inurl: can now choose which search engine to use. So far,
google and duckduckgo are supported, with duckduckgo the
default.
+ Affected elvi: mdn, mysqldoc, netbsd, openbsd, pgdoc,
slinuxdoc
+ To select on the commandline use -custom-search=google or
-custom-search=duckduckgo
+ Or configure SURFRAW_customsearch_provider
* New variable: SURFRAW_bookmark_search_elvis When using searchable
bookmarks, if all else fails run this elvis. Defaults to google
* New example elinks integration script in examples/hooks.lua.
* Debian packaging now included in release, in debian/ dir.
* Known problems at time of release
+ deblogs - down (hopefully) temporarily
+ yacy - demo portal down, ScienceNet still up
+ scicom - down, status unknown
Tue Jul 12 00:46:02 BST 2011 - surfraw 2.2.8
New elvi:
* ads - search the SAO/NASA Astrophysics data system.
* archwiki: search the arch wiki.
* bugzilla - search various bugzillas, defaults to kernel.
* cablesearch - search wikileaks cables
* deli: search delicious.com.
* duckduckgo - replace with better implementation
* openports - search openbsd ports
* pasearch - search Penny Arcade archives.
* scirus, scitopia, worldwidescience - science searches
* stack: search stackoverflow.com and friends.
* yandex - russian web search.
Changed elvi:
* archpkg: now supports options.
* arxiv: quote queries for exact string matches.
* ctan: Option -doc replaced by -id. Options no longer mutually
exclusive.
* codesearch, musicbrainz, rpmsearch: rewritten to match new site.
Options have changed to match site, see help message.
* debbugs: add -s as an alias for -search=src.
* google: new options:
+ -v, -search=video: search video
+ -m, -search=maps: search maps
+ -n, -search=news: search news
+ -i: new shortcut for -search=images
+ -safe=default|off|moderate|strict: safe search
* openbsd: support -misc and -tech.
* opensearch: new option -r, uses remote redirector which means it
can run without heavy dependencies.
* pgpkeys: add more options, support more keyservers, default to
sks-keyservers.net.
* translate: added Google Translate support.
* wayback: advanced search is broken, rip out all options and use
basic search.
* wikipedia: new option -d, uses remote redirector to search both
wikipedia and deletionpedia. use -fallback=wikipedia|deletionpedia
to customise behaviour.
Fixed elvi: archpkg, arxiv, cia, codesearch, ctan, javasun, lastfm,
musicbrainz, netbsd, rpmsearch, w3link, yahoo.
Removed elvi:
* altavista: is now just a front-end to yahoo. RIP.
* cddb: gracenote made the "hard decision" to remove the website
search. sigh.
* fast: another yahoo front-end.
* filesearching: refuses to work without 'Referer:' header.
* port: site gone
Support -local-help, --local-help or -lh to get elvi-specific help
without displaying the global options. This works for all elvi and the
main surfraw script.
Support -h as a synonym for -help.
Improved listing of elvi.
Default to surfraw_graphical_remote=no, as chromium doesn't support
"-remote openURL".
Bookmark names are now an exact match not a substring match.
Support BSD/POSIX make.
README: added INTEGRATION section on uzbl and pentadactyl.
Thu May 6 20:20:09 BST 2010 - surfraw 2.2.7
* New elvi (surfraw now has over one hundred elvi!):
+ by tczy:
o bing: Search using Microsoft's Bing.
+ by Ivy Foster:
o bookfinder: Search for books using www.bookfinder.com.
o bugmenot: Bypass compulsory web registration with
bugmenot.com.
+ by Ian Beckwith:
o duckduckgo: Search the web via duckduckgo.com.
o scroogle: Search Google anonymously via www.scroogle.org.
+ by Simone Fittabile:
o amendo: Search Jamendo: free music with Creative Commons
licenses
* Removed elvi:
+ genpkg (use genportage instead).
* Fixed elvi:
+ cnn
+ imdb (thanks to Sadako)
+ bbcnews (thanks to Sumant Oemrawsingh and James Rowe)
* aur: added options (thanks to Ivy Foster)
* wikipedia, ixquick: support https. Thanks to Simone Fittabile.
* debwiki: remove -w, Debian Women wiki is being merged into main
Debian wiki. Thanks to Simone Fittabile.
* Improved support for screen(1). Thanks to Ivy Foster:
+ Support for using tmux as $SURFRAW_screen.
+ Added `-ns|-newscreen' switch for setting $SURFRAW_new_screen.
+ Added $SURFRAW_screen_args for passing arguments to the
defined screen tool.
* uzbl_load_url_from_surfraw: fix menu. Thanks to Sumant Oemrawsingh.
Fri Nov 20 03:34:19 GMT 2009 - surfraw 2.2.6
* New elvi:
+ by Sumant Oemrawsingh:
o cliki - search the common lisp wiki.
o l1sp - search lisp documentation.
o mathworld - search Wolfram MathWorld.
o mininova - search mininova for torrents.
o youtube - search youtube for videos.
+ by fittabile@lifegate.it:
o acronym - find acronyms
o gcache - search google cache.
+ by Nick White:
o genbugs - search gentoo bug tracker
+ by Ian Beckwith:
o debpkghome - view home page of a debian package.
o debvcsbrowse - browse vcs of a debian package
o rpmsearch - search for packages in rpm-based distros.
o finkpkg - search Fink packages.
o macports - search macports packages.
* Move config files to follow XDG basedir spec
This means that if your global config was in /etc/surfraw.conf it
is now in /etc/xdg/surfraw/conf, and local config is now in
$HOME/.config/surfraw/conf. The same applies to bookmarks.
See README for details on configuring config locations, and the
[16]XDG basedir spec for the gory details. The old locations are
still supported for backwards-compatibility.
* Support per-user elvi in $HOME/.config/surfraw/elvi/
Patch by James Rowe, idea by Sumant Oemrawsingh.
* Added -o | -o=FILE option, to fetch URL and dump to stdout or FILE.
* Modified elvi:
+ freebsd: new options -psearch=TYPE -psection=SEC to conduct a
search of type TYPE in section SEC of ports.
+ netbsd: new option -ps to search ports
+ openbsd: new option -ps to search ports
+ debsec: fixed (Thanks to Moritz Muehlenhoff, for this and all
his other work).
+ cia: fixed.
* Added examples/uzbl_load_url_from_surfraw, to integrate surfraw
with [17]uzbl, thanks to Sumant Oemrawsingh.
Tue Jul 21 20:44:59 BST 2009 - Migrated CVS repository to git
The surfraw source code repository is now hosted in git.
The repository can be browsed at
[18]http://git.debian.org/?p=surfraw/surfraw.git and can be checked out
with:
git clone git://git.debian.org/surfraw/surfraw.git
Wed May 13 02:30:21 BST 2009 - surfraw 2.2.5
* Replaced scaleplus elvi with comlaw.
* rfc: use HTML for RFCs and BCPs.
* Support '--' to indicate end of options, so, for instance,
"sr google -g -- foo -bar" works.
* debpackages, debcontents: update ubuntu release names.
Sun Mar 1 02:12:14 GMT 2009 - surfraw 2.2.4
* New elvi:
+ ntrs, scicom, springer - Thanks to Wim Van Hoydonck.
+ urban - Thanks to J. R. Mauro.
+ aur - Thanks to René Reigel.
* excite: fixed.
* cite: changed to use citeseerx.ist.psu.edu, the old citeseer is no
longer being updated.
* amazon: fixed; updated categories.
Sat Sep 13 20:40:01 BST 2008 - surfraw 2.2.3
* Surfraw now defaults to graphical mode. See surfraw(1) for how to
change the default back.
* Search for default browsers during build. This can be overridden by
passing --with-text-browser=BROWSER and
--with-graphical-browser=BROWSER to ./configure.
* New elvis: piratebay, genportage. Thanks to J.R. Mauro.
* Detect which awk to use.
* Fixed slinuxdoc and webster.
* Removed bashisms.
* Fixed uninstall.
* Add --disable-sr option to ./configure to disable installing the sr
symbolic link, to avoid clashes with the [19]SR programming
language.
Thu Jul 3 08:47:14 BST 2008 - surfraw 2.2.2
* New elvis:
+ arxiv - Search the Los Alamos Science E-Print Archive replaces
xxx which was just a stub (thanks to John Gruenenfelder).
+ javasun - search Java API Docs (thanks to James TD Smith)
* Fixed elvis:
+ debpackages/debcontents: update options and distributions, add
-a options to use archive.debian.net.
+ wetandwild: switched to weather.com, as yahoo now uses AJAX.
Command line options and SURFRAW_weather_* variables no longer
supported.
+ austlii: fixed search URL, default method is now 'auto'.
+ port: original site is back.
+ translate: fixed URLs.
* Removed elvis:
+ sundocs: use sunonesearch.
+ xxx: replaced by arxiv.
* surfraw: fix w3_url_escape quoting (thanks Micah Anderson)
* surfraw-update-path: fix csh syntax (thanks John Gruenenfelder)
* google: Add -country option to specify country. Respects
* SURFRAW_lang variable (Thanks to James TD Smith).
March 9th, 2008 - Released Surfraw 2.2.1
* New elvi:
+ lsm - Search the Linux Software Map.
+ sunonesearch - Search Sun's One Search (replaces sunsolve).
* Fixed elvi: cddb, cnn, debcontents, deblists, debpackages, freedb,
fsfdir, genpkg, and yubnub (thanks for the latter to Nathaniel
Heinrichs).
* Removed elvi: sunsolve (replaced by sunonesearch).
* amazon, ebay, translate: expanded language/country list.
* Added new configuration variable SURFRAW_lang. Elvi that support
specifying language or country will use this as a default. If used,
it should be set to an ISO 2-letter country code (eg uk, de, ca).
Thanks to Simon Ernst for the idea.
* Fixed quoting single quotes in URLs (thanks to Alexander Becher for
the patch).
September 14th, 2007 - Resumed making upstream releases.
Surfraw is now maintained by the Debian Surfraw-Devel Team. Please
report bugs to [20]surfraw-devel@lists.alioth.debian.org, and feel free
to join us on the list.
There have been many changes since the last official release:
* New elvi: alioth archpkg bbcnews cddb cia codesearch ctan cve
deblists deblogs debpts debsec debwiki discogs dmoz ebay etym
foldoc freedb fsfdir genpkg gutenberg happypenguin imdb ixquick
lastfm leodict musicbrainz opensearch pgpkeys port rae rfc scholar
scpan w3css w3html w3link w3rdf wayback wikipedia yubnub
* Removed elvi: appwatch britannica ftpfind ftpsearch jake raging
swhois
* Elvi now live in /usr/lib/surfraw (or /usr/local/lib/surfraw) Use
surfraw-update-path to add this directory to your path or prefix
elvi with sr or surfraw, eg sr google foo bar.
* Bookmarks can be defined in /etc/surfraw.bookmarks or
~/.surfraw.bookmarks. See /etc/surfraw.bookmarks for the format.
Bookmarks can be used with sr [options] bookmarkname.
* There is now a test suite. make test to run it or see test/README.
Old news entries can be viewed [21]here. For a full list of changes to
surfraw, consult the [22]ChangeLog file from the surfraw source
distribution. Earlier log entries were kept in [23]debian/changelog.
__________________________________________________________________
Downloading
The current version of surfraw is 2.2.9
Current release tarball: [24]surfraw-2.2.9.tar.gz
[25][MD5] [26][SHA1] [27][GPG SIG]
[28]surfraw-2.2.9.tar.gz is [29]signed by the [30]surfraw release key,
also available from [31]keyservers.
Debian packages:
Debian surfraw binary package (all architectures)
[32]surfraw_2.2.9-1_all.deb
Debian surfraw-extra binary package (all architectures)
[33]surfraw-extra_2.2.9-1_all.deb
Debian source package [34]surfraw_2.2.9-1.dsc
[35]surfraw_2.2.9-1.diff.gz
[36]surfraw_2.2.9.orig.tar.gz
[37]surfraw_2.2.9-1_amd64.changes
Older versions are available [38]here.
__________________________________________________________________
Installation
Source Tarball
Unpack the source with
gzip -dc surfraw-2.2.9.tar.gz | tar xvvf -
Then, change into the surfraw-2.2.9 directory, and type
./configure
make
then, as root,
make install
This will install surfraw into /usr/local/
For more detailed installation instructions, see the [39]INSTALL file
that is part of the surfraw distribution.
Note that the opensearch elvis depends on the perl libraries
[40]WWW::OpenSearch, [41]HTML::Parser and [42]LWP (libwww-perl). If you
don't want to install opensearch, use
./configure --disable-opensearch
Debian Binary Package
To install the [43]version in your [44]Debian distribution, as root,
type:
apt-get install surfraw surfraw-extra
To install the .deb files directly, as root, type:
dpkg -i surfraw_2.2.9-1_all.deb surfraw-extra_2.2.9-1_all.deb
Note that calling dpkg directly does not automatically install
dependencies, and surfraw-extra in particular has many dependencies, so
it is best to stick with apt-get install where possible.
Debian source package
First you need to ensure you have the necessary packages installed to
successfully build surfraw.
The following commands (run as root) should ensure you have everything
necessary to build surfraw:
apt-get install build-essential fakeroot
apt-get build-dep surfraw
[45]Download the [46]surfraw_2.2.9-1.dsc, [47]surfraw_2.2.9-1.diff.gz
and [48]surfraw_2.2.9.orig.tar.gz files, then type:
dpkg-source -x surfraw_2.2.9-1.dsc
This will unpack the source into a subdirectory called surfraw-2.2.9
Change into this directory, and type:
fakeroot debian/rules binary
This should produce files called surfraw_2.2.9-1_all.deb and
surfraw-extra_2.2.9-1_all.deb in the directory above the surfraw source
directory. To install these files, type as root:
dpkg -i surfraw_2.2.9-1_all.deb surfraw-extra_2.2.9-1_all.deb
__________________________________________________________________
List of Elvi
Surfraw contains the following web site search scripts (elvi)
S Search using custom search provider
W Activate Surfraw defined web-browser
acronym Look for acronyms definitions (www.acronymfinder.com)
ads Search SAO/NASA Astrophysics Data System
alioth Search Alioth (alioth.debian.org)
amazon Search the amazon.com bookstore
archpkg Search Arch Linux Packages (www.archlinux.org/packages/)
archwiki Search the Arch Linux Wiki
arxiv Search arXiv E-Print Archive for articles
ask Question the web using Ask Jeeves (www.ask.com)
aur Search aur.archlinux.org for PKGBUILDs
austlii Search Australian Law docs (www.austlii.edu.au)
bbcnews Search BBC News (news.bbc.co.uk)
bing Search the web using Microsoft's Bing (www.bing.com)
bookfinder Search for books using www.bookfinder.com
bugmenot Bypass compulsory web registration with bugmenot.com
bugzilla Search for bugs on Bugzilla bugtrackers
cablesearch search for leaked diplomatic communications
cia Search CIA documents at www.cia.gov
cisco Search Cisco documentation (www.cisco.com)
cite Search computer science papers (citeseerx.ist.psu.edu)
cliki Search the common lisp wiki
cnn Search on CNN (cnn.com)
comlaw Search Australian Law using Comlaw (www.comlaw.gov.au)
ctan Search the Comprehensive TeX Archive Network (ctan.org)
currency Convert currencies with the Universal Currency Converter
(www.xe.net/ucc)
cve Search for CAN assignments in CVE
debbugs Search the debian BTS (bugs.debian.org)
debcodesearch Search debian source code
debcontents Search contents of debian/ubuntu packages
(packages.debian.org/packages.ubuntu.com)
deblists Search debian mailing lists (lists.debian.org/search.html)
deblogs Show changelogs for a package in Debian main
(changelogs.debian.net)
debpackages Search debian/ubuntu packages
(packages.debian.org/packages.ubuntu.com)
debpkghome Visit the home page for a Debian package
debpts Search the Debian Package Tracking System
(packages.qa.debian.org)
debsec Search the Debian Security Tracker for CVE ids or package names
debvcsbrowse Browse the VCS repository for a Debian package
debwiki Search the Debian Wikis (wiki.debian.org &
women.debian.org/wiki)
deja Search usenet using Google Groups (groups.google.com)
deli Search Delicious bookmarks
discogs Search the Discogs database of music information
(www.discogs.com)
dmoz Search the Open Directory Project web directory (dmoz.org)
duckduckgo Securely search the web using duckduckgo
(www.duckduckgo.com)
ebay Search the Ebay auction site
etym Look up word origins at www.etymonline.com
excite Search on Excite (www.excite.com)
f5 Search F5 related information (www.f5.com)
finkpkg Search Fink packages (pdb.finkproject.org)
foldoc The Free On-Line Dictionary Of Computing (foldoc.org)
freebsd Search FreeBSD related information (www.freebsd.org)
freedb Search for cd track listings in FreeDB (www.freedb.org)
freshmeat Search Freshmeat (www.freshmeat.net)
fsfdir Search the FSF/UNESCO Free Software Directory
(directory.fsf.org)
gcache Search the web using Google cache (www.google.com)
genbugs Search the Gentoo bug tracker (bugs.gentoo.org)
genportage Search gentoo-portage.com for packages
github Search GitHub (https://github.com)
gmane Search mailing list with gmane (gmane.org)
google Search the web using Google (www.google.com)
gutenberg Search for books on Project Gutenberg (gutenberg.org)
imdb Search the Internet Movie Database (www.imdb.com)
ixquick Search the web using ixquick [HTTPS] (www.ixquick.com)
jamendo Search Jamendo: free music with Creative Commons licenses
(www.jamendo.com)
javasun Search Java API docs (java.sun.com)
jquery Search the jQuery documentation (api.jquery.com)
l1sp Search lisp documentation
lastfm Search last.fm
leodict Search Leo's German <-> English dictionary (dict.leo.org)
lsm Search the Linux Software Map
macports Search macports packages (macports.org)
mathworld Search Wolfram MathWorld
mdn Search the mozilla developer network (developer.mozilla.org)
mininova Search the mininova bittorent source.
musicbrainz Search MusicBrainz (musicbrainz.org)
mysqldoc Search mysql documentation (dev.mysql.com)
netbsd Search NetBSD related information (www.netbsd.org)
ntrs Search the NASA Technical Report Server
openbsd Search OpenBSD related information (www.openbsd.org)
openports search openports for OpenBSD packages
opensearch Search an OpenSearch-enabled website
oraclesearch Search Oracle (search.oracle.com)
pasearch Search the unofficial Penny Arcade archives (pipefour.org/pa)
pgdoc Search postgres documentation (www.pgdoc.com)
pgpkeys Search the PGP key database
phpdoc Search PHP documentation (php.net)
pin Search Pinboard bookmarks (http://pinboard.in)
piratebay Search The Pirate Bay (http://thepiratebay.org)
priberam Look up word in Priberam online dictionary
(www.priberam.pt/dlpo)
pubmed Search medical/molbio databases (www.ncbi.nlm.nih.gov)
rae Busca en el diccionario de la Real Academia de la Lengua Española
(Spanish Dictionary)
rfc Search RFCs (internet standards documents)
rhyme Search for rhymes et al using Lycos Rhyme (rhyme.lycos.com)
rpmsearch Search for RPMs in various distros
scholar Search Google Scholar (scholar.google.com)
scicom Search Scientific Commons
scirus Search for science using Scirus (scirus.com)
scpan Search the Comprehensive Perl Archive Network (search.cpan.org)
slashdot Search stories on Slashdot (www.slashdot.org)
slinuxdoc Search entries in LDP (www.linuxdoc.org)
sourceforge Search SourceForge (www.sourceforge.net)
springer Search Springer for Books and Articles
stack Search Stack Overflow
stockquote Get a single stock quote (multiple providers)
thesaurus Look up word in Merriam-Webster's Thesaurus (www.m-w.com)
translate Translate human languages
urban Search urbandictionary.com for a definition
w3css Validate a CSS URL with the w3c CSS validator
(jigsaw.w3.org/css-validator)
w3html Validate a web page URL with the w3c validator
(validator.w3.org)
w3link Check web page links with the w3c linkchecker
(validator.w3.org/checklink)
w3rdf Validate a RDF URL with the w3c RDF validator (validator.w3.org)
wayback Search The Internet Archive's Wayback Machine for a URL
(archive.org)
webster Look up word in Merriam-Webster's Dictionary (www.m-w.com)
wetandwild Real time weather information (many sources)
wikipedia Search the free encyclopedia wikipedia
woffle Search the web using Woffle (localhost:8080)
wolfram Ask questions of the computational knowledge engine
worldwidescience Search for science with www.worldwidescience.org
yacy Search YaCy P2P search, including ScienceNet
yahoo Search Yahoo categories (www.yahoo.com)
yandex Search the web using Yandex (yandex.ru)
youtube Search YouTube (www.youtube.com)
yubnub Use the social command-line for the web (yubnub.org)
__________________________________________________________________
Usage
Surfraw consists of a collection of elvi, each of which knows how to
search a specific web site.
To see the [49]list of elvi type:
surfraw -elvi
Note that sr is an alias for surfraw, so that could equally be:
sr -elvi
To search using an elvis use:
sr elviname [options] search terms..
For example, to search google for information on Debian ports, using
the "I'm feeling lucky" option:
sr google -l debian ports
Note that putting quotes round arguments works now, so you can do, for
example:
sr google foo "bar baz" bam
and the quoting is passed on to the search engine.
Adding the elvi to your path
If you are a regular user of surfraw, you will probably get sick of
typing sr or surfraw each time. You can regain the old behaviour of
running the elvi directly by adding the elvi directory (usually
/usr/lib/surfraw/ or /usr/local/lib/surfraw/) to your path, either
manually or using surfraw-update-path(1).
Bookmarks
Surfraw now supports bookmarks. To add a bookmark, add it to
/etc/surfraw.bookmarks or $HOME/.surfraw.bookmarks
The format of the bookmarks file is simple, each bookmark is on a
separate line, with the bookmark and URL separated by whitespace, for
example:
ntk http://www.ntk.net/
To invoke a bookmark, use surfraw bookmark or sr bookmark, and if an
elvis of that name doesn't exist, it searches for a bookmark of that
name instead.
There are some example bookmarks in /etc/surfraw.bookmarks
Completion
Surfraw has support for bash completion. If bash completion is enabled
you can use the <TAB> key to complete elvi names, options and
arguments.
Options
Global options are common to all Surfraw elvi (clients). You can get a
[50]list of the currently installed elvi by typing surfraw -elvi.
All elvi have useful low calorie help, for example:
$ sr rhyme -help
Usage: rhyme [options] [search words]...
Description:
Surfraw search for rhymes and other word correlations using
Lycos Rhyme (http://rhyme.lycos.com)
Example:
$ surfraw rhyme Julian
$ sr rhyme -method=rel surfer
Results:
Hurclean St. Julien.
surfboarder, bather, natator, swimmer
Local options:
-method= Type of word correlation to search for
prefect | Perfect rhyme
syn | Synonyms
hom | Homophones
cons | Consonsant rhymes only
rel | Semantically related words
sub | Phrases
spell | Similar spellings
pic | Pictures
shake | Match with Shakespeare archives
def Find wordnet definition
Default: perfect
Environment: SURFRAW_rhyme_method
Global options:
-browser=EXECUTABLE Set browser
Default: mozilla
-elvi List Surfraw mechanisms for conquering evil
-escape-url-args=yes|no Apply url escaping to arguments
Default: yes
Environment: SURFRAW_escape_url_args
-g | -graphical Get some windowed sin
-help What you're reading now, dude
-quiet=yes|no I can't enjoy it with you talking all the time
Default: no
Environment: SURFRAW_quiet
-new[=yes|no] Start in a new window
Default: no
Environment: SURFRAW_new_window
-t | -text Back to the yellow brick road
-q | -quote Quote arguments with " characters
Default: no
Environment: SURFRAW_quote_args
-version Display Surfraw version (1.0.4)
Copyright:
Copyright (c) 2003-2007 The Surfraw-Devel Team
<surfraw-devel@lists.alioth.debian.org>
Copyright (c) 2000-2001 Julian Assange
Copyright (c) 2001 Australian Institute for Collaborative Research
Copyright (c) 2000 Melbourne Institute for Advanced Study
---
__________________________________________________________________
Configuration
Surfraw gets its configuration from three sources, in order:
1. Environment variables
2. /etc/surfraw.conf
3. $HOME/.surfraw.conf
/etc/surfraw.conf and $HOME/.surfraw.conf are both fragments of
bourne-shell style shell script.
/etc/surfraw.conf should use def and defyn to define variables. These
functions set variables unless they are already set by the environment.
defyn is used for boolean configuration variables, def for all others.
For instance:
def SURFRAW_text_browser /usr/bin/lynx
defyn SURFRAW_graphical no
$HOME/.surfraw.conf should use sh-style entries, eg:
SURFRAW_text_browser=/usr/bin/lynx
SURFRAW_graphical=no
This is because you want them to override environment variables
unconditionally.
Configuration Variables
Variable Meaning Default
SURFRAW_global_conf Location of global configuration file.
/etc/surfraw.conf
SURFRAW_conf Location of per-user configuration file.
$HOME/.surfraw.conf
SURFRAW_graphical Whether to use a graphical browser. no
SURFRAW_text_browser Name/path of text browser executable.
e.g. links, lynx, w3m sensible-browser
SURFRAW_graphical_browser Name/path of graphical browser executable.
e.g mozilla, netscape etc. sensible-browser
SURFRAW_text_browser_args Text browser arguments, or "none". none
SURFRAW_graphical_browser_args Graphical browser arguments, or "none".
none
SURFRAW_graphical_remote Whether to use -remote openURL for graphical
browser. yes
SURFRAW_new_window When using SURFRAW_graphical_remote, open a new
window? no
SURFRAW_screen Name of screen command to run. screen
SURFRAW_screen_args Arguments to screen command
SURFRAW_new_screen If surfraw is running under screen(1), start a new
screen for each text browser invocation? no
SURFRAW_quiet I can't enjoy it with you talking all the time. no
SURFRAW_quote_args Whether to "quote" all the arguments. no
SURFRAW_quote_ifs Whether to re-quote arguments if they have spaces in,
ie so:
sr google foo "bar baz" bam
works as expected. yes
SURFRAW_results Default number of results to return (not supported by
all elvi). 30
SURFRAW_escape_url_args Whether to escape [%"$%&+,/:;<=>?@[\^{|}~']
characters in command line arguments subsequently used to construct a
url. yes
SURFRAW_lang Elvi supporting this will use it to select a default
country or language. It should be set to an ISO 2-letter country code
(e.g. uk, de, ca). none
SURFRAW_customsearch_provider Provider for searches that use a search
engine. Supported: google, duckduckgo. duckduckgo
Files
$(libdir)/surfraw
Location of the elvi.
/etc/surfraw.conf
Default system wide configuration file.
$HOME/.surfraw.conf
Default per-user config file
/etc/surfraw.bookmarks
System wide bookmarks file.
$HOME/.surfraw.bookmarks
Per-user bookmarks file.
__________________________________________________________________
Development and Support
Surfraw was originally written by Julian Assange. It is now maintained
and improved by a team of programmers based around the
[51]surfraw-devel mailing list.
The surfraw project webpage is at [52]surfraw.alioth.debian.org
To report a bug or request an enhancement (e.g. a new elvi), send email
to [53]surfraw-devel@lists.alioth.debian.org
The current development version of surfraw can be obtained from the
surfraw [54]git repository. To check out the repository:
git clone git://anonscm.debian.org/surfraw/surfraw.git
Interested in contributing? [55]Subscribe to surfraw-devel. [56]View
the surfraw-devel list archives. [57]Read the surfraw HACKING guide.
Surfrawize the soul of your favourite internet wonder. Join the Shell
Users' Revolutionary Front Against the WWW by submitting code. Reclaim
heathen lands. Bear witness to the truth. Its love will set you free.
__________________________________________________________________
Last modified: Wed Dec 11 22:23:46 GMT 2013
1. http://surfraw.alioth.debian.org/#about
2. http://surfraw.alioth.debian.org/#news
3. http://surfraw.alioth.debian.org/#elvilist
4. http://surfraw.alioth.debian.org/#downloading
5. http://surfraw.alioth.debian.org/#installation
6. http://surfraw.alioth.debian.org/#usage
7. http://surfraw.alioth.debian.org/#configuration
8. http://surfraw.alioth.debian.org/#development
9. http://surfraw.alioth.debian.org/#elvilist
10. http://wp.netscape.com/newsref/std/x-remote.html
11. http://lynx.isc.org/
12. http://artax.karlin.mff.cuni.cz/~mikulas/links/
13. http://www.w3m.org/
14. http://freshmeat.net/projects/screen/
15. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz
16. http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html
17. http://uzbl.org/
18. http://git.debian.org/?p=surfraw/surfraw.git
19. http://www.cs.arizona.edu/sr/
20. mailto:surfraw-devel@lists.alioth.debian.org
21. http://surfraw.alioth.debian.org/NEWS
22. http://surfraw.alioth.debian.org/ChangeLog
23. http://surfraw.alioth.debian.org/debchangelog
24. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz
25. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz.md5
26. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz.sha1
27. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz.sig
28. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz
29. http://surfraw.alioth.debian.org/dist/surfraw-2.2.9.tar.gz.sig
30. http://surfraw.alioth.debian.org/surfraw-release-key.asc
31. http://pgp.mit.edu:11371/pks/lookup?search=0xE7892D44&op=index&fingerprint=on&exact=on
32. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9-1_all.deb
33. http://surfraw.alioth.debian.org/dist/surfraw-extra_2.2.9-1_all.deb
34. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9-1.dsc
35. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9-1.diff.gz
36. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9.orig.tar.gz
37. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9-1_amd64.changes
38. http://surfraw.alioth.debian.org/dist/
39. http://surfraw.alioth.debian.org/INSTALL
40. http://search.cpan.org/search?query=WWW%3A%3AOpenSearch&mode=all
41. http://search.cpan.org/search?query=HTML%3A%3AParser&mode=all
42. http://search.cpan.org/search?query=LWP&mode=all
43. http://packages.qa.debian.org/s/surfraw.html
44. http://www.debian.org/
45. http://surfraw.alioth.debian.org/#downloading
46. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9-1.dsc
47. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9-1.diff.gz
48. http://surfraw.alioth.debian.org/dist/surfraw_2.2.9.orig.tar.gz
49. http://surfraw.alioth.debian.org/#elvilist
50. http://surfraw.alioth.debian.org/#elvilist
51. mailto:surfraw-devel@lists.alioth.debian.org
52. http://surfraw.alioth.debian.org/
53. mailto:surfraw-devel@lists.alioth.debian.org
54. http://anonscm.debian.org/gitweb/?p=surfraw/surfraw.git
55. http://lists.alioth.debian.org/mailman/listinfo/surfraw-devel
56. http://lists.alioth.debian.org/pipermail/surfraw-devel/
57. http://surfraw.alioth.debian.org/HACKING
# distributed via <nettime>: no commercial use without permission # <nettime> is a moderated mailing list for net criticism, # collaborative text filtering and cultural politics of the nets # more info: http://mx.kein.org/mailman/listinfo/nettime-l # archive: http://www.nettime.org contact: nettime@kein.org # @nettime_bot tweets mail w/ sender unless #ANON is in Subject: