Skip to content

iOS Shortcuts

Jump to bottom
Holger Imbery edited this page May 10, 2026 · 2 revisions

iOS Shortcuts

PigeonPost works with the built-in Shortcuts app (German: Kurzbefehle) on any iPhone or iPad on the same Wi-Fi network.

Before you start / Vor dem Start:
Find your PC's IP address in the PigeonPost address card (e.g. 192.168.1.205).
Replace YOUR_PC_IP / DEINE_PC_IP in every URL below.

iOS Shortcuts only offers JSON / Form / File as body types — there is no plain-text option.
PigeonPost accepts JSON {"text":"…"} as well as plain text, so both curl and Shortcuts work.

Shortcut 1 — Send iPhone clipboard to Windows / Zwischenablage an Windows senden

What it does: Sends whatever is copied on your iPhone to the Windows clipboard.
Was es tut: Sendet die iPhone-Zwischenablage an die Windows-Zwischenablage.

English steps

  1. Open Shortcuts → tap + (top right)
  2. Add Action → search Get Contents of URL → tap it
  3. Configure the action:
    • URL: http://YOUR_PC_IP:2560
    • Method: POST
    • Tap Headers → add a header: Key clipboard / Value send
    • Tap Request Body → select JSON
    • Add a field: Key text / Value → tap the variable button (+) → choose Clipboard
  4. Tap the shortcut name at the top → rename to e.g. 📋 → Windows
  5. Tap Done

Deutsche Schritte

  1. Kurzbefehle öffnen → oben rechts + tippen
  2. Aktion hinzufügen → Inhalt der URL abrufen suchen → auswählen
  3. Aktion konfigurieren:
    • URL: http://DEINE_PC_IP:2560
    • Methode: POST
    • Header antippen → Header hinzufügen: Schlüssel clipboard / Wert send
    • Anforderungstext antippen → JSON wählen
    • Feld hinzufügen: Schlüssel text / Wert → Variable-Taste (+) → Zwischenablage wählen
  4. Namen oben antippen → umbenennen z. B. 📋 → Windows
  5. Fertig tippen

Shortcut 2 — Get Windows clipboard on iPhone / Windows-Zwischenablage auf iPhone lesen

What it does: Reads the current Windows clipboard and copies the text to your iPhone clipboard.
Was es tut: Liest die Windows-Zwischenablage und kopiert den Text auf das iPhone.

English steps

  1. Open Shortcuts → tap +
  2. Add Action → search Get Contents of URL → tap it
  3. Configure:
    • URL: http://YOUR_PC_IP:2560
    • Method: POST
    • Headers → Key clipboard / Value receive
    • (No request body needed)
  4. Add Action → search Copy to Clipboard → tap it
    (the URL result is passed automatically as the text to copy)
  5. Rename to Windows → 📋 → Done

Deutsche Schritte

  1. Kurzbefehle → + tippen
  2. Aktion hinzufügen → Inhalt der URL abrufen → auswählen
  3. Konfigurieren:
    • URL: http://DEINE_PC_IP:2560
    • Methode: POST
    • Header → Schlüssel clipboard / Wert receive
    • (Kein Anforderungstext nötig)
  4. Aktion hinzufügen → In Zwischenablage kopieren suchen → auswählen
    (das URL-Ergebnis wird automatisch als Text übergeben)
  5. Umbenennen: Windows → 📋 → Fertig

Shortcut 3 — Send photo to Windows / Foto an Windows senden

What it does: Picks a photo from your gallery, converts it to JPEG, and uploads it to the Windows Downloads folder with a timestamped filename.
Was es tut: Wählt ein Foto aus der Galerie, konvertiert es zu JPEG und lädt es mit einem Zeitstempel-Dateinamen in den Windows-Downloads-Ordner hoch.

English steps

  1. Open Shortcuts → +
  2. Add Action → search Select Photos → tap it
    (leave "Select Multiple" off for a single photo)
  3. Add Action → search Convert Image → tap it
    Set Format to JPEG and Quality to Best
  4. Add Action → search Format Date → tap it
    • Date: tap the variable button (+) → choose Current Date
    • Format: select Custom → type yyyyMMdd-HHmmss

