Punchbar

Support

Fragen, Fehler oder Ideen? Schreib an support@punchbar.app – auf Deutsch oder Englisch. Bitte nenne deine macOS-Version und die Punchbar-Version (steht unten im Panel).

Einrichtung

Wie erstelle ich einen Tempo-API-Token?

Öffne in Jira Tempo → Settings → API integration und erstelle einen neuen Token. Punchbar braucht zwei Scopes: Worklogs (lesen und schreiben) und Schemes (lesen, für die Soll-Zeit). Der Einrichtungsassistent hat einen Knopf, der diese Seite öffnet.

Wie erstelle ich einen Atlassian-API-Token (Jira)?

Auf id.atlassian.com → Security → API tokens einen Token ohne Scopes erstellen. Punchbar nutzt ihn, um Tickets zu finden, ihre Titel anzuzeigen und die numerische Ticket-ID zu ermitteln, die Tempo verlangt. Als E-Mail die Adresse eintragen, mit der du dich bei Atlassian anmeldest.

Welche Tempo-Region soll ich wählen?

„Global“ funktioniert für alle. Verlangt deine Firma einen regionalen Endpunkt, wähle Europa oder Amerika.

Funktioniert Punchbar mit Jira Data Center oder Tempo Server?

Nein. Punchbar unterstützt nur Jira Cloud mit Tempo Timesheets (Cloud).

Nutzung

Warum wird beim Starten des Timers nichts gebucht?

Tempo hat keinen eigenen Timer. Punchbar lässt den Timer deshalb auf deinem Mac laufen und legt die Buchung beim Stoppen oder Wechseln an. Ist Tempo nicht erreichbar, wartet die Buchung in einer Warteschlange und wird später automatisch gesendet.

Woher kommt die Soll-Zeit?

Aus deinem Tempo-Arbeitszeitplan, inklusive Feiertagen, freien Tagen und Teilzeit-Modellen.

Kann ich Punchbar ohne Konto ausprobieren?

Ja. Wähle im Einrichtungsassistenten „Erst die Demo ansehen“ oder im Panel „Demo ausprobieren“. Die Demo nutzt Beispieldaten, speichert nichts und sendet nichts an Tempo.

Kann ich Punchbar aus Raycast, Kurzbefehlen oder Stream Deck steuern?

Ja, mit URL-Aktionen: punchbar://start?issue=KEY (optional &note=Text), punchbar://stop und punchbar://toggle.

Mein Token ist abgelaufen – was nun?

Punchbar zeigt im Panel einen Hinweis, sobald Tempo oder Jira einen Token ablehnt. Erstelle einen neuen und trage ihn unter Einstellungen → Konto ein. Dort kannst du auch das Ablaufdatum hinterlegen, um vorher erinnert zu werden.

Datenschutz

Punchbar verbindet sich direkt von deinem Mac mit Tempo und Jira. Tokens liegen in deinem Schlüsselbund, wir erheben keine Daten. Details stehen in der Datenschutzerklärung.