jira-timesheet
Features Tastenkürzel Installation GitHub
Open Source TUI Tool · v1.11.0

Jira Timesheet

Terminal-basierte Anwendung zum Generieren von Stundenzetteln aus Jira Worklogs. Drei Ansichten, Excel/PDF-Export, Feiertagskalender und Jahres-Forecast.

GitHub Repository Installation
Features

Was es kann

Stundenzettel aus Jira — automatisch generiert, visuell aufbereitet, exportbereit.

🔗

Jira Cloud & Data Center

Worklogs per REST API — standardmäßig Jira Cloud (v3, Basic-Auth mit API-Token), per Schalter auch altes Server/Data Center (v2, Bearer-Token). Automatische Pagination und Filterung nach Zeitraum.

🎯

Budget-Feld automatisch ermitteln

Bei Jira Cloud findet ein Klick das Budget-Custom-Field automatisch — kein manuelles Nachschlagen der Field-ID nötig.

🧮

MwSt konfigurierbar

Der MwSt-Satz ist eine Einstellung für die Netto/Brutto-Berechnung in TUI und Jahresansicht (Standard 19 %).

📋

Drei Ansichten

Listenansicht mit KW und Wochentag, Kalenderansicht als Monatsgrid, Jahresansicht mit Forecast. Tab-Navigation mit Klick oder TAB-Taste.

📄

Excel & PDF Export

Formatierter Stundenzettel mit Logo und Unterschriftszeile. PDF ist Adobe-signierbar.

📅

Feiertagskalender

Deutsche Feiertage pro Bundesland. Lücken-Erkennung für fehlende Arbeitstage.

📊

Soll/Ist & Forecast

Arbeitszeitvergleich mit Differenz. Jahres-Forecast mit Urlaubstagen und Umsatzprognose.

🎨

Retro-Themes

31 Themes von vintage 8-bit über Terminal-Phosphor und Unix-Workstation bis zu 80s-Pastel — wechselbar mit Ctrl+P.

🔍

Ticket-Details

Enter oder D zeigt Status, Typ, Bearbeiter, Komponenten und Jira-Link im Log.

🔒

Anonymisierung

Daten per Tastendruck anonymisieren für sichere Screenshots und Demos.

💾

Worklog-Cache

Abgeschlossene Monate werden gecached — Jahresansicht lädt beim zweiten Mal sofort.

Bedienung

Tastenkürzel

TasteAktion
GStundenzettel generieren
EExcel-Export
PPDF-Export
DTicket-Details anzeigen
TABTab wechseln (Liste / Kalender)
RCache zurücksetzen
JJahresansicht mit Forecast
ADaten anonymisieren
< / >Monat wechseln
SSettings öffnen
IInfo-Dialog
CLog in Zwischenablage kopieren
LLog ein-/ausblenden
Ctrl+PTheme wechseln
QBeenden
Erste Schritte

Installation

💻

Windows (PowerShell)

irm https://raw.githubusercontent.com/michaelblaess/jira-timesheet/main/install.ps1 | iex
🐧

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/michaelblaess/jira-timesheet/main/install.sh | bash

Voraussetzung: Python 3.10+ · Danach einfach jira-timesheet im Terminal eingeben.

Technologie

Tech Stack

Python 3.10+ Textual Rich httpx openpyxl fpdf2 holidays

Disclaimer: Dieses Projekt ist nicht von Atlassian entwickelt, unterstützt oder autorisiert. "Jira" und "Atlassian" sind eingetragene Markenzeichen von Atlassian Corporation. Dieses Tool nutzt die öffentliche Jira REST API und steht in keiner Verbindung zu Atlassian.