Cerebro is an open-source launcher to improve your productivity and efficiency

You can download the latest version on the releases page.

• If there isn't an installer for your OS, check build instructions.
• If you are a linux user see how to install the executable

After the installation, use the default shortcut, ctrl+space, to show the app window. You can customize this shortcut by clicking on the icon in the menu bar, and then selecting "Preferences...".

• Search the web with your favourite search engine
• Search & launch application, i.e. spotify
• Navigate the file system with file previews (i.e. ~/Dropbox/passport.pdf)
• Calculator
• Smart converter. 15$, 150 рублей в евро, 100 eur in gbp;

You can manage and install more plugins by typing plugins <plugin-name> in the Cerebro search bar.

Discover plugins and more at Cerebro's Awesome List.

If you're interested in creating your own plugin, check the plugins documentation.

Cerebro provides several shortcuts to improve your productivity:

• ctrl+c: copy the result from a plugin to the clipboard, if the plugin does not provida a result, the term you introduced will be copied
• ctrl+1...9: select directly a result from the list
• ctrl+[hjkl]: navigate through the results using vim-like keys (Also ctrl+o to select the result)

Use the shortcut ctrl+space to open the app window, and type Cerebro Settings. There you will be able to change the Theme.

Currently Light and Dark Themes are supported out of the box

You can find the config file in the following path depending on your OS:

Windows: %APPDATA%/Cerebro/config.json

Linux: $XDG_CONFIG_HOME/Cerebro/config.json or ~/.config/Cerebro/config.json

macOS: ~/Library/Application Support/Cerebro/config.json

⚠️ A bad configuration file can break Cerebro. If you're not sure what you're doing, don't edit the config file directly.

If you'd like to install a version of Cerebro, but the executable hasn't been released, you can follow these instructions to build it from source:

1. Clone the repository
2. Install dependencies with yarn:

   yarn --force

3. Build the package:

    yarn package

Note: in CI we use yarn build as there is an action to package and publish the executables

If you're a linux user, you might need to grant execution permissions to the executable. To do so, open the terminal and run the following command:

sudo chmod +x <path to the executable>

Then, you can install the executable by running the following command:

• If you're using the AppImage executable:

  ./<path to the executable>

• If you're using the deb executable:

  dpkg -i <path to the executable>

On some computers you might need run these commands with elevated privileges (sudo). sudo ./<path to the executable> or sudo dpkg -i <path to the executable>

PRs are welcome! You can get a general idea of how Cerebro works by reading the developer guide.

MIT © Cerebro App