cerebro

cerebro

Cerebro es un lanzador de código abierto para mejorar tu productividad y eficiencia

Uso

Puede descargar la última versión en la página de lanzamientos.

• Si no hay un instalador para su sistema operativo, consulte las instrucciones de compilación.
• Si eres usuario de Linux mira cómo instalar el ejecutable

Después de la instalación, use el acceso directo predeterminado, ctrl+space , para mostrar la ventana de la aplicación. Puede personalizar este acceso directo haciendo clic en el icono de la barra de menú y luego seleccionando "Preferencias...".

Complementos

Complementos principales

• Busca en la web con tu motor de búsqueda favorito
• Buscar e iniciar una aplicación, es decir, spotify
• Navegue por el sistema de archivos con vistas previas de archivos (es decir, ~/Dropbox/passport.pdf )
• Calculadora
• Convertidor inteligente. 15$ , 150 рублей в евро , 100 eur in gbp ;

Instalar complementos

Puede administrar e instalar más complementos escribiendo plugins <plugin-name> en la barra de búsqueda de Cerebro.

Descubra complementos y más en Awesome List de Cerebro.

Si está interesado en crear su propio complemento, consulte la documentación de los complementos.

Atajos

Cerebro proporciona varios atajos para mejorar su productividad:

• ctrl+c : copia el resultado de un complemento al portapapeles; si el complemento no proporciona un resultado, se copiará el término que introdujiste.
• ctrl+1...9 : selecciona directamente un resultado de la lista.
• ctrl+[hjkl] : navega por los resultados usando teclas tipo vim (también ctrl+o para seleccionar el resultado)

Cambiar tema

Utilice el acceso directo ctrl+space para abrir la ventana de la aplicación y escriba Cerebro Settings . Allí podrás cambiar el tema.

Actualmente, los temas claros y oscuros son compatibles desde el primer momento

Ruta del archivo de configuración

Puede encontrar el archivo de configuración en la siguiente ruta dependiendo de su sistema operativo:

Windows : %APPDATA%/Cerebro/config.json

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

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

️ Un archivo de configuración incorrecto puede dañar Cerebro. Si no está seguro de lo que está haciendo, no edite el archivo de configuración directamente.

Construir ejecutable desde la fuente

Si desea instalar una versión de Cerebro, pero el ejecutable no se ha publicado, puede seguir estas instrucciones para compilarlo desde el código fuente:

1. Clonar el repositorio

2. Instalar dependencias con hilo:

   yarn --force

3. Construya el paquete:

    yarn package

Nota: en CI usamos yarn build ya que hay una acción para empaquetar y publicar los ejecutables.

Instalar ejecutable en Linux

Si es usuario de Linux, es posible que deba otorgar permisos de ejecución al ejecutable. Para hacerlo, abra la terminal y ejecute el siguiente comando:

sudo chmod +x < path to the executable >

Luego, puede instalar el ejecutable ejecutando el siguiente comando:

• Si estás usando el ejecutable de AppImage:

  ./ < path to the executable >

• Si estás usando el ejecutable deb:

  dpkg -i < path to the executable >

En algunas computadoras es posible que necesites ejecutar estos comandos con privilegios elevados (sudo). sudo ./<path to the executable> o sudo dpkg -i <path to the executable>

Contribuyendo

CerebroApp es un proyecto de código abierto y agradecemos las contribuciones de la comunidad. En este documento encontrarás información sobre cómo funciona Cerebro y cómo contribuir al proyecto.

️ NOTA: Este documento es para desarrolladores de Cerebro. Si está buscando cómo desarrollar un complemento, consulte la documentación para desarrolladores de complementos.

Arquitectura general

Cerebro se basa en Electron y React.

Una aplicación básica de Electron se compone de un proceso principal y un proceso de renderizado . El proceso principal es responsable del ciclo de vida de la aplicación, el proceso de renderizado es responsable de la interfaz de usuario.

En nuestro caso utilizamos:

• app/main.development.js como proceso principal
• app/main/main.js como proceso de renderizado principal
• app/background/background.js como proceso de renderizado secundario

Todos estos archivos están empaquetados y transpilados con Webpack y Babel.

El proceso de construcción lo gestiona el generador de electrones.

Dos procesos de renderizado

Esta arquitectura de proceso de dos renderizadores se utiliza para mantener la capacidad de respuesta del proceso de renderizado principal (Cerebro) y evitar bloquear la interfaz de usuario al ejecutar tareas largas.

Cuando necesitamos ejecutar una tarea larga, enviamos un mensaje al proceso en segundo plano, que ejecuta la tarea de forma asincrónica y envía un mensaje al renderizador principal cuando se completa la tarea.

Esta es la forma en que implementamos el sistema de complementos. Su método inicializeAsync se ejecuta en el proceso en segundo plano.

Requisitos previos

• Nodo.js (>= 16)
• hilo

Instalar cerebro

Primero, clona el repositorio mediante git:

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

abrir el proyecto

 cd cerebro

Y luego instale las dependencias:

yarn

Ejecutar en modo desarrollo

yarn run dev

Nota: requiere una versión de nodo >=16.x

Resolver problemas comunes

1. AssertionError: Current node version is not supported for development en npm postinstall. Después de que el script postinstalación yarn verifique la versión del nodo. Si ve este error, debe verificar la versión del nodo y npm en la sección devEngines package.json e instalar los adecuados.

2. Uncaught Error: Module version mismatch. Exepcted 50, got ... Este error significa que los módulos de nodo con extensiones nativas se compilan con una versión de nodo incorrecta (¡la versión de su nodo local! = versión del nodo, incluida en electron). Para solucionar este problema, ejecute yarn --force

Formato de confirmación convencional

El proyecto utiliza especificaciones de confirmación convencionales para realizar un seguimiento de los cambios. Esto nos ayuda con los lanzamientos y refuerza un estilo consistente. Puedes comprometerte como de costumbre siguiendo este estilo o usar los siguientes comandos que te ayudarán a comprometerte con el estilo correcto:

• yarn cz
• yarn commit

Publicar un comunicado

CerebroApp está utilizando acciones de GH para crear la aplicación y publicarla en un lanzamiento. Para publicar una nueva versión siga los pasos a continuación:

1. Actualice la versión en los archivos package.json y app/package.json .
2. Crea un comunicado de GH y publícalo. ? La etiqueta de lanzamiento DEBE contener el prefijo v ( 0.1.2 → ✅ v0.1.2 ).
3. Complete el nombre con un nombre y una descripción del lanzamiento.
4. La acción de GH se activa y la versión se actualiza cuando se crean los ejecutables.

Licencia

Aplicación MIT © Cerebro