Wie man seine Zeit in Linux mit Bartib verfolgt

Als IT-Fachleute müssen wir oft die Zeit verfolgen, die wir für unsere Aufgaben aufwenden – sei es für interne Berichte in unserem Unternehmen oder für die Abrechnung mit unseren Kunden. Während viele Werkzeuge existieren, um verschiedene Bedürfnisse zu erfüllen, richten sich viele von ihnen an größere Teams oder besondere Anforderungen und fehlen die Einfachheit, die wir beim Einsatz von Kommandozeilen-Tools genießen. Ein einfaches Werkzeug, das es uns erlaubt, die Zeit direkt in der Kommandozeile zu verfolgen, ist Bartib.

Was ist Bartib?

Bartib bietet mehrere Befehle, um zu verfolgen, wann wir Aktivitäten starten und stoppen oder um Berichte darüber zu erstellen, wie viel Zeit wir für bestimmte Aufgaben und Projekte aufgewendet haben. Es speichert ein Protokoll aller verfolgten Aktivitäten als Textdatei in einem einfachen, für Menschen lesbaren Format.

Bartib ist eine kostenlose und Open-Source-Anwendung, geschrieben in Rust.

Bartib in Linux installieren

Bartib kann über Homebrew, den Cargo-Paketmanager oder durch Herunterladen von vorkompilierten Binärdateien von der Release-Seite installiert werden.

Methode 1: Installation über Homebrew

Homebrew installieren

Wenn Sie Homebrew noch nicht auf Ihrem Computer installiert haben, tun Sie dies bitte, bevor Sie fortfahren:

• Installationsanweisungen für Homebrew

Installiere Bartib

Sobald Homebrew installiert ist, kann Bartib mit dem folgenden Befehl installiert werden:

$ brew install bartib

Methode 2: Installation über Cargo

Rust installieren

Wenn Rust nicht auf Ihrem Linux-Rechner installiert ist, muss es vor dem Fortfahren installiert werden:

• So installieren Sie die Programmiersprache Rust unter Linux

Rust aktualisieren (falls bereits installiert):

Stellen Sie sicher, dass Sie die neueste Version von Rust haben, indem Sie den folgenden Befehl ausführen:

$ rustup update

Installiere Bartib

Sobald Rust aktualisiert wurde, können Sie mit der Installation von Bartib über den Cargo-Paketmanager fortfahren. Führen Sie den folgenden Befehl aus:

$ cargo install --locked bartib

Methode 3: Installation über vorgefertigte Binärdateien

Sie können eine vorkompilierte Binärdatei von der Veröffentlichungsseite des Projekts auf der Bartib's Release Page erhalten. Laden Sie die Tar-Datei herunter, die Ihrer Architektur entspricht, entpacken Sie sie und verschieben Sie die ausführbare Datei in ein Verzeichnis, das in Ihrem ` PATH enthalten ist.

Wenn Sie planen, Bartib nur mit Ihrem individuellen Benutzerkonto zu verwenden, könnte das Verzeichnis ~/bin sein. Wenn Sie Bartib jedoch allen Benutzern Ihres Geräts zur Verfügung stellen möchten, wäre das Verzeichnis /usr/local/bin.

Nachdem Sie Bartib installiert haben, stellen Sie sicher, dass es ausführbar ist, indem Sie die richtigen Dateiberechtigungen mit folgendem Befehl setzen:

$ chmod 755 bartib

Alternativ haben Sie die Möglichkeit, die vorgefertigten Binärdateien mit einem Shell-Skript zu installieren, das Sie auf Bartibs Veröffentlichungsseite finden. Führen Sie einfach den folgenden Befehl aus, und das Shell-Skript wird Bartib direkt auf Ihrem System installieren:

$ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/nikolassv/bartib/releases/download/v1.1.0/bartib-installer.sh | sh

Installiere Bartib aus dem AUR

Wenn Sie Arch Linux und seine Varianten wie EndeavourOS und Manjaro Linux verwenden, können Sie Bartib aus dem Arch User Repository (AUR) mit Paru installieren:

$ paru -S bartib

Oder Yay AUR-Helfer:

$ yay -S bartib

Installiere Bartib in Alpine Linux

Bartib ist in den Standard-Repositorys von Alpine Linux verfügbar. Sie können es mit dem apk-Befehl wie folgt installieren:

$ sudo apk add bartib

Testen, ob Bartib erfolgreich installiert wurde

Nachdem Sie Bartib installiert haben, möchten Sie bestätigen, dass die Installation erfolgreich war. Geben Sie einfach diesen Befehl in Ihr Terminal ein, und es sollte die installierte Version von Bartib angezeigt werden:

