jira-timesheet
Features Tastenkuerzel Installation GitHub
Open Source TUI Tool · v1.4.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
jira-timesheet
Listenansicht im Gemstone Theme
Listenansicht — KW, Wochentag, Ticket, Beschreibung, Stunden, Tagessumme (Gemstone Theme)
Listenansicht im Classic Terminal Theme
Listenansicht — Classic Terminal Theme mit Soll/Ist-Vergleich und Netto/Brutto
Kalenderansicht im Gemstone Theme
Kalenderansicht — Monatskalender mit farbcodierten Tageskacheln und Wochensumme
Kalenderansicht im BeBox Theme
Kalenderansicht — BeBox Theme mit Luecken-Erkennung (rote Kacheln)
Jahresansicht mit Progressbars
Jahresansicht — 12 Monatskacheln mit Progressbar, Forecast und Netto/Brutto
Settings Dialog
Settings — Jira-Host, Token, Bundesland, Stundensatz und Export-Optionen
Features

Was es kann

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

🔗

Jira Integration

Worklogs per REST API abrufen mit Bearer Token. Automatische Pagination und Filterung nach Zeitraum.

📋

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. Luecken-Erkennung fuer 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 fuer sichere Screenshots und Demos.

💾

Worklog-Cache

Abgeschlossene Monate werden gecached — Jahresansicht laedt beim zweiten Mal sofort.

Bedienung

Tastenkuerzel

TasteAktion
GStundenzettel generieren
EExcel-Export
PPDF-Export
DTicket-Details anzeigen
TABTab wechseln (Liste / Kalender)
RCache zuruecksetzen
JJahresansicht mit Forecast
ADaten anonymisieren
< / >Monat wechseln
SSettings oeffnen
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, unterstuetzt oder autorisiert. "Jira" und "Atlassian" sind eingetragene Markenzeichen von Atlassian Corporation. Dieses Tool nutzt die oeffentliche Jira REST API und steht in keiner Verbindung zu Atlassian.