学習時間記録アプリ / Study Tracker App

日本語版 README です。英語版は README.en.md をご覧ください。
This is the Japanese README. For the English version, see README.en.md.

---

📦 ダウンロード

最新版は GitHub Releases からダウンロードできます。

👉 Releases からダウンロード

• STR-Setup.exe — Windows インストーラー
• STR-x64.exe — Windows ポータブル版 (x64)
• STR-ia32.exe — Windows ポータブル版 (ia32)
• STR-mac-x64.dmg — macOS x64
• STR-mac-arm64.dmg — macOS Apple Silicon

公開方法（開発者向け）

v1.0.0 のようなタグを push すると、GitHub Actions が自動でビルドして Releases に添付します。

git tag v1.0.0
git push origin v1.0.0

概要

このアプリは、学習時間をワンタップで記録するためのデスクトップアプリです。
開始・一時停止・再開・終了を行い、最後に学習内容をカレンダー形式で保存できます。

主な機能

• 学習時間の 開始 / 一時停止 / 再開 / 終了
• 学習カテゴリと詳細内容の入力
• Google Calendar へのイベント作成
• iCalendar (.ics) ファイルのダウンロード
• カスタムカテゴリの追加（日本語 / 英語 / ドイツ語へ自動翻訳）
• ライト / ダークモード の切り替え
• 言語設定・テーマ設定・保存先設定を localStorage に保存

使用技術

• Electron
• React
• react-scripts
• @testing-library/react

アーキテクチャ

Electron (Main Process)
        ↓
React UI (Renderer)
        ↓
LocalStorage / ICS Generator / Google Calendar Draft

セットアップ

npm install
npm --prefix ui install

開発起動

npm run dev

主なコマンド

コマンド	説明
npm run dev	React 開発サーバーと Electron を同時起動
npm run react:start	UI のみ開発起動
npm run react:build	React UI を本番ビルド
npm run dist:win	Windows x64 版をビルド
npm run dist:win32	Windows ia32 版をビルド
npm run dist:win:all	Windows x64 / ia32 をまとめてビルド
npm run dist:mac	macOS x64 版をビルド
npm run dist:mac:arm64	macOS arm64 版をビルド
npm run move:exe	dist 配下の実行ファイルをトップへコピーして整理

Windows ビルド後の出力

npm run dist:win:all 実行後、トップフォルダに次の名前で取り出せます。

• STR-Setup.exe : Windows インストーラー
• STR-x64.exe : x64 ポータブル実行ファイル
• STR-ia32.exe : ia32 ポータブル実行ファイル

このアプリを作った理由

Windows / macOS の両方で動作し、オフラインで学習記録アプリを作りたかったためです。
また、Google Calendar や .ics ファイルへ学習セッションを簡単に書き出せるようにしています。

プライバシー

• 設定情報は localStorage を使ってローカルに保存されます。
• 外部通信は Google Calendar を開く時やカテゴリ自動翻訳時に限られます。
• 解析用のトラッキングや広告 SDK は含んでいません。

補足

• 開発時の既定言語は 日本語 です。
• カテゴリ追加時の自動翻訳は translate.googleapis.com を利用しています。