* * * * IMPORTANT NOTE * * * *
We are looking for developers to take over Cardapio. See the announcement below:
https://launchpad.net/cardapio/+announcement/11268
 * * * * * * * * * * * * * * * * * * * *

Cardapio can work in two modes: as a panel applet (in which case it is an alternative to Gnome's application menu applet) or as a stand-alone launcher (in which case it is an alternative to the simplest use-cases of Gnome Do). It has a beautiful gtk-native interface and includes plugins for performing inline searches of Files (via Tracker), Software Center, Google, Wikipedia, and much more!

Screenshots: http://images.google.com/images?q=Cardapio+Linux
Videos: http://youtube.com/results?search_query=Cardapio+Linux

Give it a try!

    ~

Installation in Ubuntu
===========================

Cardapio can easily be installed in Ubuntu versions 10.04 (Lucid Lynx) and up. Simply follow the steps below:

1) Run these commands in a terminal:
$ sudo add-apt-repository ppa:cardapio-team/cardapio-ppa && sudo apt-get update

2) Now pick one or more of these, depending on how you want to use Cardapio:
$ sudo apt-get install cardapio-gnomepanel # <-- to install the Gnome-Panel applet
$ sudo apt-get install cardapio-docky             # <-- to install the Docky applet
$ sudo apt-get install cardapio-awn                # <-- to install the AWN applet
$ sudo apt-get install cardapio-gnomeshell  # <-- to install the Gnome-Shell applet
$ sudo apt-get install cardapio                         # <-- to use it in stand-alone mode only

3) Done!

    ~

Installation in other Distros
===========================

Fetch Cardapio source code:
$ bzr clone lp:cardapio
or
$ git clone https://git.launchpad.net/cardapio

Install main Cardapio:
 && cd cardapio/cardapio && sudo make install && cd ..

2) Now pick zero or more of these, depending on how you want to use Cardapio:
$ cd cardapio-gnomepanel && sudo make install && cd .. # <-- to install the Gnome-Panel applet
$ cd cardapio-docky && sudo make install && cd ..              # <-- to install the Docky applet
$ cd cardapio-awn && sudo make install && cd ..                  # <-- to install the AWN applet
$ cd cardapio-gnomeshell && sudo make install && cd ..   # <-- to install the Gnome-Shell applet

3) Now clean up!
$ sudo rm -rf cardapio

4) Done!

(see dependencies here: https://answers.launchpad.net/cardapio/+faq/1394)

    ~

To search for files in your computer using Cardapio, you need to install Tracker 0.8.7 or above. To install it on Ubuntu:
$ sudo apt-get install tracker

Then be sure to run the tracker preferences tool (just type "Search and Indexing" in Cardapio), change the settings to your personal preference, and restart your computer.

Afterwards, don't forget to activate the File Search plugin in Cardapio's preferences window!

    ~

Usage
===========================

To use as a panel applet, simply add it as usual:
Right-click the panel, select "Add to panel", then choose "Cardapio".

To run in other docks/panels, see:
- Docky: https://answers.launchpad.net/cardapio/+faq/1148
- AWN: https://answers.launchpad.net/cardapio/+faq/1407

To use as a launcher instead, make sure Cardapio is not used as an applet first, then run:
$ cardapio hidden

Once cardapio is running, you can access it using Super+Space. You can change this keybinding in Cardapio's Preferences.

Have fun!

    ~

Frequently-Asked Questions (FAQ)
===========================
https://answers.launchpad.net/cardapio/+faqs

    ~

Cardapio email announcements
===========================
To sign up for email announcements, just subscribe to the bug report below.
https://bugs.launchpad.net/cardapio/+bug/592528
If you prefer a news feed, it is displayed on the right.

    ~