Repository files navigation

Copyright (c) 2025 led-mirage

English

SAPIClip（サピクリップ）は、Windows用のユーティリティプログラムで、クリップボードにコピーされたテキストを自動的に読み上げます。SAPI5を利用した多言語対応の音声合成を特徴とし、言語の自動検出も行います。仕事や勉強の効率化に最適なツールです。

• 自動クリップボード監視: クリップボードに新しいテキストがコピーされると、自動で検出し読み上げを開始します。
• 多言語対応の音声合成: SAPI5を使用し、さまざまな言語を自動で読み上げることができます。
• 音声の切り替え: 利用可能な音声（話者）間で簡単に切り替えができ、好みの声を選択できます。
• 言語の自動検出: 話者をAutoにすることで言語の自動検出も行い、対応する音声での合成を実現します。
• 話速設定: 話速を調節できるので、自分の好みに合わせて音声の速さを変更可能です。
• シンプルなインターフェース: GUIは直感的に操作でき、コンパクトなため邪魔になりなりません。
• 繰り返し再生: 最後に読み上げた内容を簡単に再生し直すことができます。

• Windows 11 Pro 24H2
• Python 3.12.0

※アプリケーションは Windows 10でも、Homeエディションでも動作すると思いますが、その環境でのテストは行っていません。

任意の場所にプロジェクト用のフォルダを作成してください。

以下のリンクから SAPIClip.ZIP をダウンロードして、作成したフォルダに解凍してください。

https://github.com/led-mirage/SAPIClip/releases/tag/v0.1.0

SAPIClip.exe をダブルクリックすればアプリが起動します。

任意の場所にプロジェクト用のフォルダを作成してください。

ターミナルかコマンドプロンプトを起動して、作成したプロジェクトフォルダに移動します。

ZIPファイルをダウンロードして作成したフォルダに展開してください。
または、Gitが使える方は以下のコマンドを実行してクローンしてもOKです。

git clone https://github.com/led-mirage/SAPIClip.git

以下のコマンドを実行して必要なライブラリをインストールします。

pip install -r requirements.txt

以下のコマンドを実行するとアプリが起動します。

python src\application.py

settings.jsonファイルにはこのアプリの設定情報が記載されています。

※プログラム引数で設定ファイル名を渡すことで、使用する設定ファイルを切り替えることができます。
例）SAPIClip --setting my_settings.json

使用する音声名を記載します。Autoを指定すると、読み上げるテキストにあった音声を自動選択し読み上げます。

読み上げの速さの設定です。アプリのGUIで設定できます。

読み上げるテキストの置換設定です。置換対象（pattern）を正規表現で、置換後の文字列（replacement）を通常の文字列で指定します。

例えば括弧内のテキストと、URLを除去して読み上げたい場合は、以下のように設定します。置換パターンは複数個記載でき、上から順に処理されます。

"replacements": [        {"pattern":"\\(.*?\\)|（.*?）","replacement":""        },        {"pattern":"https?:\\/\\/(?:[\\w\\-\\.]+)+(?:[\\w\\.\\/\\?%&=]*)?","replacement":""        }    ]

音声がAutoの際に優先される音声名を言語ごと指定できます。下記既定値では、テキストが英語の場合にはMicrosoft Ziraが使われ、日本語の場合ではMicrosoft Harukaが使用されます。

テキストから推論された言語の音声がインストールされていない場合は、ここで指定した最初の言語の音声が使用されます。例えば、テキストがフランス語でフランス語の音声がインストールされていない場合、Microsoft Ziraで読み上げようと試みます。

"preferred_voices": {"en": ["Microsoft Zira Desktop"        ],"ja": ["Microsoft Haruka"        ]    }

Windows 11で音声を追加する方法を説明します。

1. Windowsの設定を開き、時刻と言語 -音声認識と進みます。
2. 音声の管理の音声を追加ボタンを押して、インストールしたい言語を追加します。

注意事項: 追加ボタンを押してもすぐには反映されません。インストールの経過も表示されないので不安になりますが、しばらく待つとインストールされます。ちょっと不親切なインターフェイスです。

このプログラムの実行ファイル（SAPIClip.exe）は PyInstaller というライブラリを使って作成していますが、ウィルス対策ソフトにマルウェアと誤認されることがあります。

もちろん、このアプリに悪意のあるプログラムは入っていませんが、気になる人は上記の「Pythonで実行する方法」で実行してください。

誤認問題が解決できるのが一番いいのですが、いい方法が見つかっていないので申し訳ありませんがご了承ください。

VirusTotalでのチェック結果は以下の通りです（2025/01/31 v0.1.0）
SAPIClip.exe … 72個中6個のアンチウィルスエンジンで検出

ホームページ：https://requests.readthedocs.io/en/latest/
ライセンス：Apache License 2.0

ホームページ：https://github.com/asweigart/pyperclip/tree/master
ライセンス：BSD 3-Clause "New" or "Revised" License

ホームページ：https://github.com/python-pillow/Pillow
ライセンス：MIT-CMUライセンス

ホームページ：https://github.com/Mimino666/langdetect
ライセンス：Apache License 2.0

ホームページ：https://github.com/mhammond/pywin32
ライセンス：PSF-2.0 license

© 2025 led-mirage

本アプリケーションはMITライセンス の下で公開されています。詳細については、プロジェクトに含まれる LICENSE ファイルを参照してください。

• ファーストリリース