$ bartib --version

Wie man seine Zeit in Linux mit Bartib verfolgt

Sag Bartib, wo die Protokolle deiner Aktivitäten gespeichert werden sollen

Wie oben bereits erwähnt, zeichnet Bartib ein Protokoll aller Ihrer Aktivitäten in einer Textdatei auf. Um jede Aktivität protokollieren zu können, muss Bartib wissen, wo sich diese Datei befindet. Sie geben die Datei in jedem Befehl explizit mit dem -f oder --file Flag an, wie folgt:

$ bartib -f ~/activities.bartib report

Alternativ erlaubt Bartib die Angabe der Datei über die Umgebungsvariable BARTIB_FILE. Idealerweise sollten Sie diese Variable in einer Datei wie .bashrc definieren, die in jeder von Ihnen geöffneten Shell ausgeführt wird, wie folgt:

export BARTIB_FILE=activities.bartib

Wenn die Umgebungsvariable BARTIB_FILE vorhanden ist, muss das -f-Flag nicht verwendet werden. Da diese Methode die bevorzugte Art ist, die Datei anzugeben, wird das -f-Flag in allen folgenden Beispielen ignoriert.

Einfache Zeiterfassung: Aktivitäten starten und stoppen

Sie verwenden Bartib, indem Sie den Befehl bartib mit einem Unterbefehl und optionalen Parametern ausführen. In dieser Hinsicht funktioniert es ähnlich wie andere Kommandozeilenwerkzeuge wie git.

Die Unterbefehle, die Sie in Ihrer täglichen Arbeit am meisten benötigen, sind die Befehle start und stop. Da jede Aktivität in Bartib aus einer Beschreibung und einem Projekt besteht, müssen Sie diese mit dem Unterbefehl start als Parameter definieren:

$ bartib start -d 'Fix javascript bug #345' -p 'Application Front End'

Der Parameter -d oder --description legt die Beschreibung fest, der Parameter -p oder --project legt das Projekt fest.

Nachdem Sie Ihre Aufgabe beendet haben, können Sie die Zeitverfolgung mit folgendem Befehl stoppen:

$ bartib stop

Sie können auch einfach mit der nächsten Aktivität beginnen. Bartib wird alle laufenden Aktivitäten automatisch stoppen, wenn eine neue Aktivität beginnt.

Wenn Sie schon eine Weile arbeiten und sich nicht sicher sind, ob Sie erfolgreich mit der Zeiterfassung begonnen haben, verwenden Sie den Befehl bartib current, um zu überprüfen, ob bartib Aktivitäten erfasst und wenn ja, welche. Wenn Sie vergessen haben, die Aktivität zu starten, können Sie sie später trotzdem starten und ihre Startzeit mit dem Parameter -t im 24-Stunden-Format festlegen:

$ bartib start -d 'Improve Database Performance' -p 'Housekeeping' -t 15:30

Zwei weitere Befehle zum Starten von Aktivitäten sind nützlich, wenn Sie häufig zwischen Aufgaben wechseln. Der erste ist bartib last, der eine Liste kürzlich verwendeter Kombinationen von Beschreibungen und Projekten anzeigt. Der zweite ist bartib continue, der es Ihnen ermöglicht, eine dieser kürzlichen Aktivitäten fortzusetzen.

Die Ausgabe von bartib last zeigt einen Index für jede Aktivität in ihrer ersten Spalte:

Sie verwenden diesen Index mit bartib continue, um anzugeben, welche Aktivität fortgesetzt werden soll:

$ bartib continue 5
Started activity: "Team meeting" (Internal project) at 2024-05-17 18:03

Sie können auch die Beschreibung oder das Projekt überschreiben, indem Sie es durch den jeweiligen Parameter neu definieren, sowie die Startzeit mit dem -t-Parameter festlegen:

$ bartib continue 5 -d 'Fix Bug #56' -t 10:45

Auflisten von Aktivitäten und Erstellen von Berichten

Um aufzulisten, welche Aktivitäten Sie bisher verfolgt haben, verwenden Sie den list-Unterbefehl:

$ bartib list

Es ist oft wünschenswert, Aufgaben nur in einem bestimmten Zeitraum aufzulisten. Sie können einen solchen Zeitraum mit den Parametern --from und --to definieren:

$ bartib list --from 2024-05-13 --to 2024-05-17

Wenn beide Daten gleich sind, setzen Sie sie mit einem einzigen --date-Argument:

$ bartib list --date 2024-05-15

