/cerebro

Open-source productivity booster with a brain

Primary LanguageJavaScriptMIT LicenseMIT

Cerebro

Build Status Dependency Status OpenCollective OpenCollective

Usage

You can download the latest version on releases page.

After installation use default shortcut ctrl+space to show an app window. You can customize this shortcut clicking on icon in menu bar → preferences.

Cerebro

Plugins

Core plugins

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

Custom plugins

Use built-in plugins command to search and manage custom plugins.

macOS only plugins

  • macOS Contacts – search in contacts.app;
  • macOS Define – define in OSx built-in dictionary;
  • macOS Eject – safely eject mounted volume drives;
  • macOS System – system commands: i.e. sleep, lock, restart, empty trash or open system directories, like trash or airdrop;

Windows only plugins

  • Windows System – system commands: i.e. shutdown, sleep, lock, restart, empty trash, or adjust volume and brightness;

Plugins for all platforms

  • Caniuse – quick access to caniuse.com database;
  • Devdocs – search in dev. documentations provided by devdocs.io
  • DuckDuckGo – Use DuckDuckGo as your search engine;
  • Emoj – search for relevant emoji, like emoj this is awesome;
  • Gif – search for relevant gif, i.e. gif luck, how i met your mother gif;
  • Google Knowledge Graph – Get info from the Google Knowledge Graph for your query;
  • Hash – hash input text with popular hash algorithms (i.e. md5, sha1, etc);
  • IMDB – search for films on imdb.com with rating and details, like imdb star wars;
  • IP – show your local & external IP address;
  • Kill – kill process by name, i.e. kill cerebro;
  • Lipsum – generate lorem ipsum text from lipsum.com;
  • Shell – exec shell commands without running terminal;
  • Stackoverflow – search for answers to questions on stackoverflow;

Development

Create plugin

Check out plugins documentation.

Install

First, clone the repo via git:

git clone https://github.com/KELiON/cerebro.git cerebro

And then install dependencies.

$ cd cerebro && yarn && cd ./app && yarn && cd ../

Run

$ yarn run dev

Note: requires a node version >=6.x

Resolve common issues

  1. AssertionError: Current node version is not supported for development on npm postinstall. After yarn postinstall script checks node version. If you see this error you have to check node and npm version in package.json devEngines section and install proper ones.

  2. Uncaught Error: Module version mismatch. Exepcted 50, got ... This error means that node modules with native extensions build with wrong node version (your local node version != node version, included to electron). To fix this issue run cd ./app && yarn run rebuild

Config file path

WINDOWS: %APPDATA%/Cerebro/config.json

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

Mac OS ~/Library/Application Support/Cerebro/config.json

Package

Use this command to build .app file:

$ yarn run package

Be in touch

Follow to be notified about new releases or learn some productivity tips with Cerebro:

Or subscribe to newsletter to be notified only about big releases.

Support

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

License

MIT © Alexandr Subbotin