⚠️ Important — literal prefixes in custom date formats:
iOS Shortcuts uses ICU date-format codes where every letter has a special meaning — even f, o, t.
If you want a literal prefix like foto-, wrap it in single quotes: 'foto-'yyyyMMdd-HHmmss
Without quotes, iOS expands those letters as format codes, producing unexpected characters that can break the URL.
The safe default (no prefix) yyyyMMdd-HHmmss always works without quoting.

  1. Add Action → search Get Contents of URL → tap it, configure:
    • URL: type http://YOUR_PC_IP:2560?filename= → tap + → choose Formatted Date → type .jpg directly after it
      (the full URL will look like http://192.168.1.205:2560?filename=2026-05-01_13-00-00.jpg)
    • Method: POST
    • Request Body → select File
    • File value: tap + → choose Converted Image
  2. Rename to 📸 → Windows → Done

Deutsche Schritte

  1. Kurzbefehle → + tippen
  2. Aktion hinzufügen → Fotos auswählen suchen → auswählen
    ("Mehrere auswählen" ausgeschaltet lassen für ein einzelnes Foto)
  3. Aktion hinzufügen → Bild konvertieren suchen → auswählen
    Format: JPEG, Qualität: Beste
  4. Aktion hinzufügen → Datum formatieren suchen → auswählen
    • Datum: Variable-Taste (+) → Aktuelles Datum wählen
    • Format: Benutzerdefiniert → yyyyMMdd-HHmmss eingeben

⚠️ Wichtig — Literale Präfixe in benutzerdefinierten Datumsformaten:
iOS Kurzbefehle verwendet ICU-Datumsformat-Codes, bei denen jeder Buchstabe eine Sonderbedeutung hat — auch f, o, t.
Wenn du ein Präfix wie foto- verwenden möchtest, schreibe es in einfachen Anführungszeichen: 'foto-'yyyyMMdd-HHmmss
Ohne Anführungszeichen interpretiert iOS diese Buchstaben als Format-Codes und erzeugt unerwartete Zeichen, die die URL kaputtmachen können.
Der sichere Standard (ohne Präfix) yyyyMMdd-HHmmss funktioniert immer ohne Anführungszeichen.

  1. Aktion hinzufügen → Inhalt der URL abrufen suchen → auswählen, konfigurieren:
    • URL: http://DEINE_PC_IP:2560?filename= eingeben → + → Formatiertes Datum wählen → direkt danach .jpg eingeben
      (Ergebnis: http://192.168.1.205:2560?filename=2026-05-01_13-00-00.jpg)
    • Methode: POST
    • Anforderungstext → Datei wählen
    • Datei-Wert: + → Konvertiertes Bild wählen
  2. Umbenennen: 📸 → Windows → Fertig

Tip / Tipp: Add any shortcut to your iPhone Home Screen:
Open the shortcut → tap ⋯ (top right) → Add to Home Screen.
Kurzbefehl zum Home-Bildschirm hinzufügen: Kurzbefehl öffnen → ⋯ (oben rechts) → Zum Home-Bildschirm.

Bearer Token Authentication / Authentifizierung mit Bearer Token

PigeonPost supports optional bearer token authentication. When enabled, every request must include an Authorization header — otherwise the server returns 401 Unauthorized.

PigeonPost unterstützt optionale Authentifizierung mit Bearer Token. Wenn aktiviert, muss jede Anfrage einen Authorization-Header enthalten — andernfalls antwortet der Server mit 401 Unauthorized.

Step 1 — Enable authentication in PigeonPost (Windows) / Authentifizierung in PigeonPost aktivieren (Windows)

English

  1. Open PigeonPost → click the ⚙️ gear button (Settings).
  2. Under Security, turn on Require bearer token authentication.
  3. A token is pre-generated. Click the copy icon next to the token field to copy it to your clipboard.
  4. Click Save.

You can click Regenerate to create a new token at any time — all clients must then be updated with the new value.

Deutsch

  1. PigeonPost öffnen → ⚙️-Schaltfläche (Einstellungen) anklicken.
  2. Unter Sicherheit den Schalter Authentifizierung mit Bearer Token erforderlich aktivieren.
  3. Ein Token ist vorausgefüllt. Auf das Kopieren-Symbol neben dem Token-Feld klicken, um es in die Zwischenablage zu kopieren.
  4. Speichern klicken.

Über Neu generieren kann jederzeit ein neues Token erstellt werden — alle Clients müssen dann mit dem neuen Wert aktualisiert werden.

Step 2 — Add the Authorization header to each Shortcut / Authorization-Header zu jedem Kurzbefehl hinzufügen

Every Get Contents of URL action in your shortcuts needs one additional header.

Jede Inhalt der URL abrufen-Aktion in deinen Kurzbefehlen braucht einen zusätzlichen Header.

English steps

  1. Open the shortcut you want to update → tap ⋯ (top right).
  2. Tap the Get Contents of URL action to expand it.
  3. Tap Headers.
  4. Tap Add new header.
  5. Set the key to Authorization and the value to Bearer followed by your token
    (example: Bearer abc123xyz…)
  6. Tap Done.

Repeat for every shortcut that talks to PigeonPost.

Deutsche Schritte

  1. Zu aktualisierenden Kurzbefehl öffnen → ⋯ (oben rechts) antippen.
  2. Auf die Aktion Inhalt der URL abrufen tippen, um sie aufzuklappen.
  3. Header antippen.
  4. Neuen Header hinzufügen antippen.
  5. Schlüssel Authorization eingeben, Wert: Bearer gefolgt von deinem Token
    (Beispiel: Bearer abc123xyz…)
  6. Fertig tippen.

Diesen Schritt für jeden Kurzbefehl wiederholen, der mit PigeonPost kommuniziert.

Troubleshooting / Fehlerbehebung

Symptom Cause / Ursache Fix / Lösung
Shortcut returns 401 Unauthorized Auth is enabled but the Authorization header is missing or the token is wrong Add / correct the header in each shortcut (Step 2 above)
Shortcut works without the header Auth is not enabled in Settings Enable "Require bearer token authentication" if you want protection
401 after regenerating the token The old token is still in the shortcut Open each shortcut → update the Authorization header value
Symptom Ursache Lösung
Kurzbefehl liefert 401 Unauthorized Auth aktiviert, aber Authorization-Header fehlt oder Token ist falsch Header in jedem Kurzbefehl hinzufügen / korrigieren (Schritt 2 oben)
Kurzbefehl funktioniert ohne Header Auth ist in den Einstellungen nicht aktiviert „Authentifizierung mit Bearer Token erforderlich" aktivieren
401 nach Token-Neugenerierung Alter Token ist noch im Kurzbefehl Jeden Kurzbefehl öffnen → Wert des Authorization-Headers aktualisieren

PigeonPost

Using PigeonPost

Developer

Support

Back to repo

Clone this wiki locally