ClipboardSync ヘルプ（v1.1.0）

Clipboard Sync ウェブ用マニュアル（日本語）

Clipboard Sync は、Windows のクリップボード内容を Notemod-selfhosted と連携して送受信するための、Windows トレイ常駐アプリです。

Clipboard Sender をベースに拡張されており、現在は テキスト / 画像 / ファイル の送受信、最新を受信ホットキー、バックアップ / メディア削除、多言語 UI に対応しています。

1. バージョン

Clipboard Sync v1.1.0

2. できること

送信

Clipboard Sync は、Windows クリップボードに入った内容を自動で送信できます。

対応している内容:

  • テキスト
  • 画像
  • ファイル

送信先:

  • api.php

送信はトレイ常駐で監視され、送信の有効 / 無効はトレイメニューやホットキー設定で切り替えられます。

受信

Clipboard Sync は、サーバー側にある最新の内容を Windows に受信できます。

受信方法:

  • 最新を受信ホットキー
  • テキストを受信ホットキー
  • 画像を受信ホットキー
  • ファイルを受信ホットキー

受信後の動作:

  • Windows クリップボードへセット
  • 必要に応じて Ctrl+V 自動貼り付け

削除 / 管理

  • INBOX 全削除
  • バックアップ件数表示
  • 画像件数表示
  • ファイル件数表示
  • バックアップ全削除
  • 画像 / ファイル全削除（メディア全削除）
  • 自動 cleanup

3. 必要なサーバー側 API

Clipboard Sync を使うには、Notemod-selfhosted 側に以下の API が必要です。

書き込み

  • api.php

読み取り

  • read_api.php

使用する action:

  • latest_note
  • latest_image
  • latest_file
  • latest_clip_type

cleanup

  • cleanup_api.php

使用する主な操作:

  • category=INBOX
  • purge_bak
  • purge_images
  • purge_files
  • purge_media
  • dry_run=2

4. URL 入力仕様

各 URL 欄は、ディレクトリ入力でもフルパス入力でも利用できます。
内部で用途ごとに自動補正されます。

入力できる例

  • https://example.com/notemod/api/
  • https://example.com/notemod/api
  • https://example.com/notemod/api/api.php
  • https://example.com/notemod/api/read_api.php
  • https://example.com/notemod/api/cleanup_api.php

自動補正のルール

  • POST URL / 接続テスト → api.php
  • Read API URL → read_api.php
  • Cleanup API URL → cleanup_api.php

つまり、ユーザーは /api/ ディレクトリだけ入力しても利用できます。

5. 設定画面

Clipboard Sync の設定画面は、主に Send / Delete タブと Receive タブに分かれています。

6. Send / Delete タブ

POST URL

送信先の API URL を設定します。
ディレクトリのみでも、api.php を含む URL でも構いません。

Token

送信や受信で使う token (EXPECTED_TOKEN) を設定します。

接続テスト

現在入力されている POST URL と token を使って接続確認を行います。

ディレクトリをすべてのAPI URLにコピー

POST URL 欄の値から /api/ ディレクトリ部分を抽出し、次の 2 つへコピーします。

  • Read API URL
  • Cleanup API URL

例

POST URL が次のどれであっても:

  • https://example.com/notemod/api/
  • https://example.com/notemod/api/api.php
  • https://example.com/notemod/api/read_api.php
  • https://example.com/notemod/api/cleanup_api.php

このボタンを押すと:

  • Read API URL → https://example.com/notemod/api/
  • Cleanup API URL → https://example.com/notemod/api/

のようにそろえられます。

送信有効 / 無効

送信監視を ON / OFF にします。

送信成功メッセージ表示

送信成功時にダイアログを出すかどうかを切り替えます。

送信ホットキー

送信の有効 / 無効切り替えなどに使うホットキーを設定します。

Basic 認証

必要に応じて Basic 認証付きの API に接続できます。

設定項目:

  • Username
  • Password

Cleanup API URL / Cleanup Token

cleanup 用 API と token (ADMIN_TOKEN) を設定します。

自動 cleanup

次のどちらかを設定できます。

  • 毎日 1 回
  • X 分ごと

