Files
tauclock/README.md
2026-01-12 01:34:32 +09:00

61 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TauClock
TauClockは、ローカル/UTC時計、アラーム、カウントダウンタイマー、ストップウォッチを1つのネイティブウィンドウにまとめたTauriアプリケーションです。キーボード操作を前提に設計しており、記録したアラームやラップはローカルストレージに保存されます。
## 主な特徴
- リアルタイムなローカル・UTC時計の並列表示
- 任意ラベル付きの繰り返しアラーム(オフラインでも保持)
- 柔軟な入力形式に対応したカウントダウンタイマー(`5m30s`, `1:15`, `90` など)
- ラップ記録つきストップウォッチと履歴リスト
- キーボードショートカットと画面内に表示できるチートシート
- Tauri + Rust製の軽量クロスプラットフォームバイナリ
## キーボードショートカット
| キー | 動作 |
| --- | --- |
| `H` | ショートカット一覧を開閉 |
| `A` | アラームの時刻入力欄にフォーカス |
| `N` | アラームを追加 |
| `T` | タイマーの時間入力欄にフォーカス |
| `G` | タイマー開始/一時停止 |
| `R` | タイマーをリセット |
| `W` | ストップウォッチ開始/停止 |
| `L` | ラップを追加 |
| `P` | ストップウォッチをリセット |
| `Esc` | 入力フォーカス解除 or オーバーレイを閉じる |
## ディレクトリ構成
- `src/` フロントエンドHTML/CSS/JavaScript`main.js` には各ウィジェットのロジックと詳しいコメントがあります。
- `src-tauri/` Rust製バックエンドおよびTauri設定。`lib.rs` にプラグインやコマンドの初期化がまとまっています。
- `src-tauri/tauri.conf.json` アプリの識別子やアイコン設定。
## 開発環境
### 事前準備
- [Node.js](https://nodejs.org/) 18 以上
- npm または好きなパッケージマネージャ
- [Rust](https://www.rust-lang.org/tools/install) と `cargo`
- Tauriの推奨コンパイラ/プラットフォーム依存ツール([公式ドキュメント](https://tauri.app/start/prerequisites/)を参照)
### セットアップ
```bash
npm install
```
### ローカルで起動
```bash
npm run tauri dev
```
ホットリロード付きでウィンドウが立ち上がり、UIから各機能を試せます。
### ビルド
```bash
npm run tauri build
```
`src-tauri/target/release/` 以下に配布用バイナリが生成されます。
## コントリビュート
Issue/PRは歓迎です。バグ報告の際は実行環境・手順を明記してください。新機能追加時は `src/main.js` にあるコメントスタイルに合わせてドキュメントも更新してください。
## ライセンス
MIT License. 詳細は `LICENSE` を参照してください。