Skip to content

sunfish-shogi/electron-shogi

Repository files navigation

Electron 将棋

Test codecov

English

将棋の GUI アプリです。 コンピューターとの対局や棋譜の編集・検討ができます。

将棋所と同様に USI プロトコル 対応の思考エンジンを利用できます。

コンセプト

私達は既に将棋所やShogiGUIなどの洗練されたソフトウェアで将棋の対局や研究が可能です。 しかし、その多くは個人がクローズドに開発しているものです。 コンピューター将棋界の権威ある開発者もソースコード公開の必要性に言及しています。 Electron 将棋はソースコードを公開しており、そして低い制限のもとで自由に利用・改変が可能です。

Electron 将棋は Web ベースの GUI フレームワークである Electron を使っています。 Web の技術を使うことで将来の幅広い活用を目指しており、機能は限られますが通常のブラウザでも動作します。 Electron は Chromium をバンドルするため、どの OS でも同じ操作性と品質が担保しやすいのも特徴です。

昨今では 2in1 タブレットやコンバーチブル型 PC の普及により、PC 向けの OS でもタッチパネルを使って将棋の対局ができるようになりました。 しかし、 PC 向けの伝統的なアプリケーションは UI コンポーネントが細かく、タッチ操作との相性がよくありません。 Electron 将棋ではタッチ操作のしやすさも重視して UI を設計しています。

Website

https://sunfish-shogi.github.io/electron-shogi/

ウェブサイトではブラウザ版アプリを試すことができます。

Wiki

https://github.com/sunfish-shogi/electron-shogi/wiki

使い方や設計に関する情報はこちらを参照してください。

スクリーンショット

スクリーンショット1

スクリーンショット2

スクリーンショット3

ダウンロード

Releases からダウンロードできます。

エンジン開発者の方へ

USI や CSA プロトコルの通信ログの出力はデフォルトで無効です。 こちら を参考に設定してください。

スクリプトファイルをエンジンとして登録できないという問い合わせが複数来ています。 シェルスクリプトやインタプリタ型言語でエンジンを実行したい方へ を参考にしてください。

不具合報告及びその他の開発協力

プロジェクトへの関わり方について を必ずお読みください。

GitHub のアカウントをお持ちの方は Issue/PullRequest を活用してください。 大きな変更はいきなり着手せず Issue を作成してください。

GitHub アカウントをお持ちでない場合は 送信フォーム でご連絡ください。

開発の進捗状況は プロジェクトボード を参照してください。

開発

必要なもの

  • Node.js

Setup

git clone https://github.com/sunfish-shogi/electron-shogi.git
cd electron-shogi
npm install

Launch

# Electron App
npm run electron:serve

# Web App
npm run serve

Release Build

# Electron App (Installer)
npm run electron:build

# Electron App (Portable)
npm run electron:portable

# Web App
npm run build

Unit Tests

# test only
npm test

# coverange report
npm run coverage

# launch Vitest UI
npm run test:ui

Lint

npm run lint

CLI Tools

  • usi-csa-bridge - USI のエンジンを CSA プロトコルの対局に参加させる。

Licences

Electron Shogi

MIT License

Icon Images

/public/icon 配下のアイコン画像は Material Icons を使用しています。 これには Apache License 2.0 が適用されます。

Dependencies

レンダラープロセスで使用しているライブラリは THIRD PARTY LICENSES を参照してください。

Electron と Chromium については electron-builder によって成果物にバンドルされます。