cerebro

Cérebro

Cerebro é um lançador de código aberto para melhorar sua produtividade e eficiência

Uso

Você pode baixar a versão mais recente na página de lançamentos.

• Se não houver um instalador para o seu sistema operacional, verifique as instruções de construção.
• Se você é usuário Linux veja como instalar o executável

Após a instalação, use o atalho padrão, ctrl+space , para mostrar a janela do aplicativo. Você pode personalizar este atalho clicando no ícone na barra de menu e selecionando "Preferências...".

Plug-ins

Plug-ins principais

• Pesquise na web com seu mecanismo de pesquisa favorito
• Pesquise e inicie o aplicativo, ou seja, spotify
• Navegue no sistema de arquivos com visualizações de arquivos (ou seja, ~/Dropbox/passport.pdf )
• Calculadora
• Conversor inteligente. 15$ , 150 рублей в евро , 100 eur in gbp ;

Instalar plug-ins

Você pode gerenciar e instalar mais plugins digitando plugins <plugin-name> na barra de pesquisa do Cerebro.

Descubra plug-ins e muito mais na lista incrível do Cerebro.

Se você estiver interessado em criar seu próprio plugin, verifique a documentação dos plugins.

Atalhos

O Cerebro oferece vários atalhos para melhorar sua produtividade:

• ctrl+c : copia o resultado de um plugin para a área de transferência, se o plugin não fornecer resultado, o termo que você introduziu será copiado
• ctrl+1...9 : selecione diretamente um resultado da lista
• ctrl+[hjkl] : navegue pelos resultados usando teclas semelhantes ao vim (também ctrl+o para selecionar o resultado)

Alterar tema

Use o atalho ctrl+space para abrir a janela do aplicativo e digite Cerebro Settings . Lá você poderá alterar o tema.

Atualmente, os temas claro e escuro são suportados imediatamente

Caminho do arquivo de configuração

Você pode encontrar o arquivo de configuração no seguinte caminho, dependendo do seu sistema operacional:

Windows : %APPDATA%/Cerebro/config.json

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

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

️ Um arquivo de configuração incorreto pode quebrar o Cerebro. Se você não tiver certeza do que está fazendo, não edite o arquivo de configuração diretamente.

Construir executável a partir do código-fonte

Se quiser instalar uma versão do Cerebro, mas o executável ainda não foi lançado, você pode seguir estas instruções para compilá-lo a partir do código-fonte:

1. Clonar o repositório

2. Instale dependências com fio:

   yarn --force

3. Construa o pacote:

    yarn package

Nota: no CI usamos yarn build pois existe uma ação para empacotar e publicar os executáveis

Instale o executável no Linux

Se você for um usuário Linux, talvez seja necessário conceder permissões de execução ao executável. Para fazer isso, abra o terminal e execute o seguinte comando:

sudo chmod +x < path to the executable >

Então, você pode instalar o executável executando o seguinte comando:

• Se você estiver usando o executável AppImage:

  ./ < path to the executable >

• Se você estiver usando o executável deb:

  dpkg -i < path to the executable >

Em alguns computadores pode ser necessário executar esses comandos com privilégios elevados (sudo). sudo ./<path to the executable> ou sudo dpkg -i <path to the executable>

Contribuindo

CerebroApp é um projeto de código aberto e agradecemos contribuições da comunidade. Neste documento você encontrará informações sobre como o Cerebro funciona e como contribuir com o projeto.

️ NOTA: Este documento é para desenvolvedores do Cerebro. Se você está procurando como desenvolver um plugin, verifique a documentação dos desenvolvedores de plugins.

Arquitetura geral

Cerebro é baseado em Electron e React.

Um aplicativo Electron básico é composto por um processo principal e um processo de renderização . O processo principal é responsável pelo ciclo de vida do aplicativo, o processo renderizador é responsável pela UI.

No nosso caso usamos:

• app/main.development.js como o processo principal
• app/main/main.js como o principal processo de renderização
• app/background/background.js como um processo de renderização secundário

Todos esses arquivos são agrupados e transpilados com Webpack e Babel.

O processo de construção é gerenciado pelo construtor de elétrons.

Dois processos de renderização

Essa arquitetura de processo de dois renderizadores é usada para manter o processo do renderizador principal (Cerebro) responsivo e evitar o bloqueio da UI ao executar tarefas longas.

Quando precisamos executar uma tarefa longa, enviamos uma mensagem para o processo em segundo plano, que executa a tarefa de forma assíncrona e envia uma mensagem de volta ao renderizador principal quando a tarefa é concluída.

É assim que implementamos o sistema de plugins. Seu método inicializeAsync é executado no processo em segundo plano.

Pré-requisitos

• Node.js (>= 16)
• fio

Instalar o Cérebro

Primeiro, clone o repositório via git:

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

Abra o projeto

 cd cerebro

E então instale as dependências:

yarn

Execute em modo de desenvolvimento

yarn run dev

Nota: requer uma versão do nó >=16.x

Resolver problemas comuns

1. AssertionError: Current node version is not supported for development no npm postinstall. Depois que o script pós-instalação yarn verifica a versão do nó. Se você vir esse erro, verifique a versão do nó e do npm na seção package.json devEngines e instale os adequados.

2. Uncaught Error: Module version mismatch. Exepcted 50, got ... Este erro significa que os módulos do nó com extensões nativas são construídos com a versão do nó errada (sua versão do nó local! = versão do nó, incluída no elétron). Para corrigir esse problema, execute yarn --force

Formato de commit convencional

O projeto está usando especificações de commit convencionais para acompanhar as alterações. Isso nos ajuda nos lançamentos e impõe um estilo consistente. Você pode confirmar normalmente seguindo este estilo ou usar os seguintes comandos que o ajudarão a confirmar com o estilo certo:

• yarn cz
• yarn commit

Publicar um lançamento

CerebroApp está usando ações GH para construir o aplicativo e publicá-lo em um lançamento. Para publicar um novo lançamento siga as etapas abaixo:

1. Atualize a versão nos arquivos package.json e app/package.json .
2. Crie um release do GH e publique-o. ? A tag de lançamento DEVE conter o prefixo v ( 0.1.2 → ✅ v0.1.2 ).
3. Complete o nome com um nome e uma descrição do lançamento.
4. A ação GH é acionada e a versão é atualizada quando os executáveis ​​são compilados.

Licença

Aplicativo MIT © Cerebro