Skip to content

πŸ”΅ Cerebro is an open-source launcher to improve your productivity and efficiency

License

Notifications You must be signed in to change notification settings

cerebroapp/cerebro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cerebro

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;

Install and manage custom plugins

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

Discover plugins and more at Cerebro's Awesome List.

You can install them manually using npm

open it in the terminal configuration file path, go to the plugins folder

cd ./plugins

Install the plugin

npm install --save name-of-plugin

Create plugin

Check out plugins documentation.

Install

First, clone the repo via git:

$ git clone https://github.com/cerebroapp/cerebro.git cerebro

And then install dependencies:

$ cd cerebro && yarn

Run

$ yarn run dev

Note: requires a node version >=14.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

Change Theme

Use shortcut ctrl+space to open 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)

change-cerebro-theme

Config file path

Windows: %APPDATA%/Cerebro/config.json

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

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

Package

Use this command to build .app file:

$ yarn build

Be in touch

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

For developers

Publish a release

CerebroApp is using GH actions to build the app and publish it to a release. To publish a new release follow the steps below:

  1. Update the version on both package.json and app/package.json files.
  2. Create a release with from GH and publish it. 🚧 The release tag SHOULD NOT contain the v prefix (❌ v0.1.2 β†’ βœ…0.1.2).
  3. Complete the name with a name and a description of the release.
  4. The GH action is triggered and the release is updated when executables are built.

Add dependencies

CerebroApp was created from an old version of electron-react-boilerplate and uses a two package.json file structure. If you are interested in developing a new feature, you should read about this structure in the electron-react-boilerplate documentation.

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