Bartib bietet mehrere Parameter, um häufig verwendete Zeiträume zu definieren:

$ bartib list --today         # list todays' activities
$ bartib list --yesterday     # list yesterdays' activities
$ bartib list --current_week  # list activities of the current week (since monday)
$ bartib list --last_week     # list activities of the last week

Es ist oft wünschenswert, alle Aktivitäten aufzulisten, die Sie für ein bestimmtes Projekt verfolgt haben. In diesem Fall können Sie den Filter --project mit bartib list verwenden:

$ bartib list --project 'Development of the Application Backend'

Während es hilfreich ist, alle verfolgten Aktivitäten auflisten zu können, macht Bartib wirklich nützlich, dass es in der Lage ist, aussagekräftige Berichte zu erstellen.

Verwenden Sie das Unterkommando bartib report, um einen Bericht zu erstellen, der alle Aktivitäten umfasst, die Sie jemals verfolgt haben:

$ bartib report

Wie Sie in der obigen Ausgabe sehen, listet Bartib alle Projekte auf und unter jedem Projekt wird eine Liste aller Aktivitäten angezeigt, die zu diesem Projekt gehören. Es zeigt die Zeit an, die Sie für jede Aufgabe aufgewendet haben, und die Gesamtzeit, die Sie für jedes Projekt aufgewendet haben. Es berechnet auch die Summe aller Aktivitäten, die Sie jemals erfasst haben.

Der Befehl bartib report akzeptiert die gleichen Parameter wie bartib list, um die Aufgaben zu filtern, die er einschließt. Genau wie bei bartib list verwenden Sie die Parameter --from und --to, um einen Zeitraum festzulegen, für den Sie berichten möchten, oder Sie können einen der vordefinierten Zeiträume verwenden: --today, --yesterday, --current_week und --last_week.

Ändern von Zeiterfassungseinträgen

Manchmal müssen Sie möglicherweise die Aktivitäten ändern, die Sie verfolgt haben. Um die aktuell laufende Aktivität zu ändern, bietet Bartib den Befehl bartib change an. Verwenden Sie ihn einfach mit dem Parameter -p, -d oder -t, um das Projekt, die Beschreibung oder die Startzeit zu ändern.

Zum Beispiel ändert der folgende Befehl die Startzeit der aktuell laufenden Aktivität auf 10:15:

$ bartib change -t 10:15

Wenn Sie bereits begonnen haben, eine Aktivität zu verfolgen, aber Ihre Meinung geändert haben und überhaupt nichts mehr verfolgen möchten, können Sie den Unterbefehl bartib cancel verwenden. Er entfernt dauerhaft jede derzeit verfolgte Aktivität, während er keine andere Aktivität in Ihrem Protokoll berührt.

Wenn Sie Aktivitäten ändern müssen, die bereits beendet sind, können Sie deren Eintrag im Aktivitätsprotokoll weiterhin ändern. Öffnen Sie einfach die Datei in Ihrem bevorzugten Editor oder verwenden Sie den Befehl bartib edit, um den im $EDITOR-Umgebungsvariable definierten Editor zu starten.

Das Format eines Eintrags ist selbsterklärend:

2024-05-13 10:15 - 2024-05-13 14:00 | Development of the Application Back end | Fixing the Logging endpoint

Jeder Datensatz besteht aus Teilen, die durch das Rohrzeichen "|" getrennt sind. Der erste Teil enthält die Start- und Endzeiten, der zweite Teil das Projekt und der dritte Teil die Aufgabenbeschreibung.

Nachdem Sie die Aktivitäten manuell geändert haben, möchten Sie möglicherweise den Befehl bartib check und bartib sanity verwenden.

Ersteres überprüft, ob das Protokoll ungültige Zeilen enthält, die bartib nicht parsen kann, während letzteres überprüft, ob das Protokoll Aktivitäten mit logischen Fehlern enthält, wie eine Aktivität mit negativer Dauer.

Für detaillierte Nutzung, überprüfen Sie das Bartib GitHub-Repository:

• Bartib GitHub-Repository

Fazit

So einfach Bartib zu verwenden ist, so ist es ein bemerkenswert vielseitiges Werkzeug zur Verfolgung von Aktivitäten in der Kommandozeile. Obwohl es nicht alle Funktionen bietet, die andere Werkzeuge bereitstellen, ist es wirklich nützlich für jeden, der Zeiten als Einzelbenutzer auf unkomplizierte Weise verfolgen möchte.

Verwandt: Moro – Ein Kommandozeilen-Produktivitätstool zur Erfassung von Arbeitsstunden