Dokumentation zur Automatisierung
Befehlszeilenreferenz
Integriere popCalendar in deinen Dock-Ersatz oder andere Mac-Werkzeuge. Öffne Kalender, wähle Daten, verwalte Pläne und exportiere Bilder über die CLI.
Diese Anleitungen gelten für popCalendar 1.3 und neuer. Einige Aktionen benötigen eine neuere Systemversion, wie unten angegeben.
Ein vollwertiger Kalender für dein Werkzeug
Ergänze deinen Dock-Ersatz, App-Launcher, dein Menüleistenprogramm oder ein anderes Mac-Werkzeug um popCalendar. Biete einen funktionsreichen Kalender, ohne ihn selbst zu entwickeln, und nutze über die CLI native Kalenderfenster, verankerte Popups und die Datumsauswahl.
Entwickler können sich an uns wenden, um einen kostenlosen popCalendar-Promocode und praktische Unterstützung bei der Umsetzung einer Integration zu erhalten.
Kontaktiere support@apptrust.app
Jedes Werkzeug mit popCalendar-Integration erhält einen eigenen Bereich auf popcalendar.app als offiziell unterstützte Integration. Gib uns Bescheid, sobald deine Integration bereit ist.
Zurück zum InhaltDirekt aus dem App-Paket starten
Wenn popCalendar installiert ist, wird kein separates CLI-Paket benötigt. Rufe die Hauptprogrammdatei über ihren vollständigen Pfad auf. Jeder Befehl beginnt mit --. Ohne Befehl startet die App normal.
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --helpDu kannst das Verzeichnis der Programmdatei optional für die aktuelle Terminalsitzung an PATH anhängen. Dieselbe Zeile kannst du selbst in deine Shell-Konfiguration eintragen. Verwende den tatsächlichen Speicherort, falls die App verschoben oder umbenannt wurde. Die Setapp-Programmdatei heißt ebenfalls popCalendar. Wähle bei zwei installierten Ausgaben die gewünschte über den vollständigen Pfad.
export PATH="${PATH:+$PATH:}"'/Applications/popCalendar.app/Contents/MacOS'
popCalendar --help Zurück zum Inhalt Einen Kalender im Terminal anzeigen
Mit --terminal gibst du einen Kalender aus, ohne ein Kalenderfenster zu öffnen. Aktiviere zuerst Terminal-Kalender unter Einstellungen > Automatisierung & Datenschutz. Vorschau öffnet einen Beispieldialog mit kopierbaren Befehlen. Einfache Kalender laufen lokal. Angeforderte private Daten werden im Hintergrund über die App gelesen.
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --terminal
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --terminal --interactive
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --terminal --year 2027Ohne ausdrückliche Layoutwahl wird ein ganzes Jahr angezeigt, wenn es passt, andernfalls ein Monat. Der interaktive Modus passt sich Größenänderungen an, bis du ein Layout oder einen Zeitraum auswählst. Pipes, JSON und reine Terminlisten verwenden standardmäßig einen Monat.
Zurück zum InhaltTermine, Pläne und Arbeitstage
Mit --events blendest du Termine ein, mit --agenda eine Terminliste, mit --plans gespeicherte Pläne und mit --working-days deinen Arbeitsplan. Ein Kalendergruppenfilter gilt nur für diesen Befehl und ändert die aktive Gruppe nicht. --search durchsucht Titel und Orte. Erlaube den Kalenderzugriff in der App, bevor du Termine anforderst.
popCalendar --terminal --events today --agenda
popCalendar --terminal --events week --calendar-set current
popCalendar --terminal --months 3 --plans all --working-days
popCalendar --terminal --events month --search meeting --limit 20
popCalendar --terminal --start 2027-03-01 --end 2027-03-14 --events rangeDie Option week bezeichnet die nächsten sieben Tage ab --date oder ab heute. Ein Zeitraum schließt beide Enddaten ein. Ohne ausdrückliche Auswahl umfassen Termine für range die angezeigten Monate. Daten und Überschriften verwenden den gregorianischen Kalender.
Zurück zum InhaltIm interaktiven Modus navigieren
Mit Pfeilen oder h/j/k/l wechselst du zwischen Tagen, mit n/p zwischen Zeiträumen, mit m/y zwischen Monat und Jahr und mit t zu heute. Drücke v, um Anfang und Ende eines Bereichs zu markieren, c zum Löschen, g für ein bestimmtes Datum, / zum Suchen und ? für Hilfe. Mit q oder Escape beendest du den Modus.
Schalte Termine mit e, die Terminliste mit a, Pläne mit b, Arbeitstage mit d und Wochennummern mit w um. Drücke s für die nächste Kalendergruppe, r zum Aktualisieren und PageUp/PageDown oder Space zum Scrollen.
Ausgeschriebene Befehle funktionieren ebenfalls und unterscheiden nicht zwischen Groß- und Kleinschreibung. Im Modus mit direkter Tastenreaktion drückst du zuerst die Doppelpunkt-Taste, gibst den Befehl ein und drückst Enter. Wenn die Fußzeile Enter verlangt, gib den Befehl direkt ein und drücke Enter. Escape bricht zuerst eine aktive Eingabe ab, bevor es den Modus beendet.
month year next previous today
left right up down range clear
events agenda plans working-days sets week-numbers
goto 2027-03-01
search meeting
refresh page-up page-down home end
help quit exit Zurück zum Inhalt Optionen für die Terminalausgabe
Wähle ein Datum, einen Monat, ein Jahr, einen Modus oder 1 bis 24 Monate. Verwende --start und --end gemeinsam und ohne weitere Datums- oder Modusoption. Mit --time-zone, --first-weekday und --week-numbers steuerst du den Kalender. --width erlaubt 32 bis 240 Spalten, --limit 1 bis 500 Termine und --color die Werte auto, always oder never.
popCalendar --terminal --mode two-years --date 2027-01-01 --week-numbers
popCalendar --terminal --month 2027-03 --time-zone Europe/Kyiv --first-weekday monday
popCalendar --terminal --year 2027 --width 120 --color never > calendar.txt
popCalendar --terminal --events today --json > agenda.jsonUmgeleitete Ausgabe ist Klartext. --json liefert strukturierte Daten ohne ANSI-Formatierung und lässt sich nicht mit --interactive oder --color always kombinieren. Terminalbefehle lesen nur und ändern keine Termine, Pläne oder Kalendergruppen.
Zurück zum InhaltKalender öffnen und steuern
Optionen akzeptieren --option wert oder --option=wert. Die Standardsitzung heißt cli. Die Wiederverwendung einer Sitzung aktualisiert dasselbe Fenster. Verwende unterschiedliche Namen für unabhängige Fenster. Alle sechs Ansichten werden unterstützt.
popCalendar --open --session work --mode two-years --date 2027-01-01
popCalendar --popup --session picker --mode month --anchor 400,850,40,24 --size 520x720
popCalendar --update --session picker --date 2027-03-01
popCalendar --move --session picker --anchor 600,850,40,24
popCalendar --close --session pickerVerwende für eine Vollbildansicht --presentation fullscreen mit --display current, main oder einer Display-UUID. Sie füllt einen Bildschirm, ohne einen macOS-Space anzulegen. Escape oder erneutes Umschalten derselben Sitzung schließt sie. Vollbildsitzungen lehnen Größe, Position, Anker, Pfeil und Koordinaten ab. Schließe die Sitzung vor einem Wechsel der Darstellungsart.
popCalendar --toggle --session overview --presentation fullscreen --mode two-years --display current Zurück zum Inhalt Eine bestätigte Datumsauswahl zurückgeben
--select öffnet eine Auswahl und wartet auf die Bestätigung. Das Standardzeitlimit beträgt 300 Sekunden. --timeout erlaubt Werte von 1 bis 86400. Escape, Schließen der Auswahl oder Control-C bricht ab. Bis zu 128 getrennte Bereiche werden aus dem zuletzt verwendeten Kalenderbereich zurückgegeben. Ohne --json enthält jede Zeile START END. Beide Daten sind eingeschlossen.
popCalendar --select --session picker --mode month --date 2027-03-01 --json --timeout 300{"version":1,"status":"selected","session":"picker","timeZone":"America/Los_Angeles","ranges":[{"start":"2027-03-01","end":"2027-03-07"}]} Zurück zum Inhalt Pläne, Arbeitstage und Bilder
Ersetzen Sie SET_UUID und PLAN_UUID durch die von --sets und --plans zurückgegebenen IDs. Verwenden Sie unterschiedliche UUIDs für REQUEST_UUID und NEW_REQUEST_UUID. Die erforderlichen Berechtigungen sind in der Automatisierungsübersicht beschrieben.
| Befehl oder Option | Funktion |
|---|---|
--help | Gibt die vollständige Befehls- und Optionsreferenz aus. |
--version | Gibt App-Version und Build aus. |
--capabilities [--json] | Gibt unterstützte Befehle und Grenzen zurück, ohne die App zu öffnen. |
--doctor [--json] [--timeout SECONDS] | Prüft App-Identität, Berechtigungen und Kommunikation mit der App. |
--sets [--json] | Gibt Namen und IDs gespeicherter Kalendersets zurück. |
--sessions [--json] | Gibt IDs offener Integrationssitzungen auf dem Mac zurück. |
--plans [--name SEARCH] [--id UUID] [--json] | Gibt gespeicherte Pläne, deren Bereiche und Wiederholungsinformationen zurück. Nach Name oder ID filtern. |
--create-plan --name NAME --start YYYY-MM-DD --end YYYY-MM-DD [--request-id UUID] | Speichert einen benannten, einschließlich beider Endpunkte geltenden Zeitraum und gibt die Plan-ID zurück. |
--duplicate-plan --id UUID --name NAME [--request-id UUID] | Dupliziert einen gespeicherten Plan unter neuem Namen und gibt seine ID zurück. |
--open-plan --id UUID | Öffnet einen gespeicherten Plan mit seinen aktuellen Bereichen und Wiederholungseinstellungen. |
--activate-set --calendar-set UUID | Wechselt das aktive Kalenderset und behält Datum und Ansicht bei. |
--working-days --start YYYY-MM-DD --end YYYY-MM-DD | Zählt Arbeitstage anhand des aktivierten Arbeitsplans und der Kalender mit ganztägigen Abwesenheiten. Beide Endpunkte zählen. |
--shift-working-days --start YYYY-MM-DD --count INTEGER | Geht um Arbeitstage vor oder zurück. Der Starttag zählt nicht mit. |
--pause-chimes --minutes INTEGER | Pausiert Zeitsignale für die angegebene Minutenzahl, höchstens sieben Tage. |
--resume-chimes | Beendet die Pause und behält Zeitplan und Aktivierungszustand der Zeitsignale bei. |
--export --start YYYY-MM-DD --end YYYY-MM-DD [--calendar-set UUID] [--plans UUID,UUID] [--events] | Exportiert ein PNG für höchstens zwei Kalenderjahre. Enthält nur angeforderte Pläne. Ereigniskreise werden nur auf Wunsch eingeschlossen. |
API-Daten verwenden gregorianisches YYYY-MM-DD in der Zeitzone der App. Arbeitstagsberechnungen erfordern einen aktivierten Arbeitsplan. Datumsabfragen sind auf zehn Jahre und Verschiebungen auf 2.600 Arbeitstage begrenzt. Fehlgeschlagene Ereignisabfragen erzeugen einen Fehler, statt Abwesenheiten als null zu werten.
Verwende bei Wiederholungen einer Planerstellung oder Duplizierung dieselbe Anfrage-UUID und identische Angaben. Die Wiederholung liefert die vorhandene ID. Andere Angaben schlagen fehl. Verwende die UUID nach einer Änderung oder Löschung des Ergebnisses nicht erneut. Ein Zeitlimit oder Abbruch macht eine bereits ausgeführte Änderung nicht rückgängig.
popCalendar --sets --json
popCalendar --plans --name Holiday --json
popCalendar --create-plan --name Holiday --start 2027-08-02 --end 2027-08-13 --request-id REQUEST_UUID
popCalendar --duplicate-plan --id PLAN_UUID --name Variation --request-id NEW_REQUEST_UUID--export schreibt PNG-Bytes auf die Standardausgabe. Leite sie in eine Datei um. Der angeforderte Bereich wird hervorgehoben. Normale Fenster und gespeicherte Einstellungen bleiben unverändert. Der CLI-Export erzeugt PNG, kein PDF.
popCalendar --export --start 2027-01-01 --end 2027-12-31 --calendar-set SET_UUID --plans PLAN_UUID --events > calendar.png Zurück zum Inhalt Ergebnisse und Fehler
Steuerbefehle warten standardmäßig bis zu 60 Sekunden auf Annahme. --wait ist optional. --no-wait bestätigt nur die Zustellung und kann weder mit --timeout noch für Auswahl, Daten oder Diagnose verwendet werden. Annahme bedeutet nicht, dass Ereignisse fertig geladen sind.
Datenbefehle liefern JSON. Mit --json erscheint Erfolg oder Fehler als ein JSON-Objekt auf der Standardausgabe. Fehler enthalten errorCode, message und exitCode. Ohne --json verwenden Fehler die Standardfehlerausgabe. --export liefert Bildbytes und unterstützt --json nicht.
{"version":1,"status":"error","errorCode":"invalid_arguments","message":"Unknown option --example.","exitCode":64,"command":"open"}| Exit-Code | Funktion |
|---|---|
0 | Erfolg |
2 | Auswahl abgebrochen |
3 | Zeitlimit erreicht |
4 | App-Start oder Verbindung fehlgeschlagen |
5 | Anfrage von der App abgelehnt |
64 | Ungültiger Befehl oder ungültige Argumente |
70 | Interner Fehler oder Fehler im Antwortkanal |
128 + signal | Durch ein Signal unterbrochen, einschließlich 130 für Control-C |
Eine Verbindung diagnostizieren
--doctor kann die App im Hintergrund starten. Das Standardzeitlimit beträgt zehn Sekunden. Berechtigungen werden nicht geändert und Kalenderinhalte nicht zurückgegeben. Erfolgreiche JSON-Diagnosen stehen unter result.diagnostics mit connection gleich connected und permissionSource gleich app. Bei Fehlern enthält die Antwort ein diagnostics-Objekt auf oberster Ebene mit lokalen Berechtigungswerten. Diese können vom ungespeicherten Zustand einer nicht reagierenden App abweichen.
popCalendar --doctor --json Zurück zum Inhalt Inhalt und Geometrie
| Befehl oder Option | Funktion |
|---|---|
--presentation | Standardmäßig window, alternativ popup oder fullscreen. Vor einem Darstellungswechsel die laufende Sitzung schließen. |
--mode | month, two-months, year, two-years, month-year oder month-two-years. Standard ist year. |
--date | Gregorianisches YYYY-MM-DD in der Zeitzone der App. Standard ist das erste Datum des Bereichs oder heute. |
--start, --end | Einschließliche Endpunkte als YYYY-MM-DD. Beide angeben, start darf nicht nach end liegen. |
--clear-selection | Entfernt die Auswahl. Kann nicht mit --start und --end kombiniert werden. |
--calendar-set | UUID eines gespeicherten Kalendersets oder current für eine Kopie des aktiven Filters. IDs lassen sich über CLI oder Kurzbefehle abfragen. Unbekannte IDs werden abgelehnt. |
--display | Nur für Vollbildansichten. current verwendet den Bildschirm unter dem Zeiger, main den Hauptbildschirm. Alternativ eine Display-UUID angeben. Nicht angeschlossene Displays werden durch ein verfügbares ersetzt. |
--width, --height | Inhaltsmaße in logischen Punkten, jeweils von 240 bis 8192. Gib beide an. Popups behalten die angeforderte Größe ab dem ersten sichtbaren Bild bei. Normale veränderbare Fenster können auf eine lesbare Mindestgröße wachsen. Bildschirmgrenzen haben Vorrang. Die CLI akzeptiert auch --size WIDTHxHEIGHT. |
--anchor | Ankerrechteck für ein Popup als x,y,width,height in globalen Bildschirmkoordinaten. Nicht mit x und y kombinierbar. |
--x, --y | Explizite Position statt Anker. Beide Werte angeben. Ein Popup mit expliziter Position hat keinen Pfeil. |
--coordinates | appkit beginnt unten links auf dem Hauptbildschirm. top-left misst von oben links nach unten. Weitere Displays können negative Koordinaten haben. Die Werte sind Punkte, keine Pixel. |
--arrow | auto, top, bottom, left, right oder none. Bezeichnet die Popup-Kante mit dem Pfeil. Die Platzierung kann wechseln, damit das Panel sichtbar bleibt. |
--callback | Ein registriertes eigenes URL-Schema für die Rückgabe ausdrücklich bestätigter Daten. |
Die CLI verwendet dieselben Namen mit -- davor. Nur selection=clear wird zu --clear-selection. Vollbildansichten lehnen Geometrieoptionen außer display ab. Unbekannte oder doppelte Parameter, fehlerhafte Daten und URLs über 16 KiB werden vollständig abgelehnt.
Zurück zum Inhalt