An open API service indexing awesome lists of open source software.

https://github.com/void2610/flyt


https://github.com/void2610/flyt

Last synced: 4 months ago
JSON representation

Awesome Lists containing this project

README

          

# Flyt

フルスクリーンアプリの上にも表示できるmacOS用ポモドーロタイマーアプリ

## 主な機能

### ポモドーロタイマー
- 作業時間と休憩時間をカスタマイズ可能(デフォルト: 作業30分、休憩10分)
- セッション完了時に自動でウィンドウを表示
- 次のセッションは手動で開始(集中を妨げない設計)

### セッションカウント
- 1日の完了セッション数を記録
- 毎日0時に自動リセット
- 設定画面から手動リセットも可能
- Googleアカウントでログインしてクラウド同期が可能(オプション)

### フルスクリーン対応
- 全てのアプリケーションの上に表示可能
- フローティングウィンドウでどこでも作業可能

### ホットキー
- グローバルキーボードショートカット(デフォルト: Control+I)
- ユーザーが自由にカスタマイズ可能
- どこからでも瞬時にタイマーを呼び出し

### ホットエッジ
- 画面の辺(上下左右)にマウスを移動してタイマーを表示(オプション)
- エッジ判定幅とトリガー遅延時間を調整可能
- クールダウン機能で連続トリガーを防止

### クラウド同期
- Googleアカウントでログイン(任意)
- 複数デバイス間でセッション数を同期
- ログインしなくてもローカルで使用可能

## インストール方法

1. [Releases](https://github.com/void2610/flyt/releases) から最新版の `Flyt.zip` をダウンロード
2. ZIPファイルを解凍
3. `Flyt.app` を `/Applications` フォルダに移動
4. アプリを起動し、アクセシビリティ権限を許可
- システム設定 > プライバシーとセキュリティ > アクセシビリティ

## 使い方

### 基本的な使い方
1. メニューバーのアイコンをクリックするか、ホットキー(デフォルト: Control+I)でタイマーを表示
2. 中央のボタンでタイマーを開始
3. セッション完了時に自動でウィンドウが表示されます
4. Escキーでウィンドウを閉じる

### 設定のカスタマイズ
- **一般設定**: 作業時間と休憩時間を変更
- **ホットキー設定**: キーボードショートカットをカスタマイズ
- **ホットエッジ設定**: 画面の辺からの起動を有効化
- **同期設定**: Googleアカウントでログインしてクラウド同期
- **アクセシビリティ設定**: 権限状態の確認

## 開発

### ビルド方法

```bash
# リリースビルドして /Applications にインストール
bash build-and-install.sh

# または手動ビルド
xcodebuild -project Flyt.xcodeproj -scheme Flyt -configuration Release build
```

**重要**: アクセシビリティ権限の永続化のため、`build-and-install.sh` を使用して `/Applications` にインストールすることを推奨します。

### 技術スタック
- SwiftUI
- AppKit(NSWindow、NSEvent)
- Supabase(クラウド同期)
- Combine(リアクティブプログラミング)

## ライセンス

MIT License

## 作者

[@void2610](https://github.com/void2610)