# Auto Click - 自動クリックツール

指定した位置を、指定したタイミングで自動的に左クリックする Windows 向けデスクトップアプリです。

## 主な機能

- **1セット = 次の4ステップ**を自動で実行します
  1. 指定した時間だけ待機する（**時・分・秒**で指定）
  2. 指定した位置へ、指定した時間をかけてマウスを移動する
  3. 指定した時間だけ待機する
  4. 左クリックする
- 待機時間・移動時間はすべて**時・分・秒**で入力できます（秒は小数もOK。例: `0.5` 秒）。長い間隔（例: 1時間30分後にクリック）も指定できます
- **最大3セット**まで設定でき、上から順番に実行します
- 各セットは**個別に有効/無効**を切り替え可能（待機時間・位置を自由に設定）
- **現在のマウス座標 (X, Y) を常時表示**。クリックさせたい場所の座標がすぐ分かります
- **「現在のマウス位置を取得」ボタン**：3秒カウントダウン中に目的の場所へマウスを移動すると、その座標を自動入力します
- 設定は `auto_clicker_settings.json` に自動保存され、次回起動時に復元されます
- **緊急停止**：マウスを画面の左上隅へ素早く動かすと即座に停止します（PyAutoGUI フェイルセーフ）

## 使い方

1. アプリを起動します（`AutoClicker.exe` をダブルクリック）
2. クリックさせたい場所にマウスを置き、上部の「現在のマウス座標」を確認するか、各セットの**「現在のマウス位置を取得」**を押して座標を入力します
3. 各セットの待機時間・移動時間を**時・分・秒**で設定します（秒は小数もOK）
4. 使うセットの「このセットを有効にする」にチェックを入れます
5. **「▶ 開始」**を押すと実行が始まります。**「■ 停止」**または画面左上へのマウス移動でいつでも止められます

## 動作要件

- Windows 10 / 11
- （ソースから動かす場合）Python 3.9 以降

---

## 配布用 .exe の作り方

このアプリは macOS では `.app`、Windows では `.exe` を作る必要があります（PyInstaller は OS をまたいだ変換ができないため、**Windows 用の exe は Windows 環境または下記の GitHub Actions で**作成します）。

### 方法A：GitHub Actions で自動ビルド（おすすめ・Windows PC 不要）

1. このフォルダを GitHub リポジトリに push します
2. リポジトリの **Actions** タブ →「Build Windows EXE」→ **Run workflow** を実行
3. 完了後、画面下の **Artifacts** から `AutoClicker-Windows`（= `AutoClicker.exe`）をダウンロードできます
4. 配布する際は、`git tag v1.0.0 && git push origin v1.0.0` のようにタグを push すると、**Releases ページに exe が自動添付**されます。その URL を配布相手に共有してください

### 方法B：Windows PC でローカルビルド

1. このフォルダを Windows PC にコピー
2. [Python](https://www.python.org/downloads/) をインストール（インストール時に「Add python.exe to PATH」にチェック）
3. `build.bat` をダブルクリック
4. `dist\AutoClicker.exe` が生成されます

> 生成された `AutoClicker.exe` は単体で動作します（Python のインストール不要）。これを配布してください。

---

## 開発環境で動かす（ソースから実行）

```bash
# 依存ライブラリのインストール
python -m pip install -r requirements.txt

# 起動
python auto_clicker.py
```

- **Windows / Linux**：追加設定は不要です
- **macOS**：`pyobjc` が自動で入ります。さらに「システム設定 → プライバシーとセキュリティ → アクセシビリティ」で、実行に使うアプリ（ターミナル等）に**マウス操作の許可**を与えてください

## ファイル構成

| ファイル | 役割 |
|---|---|
| `auto_clicker.py` | アプリ本体 |
| `requirements.txt` | 依存ライブラリ |
| `build.bat` | Windows でローカルに exe を作るスクリプト |
| `.github/workflows/build-windows.yml` | GitHub Actions による自動ビルド設定 |
| `auto_clicker_settings.json` | 設定の保存ファイル（初回実行後に自動生成） |

## 注意事項

本ツールはマウス操作を自動化します。利用規約で自動化が禁止されているサービス（ゲーム等）での使用はお控えください。意図しない場所をクリックしないよう、初回は安全な場所でお試しください。
