{"id":30717787,"url":"https://github.com/youshinh/gem-clip","last_synced_at":"2026-05-20T05:10:33.773Z","repository":{"id":312530014,"uuid":"1047781988","full_name":"youshinh/gem-clip","owner":"youshinh","description":"A Windows desktop tool to supercharge your productivity by processing clipboard content (text, images, files) with the Google Gemini API via hotkeys.","archived":false,"fork":false,"pushed_at":"2025-08-31T08:52:30.000Z","size":865,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-31T10:22:55.985Z","etag":null,"topics":["automation","claude-code","clipboard-tool","codex-cli","gemini-api","gemini-cli","llm","matrix","ocr-recognition","productivity-tools","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/youshinh.png","metadata":{"files":{"readme":"README.ja.md","changelog":"history_dialogs.py","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-31T08:05:11.000Z","updated_at":"2025-08-31T08:52:33.000Z","dependencies_parsed_at":"2025-08-31T10:23:01.745Z","dependency_job_id":"110755cd-be06-403b-87a6-6fec2e01ea5c","html_url":"https://github.com/youshinh/gem-clip","commit_stats":null,"previous_names":["youshinh/gem-clip"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/youshinh/gem-clip","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youshinh%2Fgem-clip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youshinh%2Fgem-clip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youshinh%2Fgem-clip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youshinh%2Fgem-clip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/youshinh","download_url":"https://codeload.github.com/youshinh/gem-clip/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/youshinh%2Fgem-clip/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273417342,"owners_count":25101817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","claude-code","clipboard-tool","codex-cli","gemini-api","gemini-cli","llm","matrix","ocr-recognition","productivity-tools","python"],"created_at":"2025-09-03T09:02:00.163Z","updated_at":"2026-05-20T05:10:28.735Z","avatar_url":"https://github.com/youshinh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gem Clip\n\n[![メイン画面](img/jp_main_list.png)](img/jp_main_list.png)\n\n**Gem Clip**は、クリップボードの内容やファイルをGoogle Gemini APIで瞬時に処理するためのWindows向けデスクトップツールです。\n\nホットキーを押すだけで、あらかじめ登録したプロンプトを呼び出し、テキストの校正、要約、翻訳、アイデア出し、画像からのテキスト抽出（OCR）など、あらゆるタスクを効率化します。\n\n## ✨ 特徴 (Features)\n\n*   **🚀 ホットキーで即時起動:** `Ctrl+Shift+C`などのホットキーで、いつでもプロンプト選択画面を呼び出せます。\n*   **📋 多様な入力ソース:** クリップボードにあるテキスト、画像、ファイルのパスを自動で認識します。ファイルはドラッグ＆ドロップでも添付可能です。\n*   **🔧 カスタマイズ可能なプロンプト:** あなたのニーズに合わせて、プロンプトを自由に追加・編集・並び替えできます。モデルや温度（Temperature）などのパラメータも個別に設定可能です。\n*   **📊 強力なマトリクス処理:** 複数の入力データ（行）と複数のプロンプト（列）を組み合わせ、一括で処理を実行できます。市場調査の分析や、複数パターンの文章生成などに威力を発揮します。\n*   **🌐 多言語対応:** UIは日本語と英語を切り替え可能です。\n*   **🤫 安全なAPIキー管理:** APIキーはOSの資格情報マネージャーに安全に保存されます。\n\n## 📥 インストール (Installation)\n\n### 前提条件\n\n*   Windows OS\n*   Python 3.9以上\n\n### 手順\n\n1.  **リポジトリのクローン:**\n    ```bash\n    git clone https://github.com/youshinh/gem-clip.git\n    cd gem-clip\n    ```\n\n2.  **依存ライブラリのインストール:**\n    プロジェクトには多数のライブラリが必要です。以下のコマンドでインストールしてください。\n    ```bash\n    pip install google-generativeai customtkinter pystray pillow pyperclip keyring ctkmessagebox\n    ```\n\n3.  **Google AI APIキーの取得:**\n    [Google AI for Developers](https://ai.google.dev/) にアクセスし、APIキーを取得してください。\n\n## 🚀 使い方 (Usage)\n\n### 1. 起動とAPIキー設定\n\n1.  以下のコマンドでアプリケーションを起動します。\n    ```bash\n    python -m gemclip\n    ```\n    初回起動時、タスクトレイにアイコンが表示されます。\n\n2.  タスクトレイのアイコンを右クリックし、「設定 (Settings)」を選択します。\n    [![設定画面](img/jp_setting.png)](img/jp_setting.png)\n\n3.  設定画面が開いたら、「API Key」の欄に取得したGoogle AI APIキーを入力し、「Save \u0026 Close」ボタンを押します。\n\n### 2. プロンプトの管理\n\nタスクトレイメニューから「プロンプト管理 (Prompt Manager)」を開くと、メイン画面が表示されます。\n\n[![プロンプト管理画面](img/jp_prompt_manage.png)](img/jp_prompt_manage.png)\n\n*   **追加:** `+ Add Prompt`ボタンで新しいプロンプトを作成できます。\n*   **編集:** 各プロンプトの「編集 (Edit)」ボタンで、名前、システムプロンプト、モデル、パラメータなどを変更できます。\n*   **並び替え:** 各行の「≡」ハンドルをドラッグ＆ドロップして、プロンプトの表示順を変更できます。\n*   **削除:** 「削除 (Delete)」ボタンで不要なプロンプトを削除します。\n\n[![プロンプト設定画面](img/jp_prompt_setting.png)](img/jp_prompt_setting.png)\n\n### 3. 基本的な使い方（プロンプトの実行）\n\n1.  処理したいテキストや画像をクリップボードにコピーします。\n2.  以下のいずれかの方法でプロンプト選択画面を表示します。\n    *   ホットキー（デフォルト: `Ctrl+Shift+C`）を押す。\n    *   システムトレイのアイコンを左クリックする。\n    *   システムトレイのアイコンを右クリックし、メニューから「リスト表示」を選択する。\n3.  カーソル位置にプロンプト選択ウィンドウが表示されます。実行したいプロンプトをクリックします。\n    [![プロンプト選択画面](img/jp_main_list.png)](img/jp_main_list.png)\n4.  処理が実行され、完了すると結果がクリップボードにコピーされ、デスクトップ通知が表示されます。\n\n### 4. 自由入力\n\nホットキーで表示されるプロンプト選択ウィンドウで「自由入力 (Free Input)」を選ぶと、専用のダイアログが開きます。\n\n[![自由入力画面](img/jp_free_input.png)](img/jp_free_input.png)\n\nここに直接指示を入力して、一度きりのタスクを実行できます。ファイルの添付もこの画面から可能です。\n\n### 5. マトリクス一括処理\n\nタスクトレイメニューから「マトリクス処理 (Matrix Processor)」を選択すると、マトリクス処理ウィンドウが開きます。\n\n1.  **データ入力:** 左側のテキストエリアに、処理したいデータを1行に1アイテムずつ入力します。（例: 商品レビュー、顧客からの質問など）\n    [![マトリクス入力画面](img/jp_matrix_input.png)](img/jp_matrix_input.png)\n\n2.  **プレビューと実行:** 「プレビュー (Preview)」ボタンを押すと、入力データを行、プロンプトを列とする表が生成されます。実行したいセルにチェックを入れ、「選択項目を実行 (Run Selected)」ボタンを押します。\n    [![マトリクスプレビュー画面](img/jp_matrix_preview.png)](img/jp_matrix_preview.png)\n\n3.  **結果の確認:** 処理が完了すると、各セルの結果が表示されます。行ごと、または列ごとのサマリーも生成できます。\n    [![マトリクス結果画面](img/jp_matrix_rowcol_result.png)](img/jp_matrix_rowcol_result.png)\n    [![マトリクスサマリー画面](img/jp_matrix_rowcol_summary.png)](img/jp_matrix_rowcol_summary.png)\n\n## 💻 開発 (Development)\n\n*   **アプリケーションの実行:**\n    ```bash\n    python -m gemclip\n    ```\n    オプション:\n    *   `--lang [en|ja]`: UI言語を指定\n    *   `--theme [system|light|dark]`: テーマを指定\n\n*   **テストの実行:**\n    ```bash\n    python -m pytest -q\n    ```\n\n## 📄 ライセンス (License)\n\nこのプロジェクトは MIT License のもとで公開されています。","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoushinh%2Fgem-clip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyoushinh%2Fgem-clip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoushinh%2Fgem-clip/lists"}