ClipboardSender Help (v0.9.2)

ClipboardSender is an app that sends text copied to the Windows clipboard to the Notemod-selfhosted API.
It is mainly designed to make “Windows → iPhone” text transfer easier.

Currently, ClipboardSender is send-only (Windows → Notemod).
To receive text from iPhone → Windows, you need to open Notemod on Windows and read it there.
Two-way support is planned for a future update.

1. What it can do

  • Send text from the Windows clipboard to Notemod-selfhosted
  • Enable/disable sending (“Enable sending”)
  • Toggle ON/OFF using a hotkey (configurable)
  • Optional Basic Authentication (username / password)
  • Connection test (verify your settings)
  • Cleanup API (delete all INBOX notes) setup + scheduled execution (optional)

2. What you need

  • A web server where Notemod-selfhosted is already installed
  • Add-note API: /api/api.php
  • (Optional) Cleanup API: /api/cleanup_api.php
  • API tokens
  • For adding: EXPECTED_TOKEN
  • (Optional) For cleanup: ADMIN_TOKEN
  • (Recommended) Extra protection such as Basic Auth and/or IP restrictions
  • Notemod-selfhosted Help: https://stayhomelab.net/Notemod-selfhosted/
  • Notemod-selfhosted GitHub: https://github.com/StayHomeLabNet/Notemod-selfhosted

3. Quick setup (minimum steps)

  1. Launch ClipboardSender and open the Settings screen
  2. Enter the Notemod add-note API into POST URL
    Example: https://YOUR_SITE/api/api.php
  3. Enter EXPECTED_TOKEN into token
  4. (Optional) If you use Basic Auth, enter Username / Password
  5. Click Connection Test and confirm there are no errors
  6. Adjust as needed:
  • Enable sending (ON/OFF)
  • Show message on success (ON/OFF)
  • Hotkey (click the field, then press your keys)
  1. Click Save

4. Settings items (as shown in the UI)

4.1 POST URL

  • Enter the URL for Notemod’s “Add Note API”
    Example: https://YOUR_SITE/api/api.php

Notes

  • https:// is recommended (instead of http://)
  • Usually you should enter up to api.php (no query string needed)

4.2 token

  • Enter EXPECTED_TOKEN from your Notemod configuration (secret)
  • Use “Show token” to reveal the masked value

4.3 Connection Test

  • Checks whether the API can be reached with the current settings
  • If it fails, first re-check URL / token / Basic Auth

4.4 Show message on success

  • ON: show a notification even when sending succeeds (useful while verifying)
  • OFF: stay quiet during normal use

4.5 Enable sending

  • ON: ClipboardSender sending feature is enabled
  • OFF: nothing will be sent (settings are kept)

Depending on how you operate it, the app may use “auto send” or “hotkey send”.
In either case, if this is OFF, it will not send.

4.6 Hotkey (click, then press)

  • Set the hotkey used to toggle sending ON/OFF
    Example: Ctrl + Alt + N

How to set

  1. Click the hotkey field
  2. Press the key combo you want (e.g. Ctrl + Alt + N)

5. Basic Authentication (optional)

Use this if your Notemod server is protected with Basic Auth.

  • Username
  • Password
  • “Show password”: reveal the masked value

Note

  • Embedding credentials in the URL like https://user:pass@... is an old method and may be blocked by browsers.
    ClipboardSender recommends entering the credentials in the dedicated fields instead.

6. Cleanup API (Delete all INBOX) (optional)

This feature calls Notemod’s Cleanup API to prevent INBOX from growing too large.

  • Because clipboard contents often include personal information, periodically deleting INBOX can provide peace of mind
  • Categories other than INBOX can be deleted by specifying them with category=.
  • You can make Notemod create an automatic backup before deletion (ON/OFF in Notemod-selfhosted config)

This is a dangerous operation that deletes notes in bulk. Use it only if you understand the consequences.

6.1 Cleanup API URL

  • Example: https://YOUR_SITE/api/cleanup_api.php

6.2 Cleanup API token

  • ADMIN_TOKEN is recommended (use a strong value)
  • Use “Show Cleanup token” to reveal the masked value

6.3 Scheduling (choose one)

  • Run INBOX cleanup at a fixed time (once per day)
  • Set hour/minute and it runs daily at that time
  • Run INBOX cleanup every X minutes
  • Set the interval in minutes (e.g. 60 minutes)

Important warnings

  • Deletion cannot be undone (unless Notemod is configured to create backups)
  • If you are concerned, confirm your Notemod-side behavior first (e.g. whether you can do a safe/dry run)
  • To avoid deleting important notes, check your Notemod-selfhosted INBOX before enabling cleanup

7. Language

  • Choose the UI language (e.g. Japanese)
  • Turkish is included to show respect to the original Notemod author

8. Typical usage flow

Windows → iPhone (common workflow)

  1. Copy text on Windows (Ctrl+C, etc.)
  2. ClipboardSender sends it (sending can be toggled ON/OFF with a hotkey)
  3. On iPhone, read it in Notemod (or fetch the latest note via an iOS Shortcut)
  4. Paste on iPhone

9. Troubleshooting

9.1 Nothing is being sent

  • Is “Enable sending” turned OFF?
  • Is the POST URL correct (should be /api/api.php)?
  • Is the token correct (EXPECTED_TOKEN)?
  • If Basic Auth is enabled on the server, did you enter username/password?
  • Is your clipboard content text (images/files may not be sent)?

9.2 Connection Test fails (401/403)

  • Token may be wrong
  • Basic Auth is required but credentials are missing/incorrect
  • Server-side access restrictions for /api/ may be too strict

9.3 Connection Test fails (timeout/network error)

  • URL is wrong / domain is incorrect
  • HTTPS certificate issues (very old environments)
  • Server is temporarily down

10. Security notes

  • Tokens and Basic Auth passwords are secrets
  • If possible, use Basic Auth + token together (layered protection)
  • Be careful not to expose tokens in public repos or screenshots (especially when “Show token” is enabled)

11. FAQ

Q. Can ClipboardSender automatically sync the iPhone clipboard to Windows?

A. Currently, ClipboardSender is send-only (Windows → Notemod).
For iPhone → Windows, you need to open Notemod on Windows and read it there.

Q. Which category does it send to?

A. It depends on your Notemod API behavior. In many setups, if category is not specified, it goes to INBOX.

12. Appendix: Example URLs (Notemod-selfhosted)

  • Add-note API: https://YOUR_SITE/api/api.php
  • Read API: https://YOUR_SITE/api/read_api.php
  • Cleanup API: https://YOUR_SITE/api/cleanup_api.php
Language
PAGE TOP