The Seeks project consists of:
- a web proxy,
- a websearch meta search engine that aggregates results and ranks them based on consensus.
- a plugin system and a set of default plugins, that includes websearch and a URL blocker.
- a HTTP server plugin (optional, requires version >= 0.2.3).
- an image websearch plugin (requires version >= 0.2.4).
There are several download and installation options:
- Use a source tarball available from here or from Sourceforge, and compile seeks on your machine, after making sure you have all dependencies installed from your distribution packages.
- Use a package for your distribution if it exists:
- Ubuntu packages are available from launchpad,
- Debian packages are available from archive.sileht.net/seeks
- Note for debian : instructions on the repository page are for sid, you should change http://archive.sileht.net/seeks/seeks-sid.list to http://archive.sileht.net/seeks/seeks-squeeze.list or http://archive.sileht.net/seeks/seeks-wheezy.list depending on your system version
- Archlinux package is available from aur.
- Gentoo package is available from zugaina overlay (in layman), .
- If your machine doesn't have all packages available or if you do not have the rights to install them (non-root): use the install_seeks.sh installation script to download and compile all the libraries (takes some time) then compile seeks current git experimental. (Ideally one could create a dedicated seeks user with its own home directory).
- Get code from our repository, using git.
git clone git://seeks.git.sourceforge.net/gitroot/seeks/seeks
If you wish to compile and run the
cd seeks git checkout --track -b experimental origin/experimental
building tools (up to 0.2.5b)
autoconf automake libtool
required libraries (packages)
libpcre3 libpcre3-dev libcurl libcurl-dev libxml2 libxml2-dev libltdl-dev docbook2x
required libraries for the HTTP server plugin
libevent2, if only libevent1 (>= 1.4.13) is available : configure with --enable-libevent1 libevent-dev
optional libraries for the image websearch plugin
libcv >= 2.0 (on Ubuntu / Debian libcvaux libhighgui should be installed)
For 0.3.0 and higher, if you want to benefit from personalization of results and P2P, you need Tokyo Cabinet & Google protocol buffers:
libtokyocabinet libtokyocabinet-dev libprotobuf libprotobuf-dev protobuf-compiler libprotoc-dev libjsoncpp-dev libmhash-dev
Run the following commands:
Compilation options can be listed with ./configure --help
Compiling on Ubuntu 11.04 (or later) or Archlinux?
Run the following commands instead:
./configure LDFLAGS="-Wl,--no-as-needed" make
All plugins are compiled by default, except for the HTTP server plugin.
If you'd like to compile it, do the following:
./configure --enable-httpserv-plugin --with-libevent=/root/path/to/libevent
Default repository for libevent is /usr.
Beware, you'll have to uncomment
in the src/config file if you want to use it.
This is an early version of Seeks, it is recommended you run it from the repository you compiled it from.
For example, by default seeks does not run as a daemon. If you would like to have it run as a daemon:
Other important options can be modified in the configuration file, src/config
For more configuration options, see the configuration page.
By default, seeks runs as proxy on the local machine (127.0.0.1) on port 8250. If you would like to change it, do it in the configuration file, src/config.
Once started, to use seeks, tell your web browser to connect to the Internet through the seeks web proxy.
http://s.s/websearch-hp would give you the Seeks' main search page. By default though, Seeks automatically intercepts your queries to other search engines.
Seeks is young, so it is likely there are bugs. However, before all, be sure to read the faq and user manuals, respectively at:
To report bugs, please use the Forums.
For discussion and possibly getting immediate help, join us on irc, channel #seeks on irc.freenode.net