cerebro

セレブロ

Cerebro は、生産性と効率を向上させるオープンソース ランチャーです。

使用法

最新バージョンはリリースページからダウンロードできます。

• OS のインストーラーがない場合は、ビルド手順を確認してください。
• Linux ユーザーの場合は、実行可能ファイルのインストール方法を参照してください。

インストール後、デフォルトのショートカットctrl+spaceを使用してアプリ ウィンドウを表示します。このショートカットをカスタマイズするには、メニュー バーのアイコンをクリックし、[設定...] を選択します。

プラグイン

コアプラグイン

• お気に入りの検索エンジンでウェブを検索する
• アプリケーション ( spotifyなど) を検索して起動します
• ファイル プレビューを使用してファイル システムを移動します (例: ~/Dropbox/passport.pdf )
• 電卓
• スマートコンバーター。 15$ 、 150 рублей в евро 、 100 eur in gbp 。

プラグインのインストール

Cerebro 検索バーにplugins <plugin-name>と入力すると、さらにプラグインを管理およびインストールできます。

Cerebro の Awesome List でプラグインなどを見つけてください。

独自のプラグインの作成に興味がある場合は、プラグインのドキュメントを確認してください。

ショートカット

Cerebro は、生産性を向上させるためのいくつかのショートカットを提供します。

• ctrl+c : プラグインから結果をクリップボードにコピーします。プラグインが結果を提供しない場合は、導入した用語がコピーされます。
• ctrl+1...9 : リストから結果を直接選択します
• ctrl+[hjkl] : vim のようなキーを使用して結果内を移動します (結果を選択するにはctrl+oも使用します)

テーマの変更

ショートカットctrl+space使用してアプリ ウィンドウを開き、 Cerebro Settingsと入力します。そこでテーマを変更できます。

現在、明るいテーマと暗いテーマはすぐにサポートされています

設定ファイルのパス

構成ファイルは、OS に応じて次のパスにあります。

Windows : %APPDATA%/Cerebro/config.json

Linux : $XDG_CONFIG_HOME/Cerebro/config.jsonまたは~/.config/Cerebro/config.json

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

️設定ファイルが間違っていると、Cerebro が壊れる可能性があります。何をしているのかわからない場合は、構成ファイルを直接編集しないでください。

ソースから実行可能ファイルをビルドする

Cerebro のバージョンをインストールしたいが、実行可能ファイルがリリースされていない場合は、次の手順に従ってソースからビルドできます。

1. リポジトリのクローンを作成する

2. 依存関係を糸でインストールします。

   yarn --force

3. パッケージをビルドします。

    yarn package

注: CI では、実行可能ファイルをパッケージ化して公開するアクションがあるため、 yarn build使用します。

Linux に実行可能ファイルをインストールする

Linux ユーザーの場合は、実行可能ファイルに実行権限を付与する必要がある場合があります。これを行うには、ターミナルを開いて次のコマンドを実行します。

sudo chmod +x < path to the executable >

次に、次のコマンドを実行して実行可能ファイルをインストールできます。

• AppImage 実行可能ファイルを使用している場合:

  ./ < path to the executable >

• deb 実行可能ファイルを使用している場合:

  dpkg -i < path to the executable >

一部のコンピューターでは、昇格した特権 (sudo) でこれらのコマンドを実行する必要がある場合があります。 sudo ./<path to the executable>またはsudo dpkg -i <path to the executable>

貢献する

CerebroApp はオープンソース プロジェクトであり、コミュニティからの貢献を歓迎します。この文書には、Cerebro の仕組みとプロジェクトへの貢献方法に関する情報が記載されています。

️注: このドキュメントは Cerebro 開発者向けです。プラグインの開発方法を探している場合は、プラグイン開発者のドキュメントを参照してください。

一般的なアーキテクチャ

Cerebro は Electron と React に基づいています。

基本的な Electron アプリは、メイン プロセスとレンダラー プロセスで構成されます。メイン プロセスはアプリのライフサイクルを担当し、レンダラー プロセスは UI を担当します。

私たちの場合、次のものを使用します。

• メインプロセスとしてapp/main.development.js
• メインレンダラプロセスとしてのapp/main/main.js
• セカンダリ レンダラー プロセスとしてのapp/background/background.js

これらのファイルはすべて Webpack と Babel にバンドルされ、トランスパイルされます。

ビルドプロセスは、electron-builder によって管理されます。

2 つのレンダラー プロセス

この 2 つのレンダラー プロセス アーキテクチャは、メイン レンダラー プロセス (Cerebro) の応答性を維持し、長いタスクの実行時に UI がブロックされるのを避けるために使用されます。

長いタスクを実行する必要がある場合、バックグラウンド プロセスにメッセージを送信します。バックグラウンド プロセスはタスクを非同期で実行し、タスクが完了するとメイン レンダラーにメッセージを送り返します。

これがプラグイン システムを実装する方法です。そのInitializeAsync メソッドはバックグラウンド プロセスで実行されます。

前提条件

• Node.js (>= 16)
• 糸

セレブロをインストールする

まず、git 経由でリポジトリのクローンを作成します。

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

プロジェクトを開く

 cd cerebro

次に、依存関係をインストールします。

yarn

開発モードで実行する

yarn run dev

注: ノード バージョン 16.x 以上が必要です

よくある問題を解決する

1. AssertionError: Current node version is not supported for development 。 yarnポストインストール スクリプトの後、ノードのバージョンがチェックされます。このエラーが表示された場合は、 package.json devEnginesセクションでノードと npm のバージョンを確認し、適切なものをインストールする必要があります。

2. Uncaught Error: Module version mismatch. Exepcted 50, got ...このエラーは、ネイティブ拡張機能を持つノード モジュールが間違ったノード バージョン (ローカル ノード バージョン != ノード バージョン、electron に含まれる) でビルドされていることを意味します。この問題を解決するには、 yarn --forceを実行します。

従来のコミット形式

プロジェクトは、変更を追跡するために従来のコミット仕様を使用しています。これは実現に役立ち、一貫したスタイルを強制します。通常どおりこのスタイルに従ってコミットすることも、適切なスタイルでコミットするのに役立つ次のコマンドを使用することもできます。

• yarn cz
• yarn commit

リリースを発行する

CerebroApp は、GH アクションを使用してアプリを構築し、リリースに公開します。新しいリリースを公開するには、次の手順に従います。

1. package.jsonファイルとapp/package.jsonファイルの両方のバージョンを更新します。
2. GH からリリースを作成し、公開します。 ?リリースタグにはvプレフィックス ( 0.1.2 → ✅ v0.1.2 ) が含まれていなければなりません。
3. 名前とリリースの説明を入力します。
4. 実行可能ファイルがビルドされると、GH アクションがトリガーされ、リリースが更新されます。

ライセンス

MIT ©セレブロアプリ