← Zurück zur Startseite

Capture einrichten

Der Capture-Endpunkt macht aus jeder HTTP-Anfrage eine Aufgabe. Ein Kurzbefehl auf dem Handy, eine Regel im Mailprogramm, eine Zeile in einem Skript — alles, was POST kann.

Hol dir deinen Link

Öffne in okdone Einstellungen → Capture und drücke Capture-Link erstellen. Du bekommst eine Adresse wie https://okdone.app/api/capture/<token>.

Dieser Link ist die Zugangsberechtigung. Wer ihn hat, kann Aufgaben in dein Konto legen — behandle ihn wie ein Passwort. Wird er bekannt, drücke Link erneuern, und der alte funktioniert sofort nicht mehr.

macOS — nach einer Aufgabe fragen

Der für jeden Tag: ein Tastenkürzel, das ein Feld öffnet, eine Zeile Text nimmt, sie ablegt und wieder verschwindet.

  1. Öffne Shortcuts → Ablage → Neuer Kurzbefehl. Nenne ihn Add to okdone.
  2. Suche in der Aktionsliste nach Ask for Input und zieh es hinein. Lass den Typ auf Text, setze Prompt auf New task und lass Default Answer leer — was dort steht, füllt das Feld vor und du löschst es jedes Mal. Hake Allow Multiple Lines an.
  3. Füge darunter Get Contents of URL hinzu und füge deinen Capture-Link ins URL-Feld ein.
  4. Klicke auf Show More, um die Optionen aufzuklappen, und setze Method auf POST.
  5. Füge unter Headers eine Zeile hinzu: Schlüssel Content-Type, Wert text/plain.
  6. Setze Request Body auf File. Wähle im erscheinenden Feld die magische Variable aus der ersten Aktion — je nach macOS-Version heißt sie Ask for Input oder Provided Input.
  7. Drücke ▶ zum Testen. Beim ersten Lauf wird die Erlaubnis erfragt, den Server zu kontaktieren; erteile sie.

Neuere Shortcuts-Versionen bieten nur JSON, Form und File als Body-Typ an — eine reine Text-Option gibt es nicht. File mit einer Textvariablen ist der Weg, einen rohen Body zu senden, und der Content-Type-Header oben sorgt dafür, dass der Server ihn als Text liest.

Gib ihm einen Auslöser

Öffne den Detailbereich ⓘ und nimm den, den du wirklich benutzen wirst:

macOS — markierten Text ablegen

Der, der sich bezahlt macht. Markiere irgendwo einen Satz, Rechtsklick, und er wird zur Aufgabe.

  1. Dupliziere den Kurzbefehl von oben und nenne die Kopie etwa Send to okdone.
  2. Lösche die Aktion Ask for Input.
  3. Tausche in Get Contents of URL die Body-Variable gegen Shortcut Input.
  4. Hake im Detailbereich Use as Quick Action und Services Menu an und stelle die Eingabezeile oben im Editor auf Text.

Er taucht jetzt unter Dienste im Rechtsklickmenü jeder App mit markierbarem Text auf.

iPhone und iPad

Gleiche Aktionen, gleiche Reihenfolge — die Kurzbefehle-App ist die auf deinem Handy. Zwei Dinge lohnen sich zusätzlich:

Den Text formatieren

Was du schickst, wird genauso behandelt wie in der App getippter Text:

Chase the migration rollback #work !p1
Marcel said the ledger needs re-pointing first

Aus einem Skript oder dem Terminal

Bei reinem Text muss der Content-Type ausgeschrieben werden — curl -d schickt standardmäßig form-encoded, was der Server als Formular liest und nicht als deine Aufgabe.

curl -X POST "$CAPTURE_URL" \
  -H 'content-type: text/plain' \
  -d 'Renew the TLS cert #infra !p2'

JSON, wenn du eine Fälligkeit willst:

curl -X POST "$CAPTURE_URL" \
  -H 'content-type: application/json' \
  -d '{"title":"Renew the TLS cert","tags":"infra","due":"2026-08-14T09:00:00Z","priority":2}'

Form-encoded subject / text / from geht ebenfalls — genau so posten Inbound-Mail-Dienste, du kannst also einen auf deinen Capture-Link richten, ohne Code zu schreiben.

Wo alles landet

Einstellungen → Capture hat zwei Ziele, getrennt einstellbar: eines für den Capture-Endpunkt und eines für deine E-Mail-Adresse. Richte sie auf verschiedene Listen, wenn Mail getrennt von dem sortiert werden soll, was du selbst ablegst. Löschst du die Ziel-Liste, fällt Ankommendes in den Posteingang zurück, statt zu verschwinden.

Capture einrichten — okdone