件数表示

現在の設定では、以下の件数を取得できます。

  • バックアップ件数
  • 画像件数
  • ファイル件数

削除ボタン

  • バックアップ全削除
  • メディア全削除（画像 + ファイル）

言語設定

対応言語:

  • English
  • 日本語
  • Türkçe

7. Receive タブ

Read API URL

受信用の API URL を設定します。
ディレクトリのみでも、read_api.php を含む URL でも構いません。

Token

受信に使う token (EXPECTED_TOKEN) を設定します。

ホットキー説明

設定画面上部に、次の説明が表示されます。

ホットキーは、DeleteまたはBackspaceキーで解除できます。

ホットキー構成

受信ホットキーは 2 列で並びます。

  • 最新を受信ホットキー ｜ テキストを受信ホットキー
  • 画像を受信ホットキー ｜ ファイルを受信ホットキー

各ホットキー

  • 最新を受信ホットキー
  • テキストを受信ホットキー
  • 画像を受信ホットキー
  • ファイルを受信ホットキー

自動貼り付け

受信後、自動で Ctrl+V を送る設定です。

クリップボード安定待ち

貼り付け前に少し待つ時間を設定できます。

8. 最新を受信ホットキー

これは v1.1.0 の重要な追加機能です。

read_api.php?action=latest_clip_type を呼び、返ってきた type を見て、何を受信するかを自動判定します。

判定ルール

  • type = note → action=latest_note
  • type = image → action=latest_image
  • type = file → action=latest_file

メリット

サーバー上の最新クリップボードが

  • テキスト
  • 画像
  • ファイル

のどれであっても、1 つのホットキーで最適な受信処理を実行できます。

9. ホットキー解除

各ホットキー欄にフォーカスした状態で、次のどちらかを押すと解除できます。

  • Delete
  • Backspace

解除後は:

  • 表示が Disabled
  • そのホットキーは登録されない

10. 送信の判定優先順位

クリップボードの内容は、次の優先順位で判定されます。

  1. ファイル
  2. 画像
  3. テキスト

つまり、ファイルが入っているときは画像やテキストより優先して送信されます。

11. ループ防止

受信した内容をローカルクリップボードへ入れたとき、その変更がまた自動送信されてしまわないように、内部で抑止時間を設けています。

これにより、

  • 受信
  • ローカルへセット
  • 自動送信
  • 再受信

というループを防ぎます。

12. 自動貼り付けの注意点

自動貼り付けは Ctrl+V を送る方式です。

注意:

  • 管理者権限アプリには貼り付けできない場合があります
  • フォーカス状態によって失敗する場合があります

13. 設定保存と暗号化

設定は Windows ユーザーごとに保存されます。

暗号化対象:

  • token
  • Basic 認証パスワード
  • cleanup token

これらは DPAPI により暗号化されます。

14. v1.1.0 の主な追加・強化点

v1.0.2 からの主な差分:

  • 画像送信
  • ファイル送信
  • 画像受信
  • ファイル受信
  • 最新を受信ホットキー
  • latest_clip_type による受信種別の自動判定
  • 受信ホットキーの複数化
  • Delete / Backspace によるホットキー解除
  • URL 入力の柔軟化
  • 画像件数 / ファイル件数表示
  • メディア全削除
  • 設定画面のレイアウト改善
  • API URL 一括コピー補助ボタン

15. トラブルシュート

送信はできるのに接続テストが失敗する

接続テスト側の URL 正規化や Basic 認証設定を確認してください。

ファイル受信時に名前が期待通りにならない

latest_clip_type のレスポンス内に file.original_name が含まれているか確認してください。

画像 / ファイル件数が取れない

cleanup_api.php 側で purge_images / purge_files / dry_run=2 に対応しているか確認してください。

自動貼り付けが動かない

貼り付け先アプリの権限やフォーカス状態を確認してください。

16. リンク

  • GitHub: https://github.com/StayHomeLabNet/ClipboardSync
  • Help: https://stayhomelab.net/Clipboardsync
  • Notemod-selfhosted: https://github.com/StayHomeLabNet/Notemod-selfhosted
Language
PAGE TOP