Search with DuckDuckGo from the command line. http://programas.freakspot.net/ducker/

Jorge Maldonado Ventura 1170e76c84 #12 Add instructions to run the program without installing 5 days ago
autocompletion 070a42116e Update Bash autocompletion file 2 months ago
docs 2285d27b96 Install also info and man pages 2 months ago
ducker 17f9a61d78 Make --exact argument work as expected 5 days ago
tests 17f9a61d78 Make --exact argument work as expected 5 days ago
.gitignore 3dc00a164f Initial commit 5 months ago
LICENSE 1b771c2df0 Use original license format instead of notabug.org default 5 months ago
MANIFEST.in 4c02c20018 Add MANIFEST.in 2 months ago
README.rst 1170e76c84 #12 Add instructions to run the program without installing 5 days ago
ducker.1 17f9a61d78 Make --exact argument work as expected 5 days ago
run_ducker.py 30a699087d Program version fix and add contact email 2 months ago
setup.cfg 31e31f4c1e Added initial working version 4 months ago
setup.py e156849c90 Fix error with info documentation file in setup.py 2 months ago

README.rst

Ducker
======

What the duck is Ducker?
------------------------

Ducker is a lightweight program that makes internet searches with DuckDuckGo
from the command line. It can display the search results in your terminal or
directly in DuckDuckGo's website with your browser.

Usage
-----

Just execute it in your shell with keywords you want to use. The following
example searchs for classical music by opening the search results in your
default browser.

.. code-block:: bash

$ duck classical music

There are options to search specifically for images, videos or websites.

There is also an interactive mode, which lets you make use of more advanced
options. Open the interactive mode by calling Ducker without arguments.

When you make a search in the interactive mode, the search results
are displayed in your terminal. Each result consist of a number, a title,
a URL and an abstract. After making the search you can open the URL of the
first result by entering `1`. Your default browser will open that URL
(opening a new tab if it's already running) and the program will prompt you
again until you decide to exit. You can quit the program entering `q`.

To check out every option execute the program with the
`--help` or `-h` arguments.


Installation
------------

You don't have to install Ducker to run it. Just install Python 3.4 or greater,
if you don't have it installed, and execute the `run_ducker.py` file.

However, you can install Ducker if you want. Just clone the repository and
execute:

.. code-block:: bash

$ python setup.py install

Or you can simply install it with pip:

.. code-block:: bash

$ pip install ducker

Customization
-------------

You can always use your favourite command-line options of Ducker using Bash
aliases or other utilities available for your shell. Let's say we want to
add an option to search for articles in Wikipedia; we could create a Bash
alias for that.

.. code-block:: bash

$ alias wikipedia='ducker \!w'

Calling ``wikipedia`` in the shell would open the main page of wikipedia, and
calling ``wikipedia free software`` would open the `"Free software" article
from wikipedia`_. Note that we're using `DuckDuckGo bangs`_ and that the
exclamation mark (!) must be escaped in Bash.

Similarly, you can create an alias to never use JavaScript when using Ducker.

.. code-block:: bash

$ alias duck='ducker --no-javascript'

Related projects
----------------

- `ddgr`_: Power tool to use DuckDuckGo from the command-line.
- `DuckDuckGo`_: Search engine which doesn't track its users.
- `googler`_: Power tool to Google (Web & News) and Google Site Search from the command-line.

.. _DuckDuckGo bangs: https://duckduckgo.com/bang
.. _"Free software" article from wikipedia: https://en.wikipedia.org/wiki/Free_software
.. _ddgr: https://github.com/jarun/ddgr/
.. _DuckDuckGo: https://duckduckgo.com/
.. _googler: https://github.com/jarun/googler/