From 25d9987968d9aa69cdf2a5779375eeab72e22825 Mon Sep 17 00:00:00 2001
From: SCHAUAUS GmbH <2+schauausgmbh@noreply.aaskablackwolf.servehttp.com>
Date: Sun, 25 Oct 2026 14:22:50 +0000
Subject: [PATCH] README.md aktualisiert

---
 README.md | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c5dd82e..1d9f394 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,27 @@
 # Gitea-time-tracker
 
-Tool to calculate total time spent by a singl user on a Gitea repository.
\ No newline at end of file
+Tool to calculate total time spent by a single user on a Gitea repository.  
+The tool is running exclusivly in your browser and no data will leave your computer.
+
+# Preparation
+
+- create an access token with permission to read repository
+- Query the API to receive a JSON text including all the timestamps: https://your-gitea-server/api/v1/repos/{ownerName}/{repoName}/times/{userName}?access_token={apiAccessToken}
+  * {ownerName} = name of the repository owner; might be a user name or organization name
+  * {repoName} = name of the repository to evaluate
+  * {userName} = name of the user to evaluate
+  * {apiAccessToken} = the access token you prepared in the first step
+
+# Calculate the total time and cost
+
+- open [timetracker.html](timetracker.html)
+- set your "cost per hour" factor for proper cost calculation
+- paste the JSON text you queried from Gitea's API into the text area
+- press the "parse" button
+- results will be displayed and inputs hidden
+- to restart: reload the page
+
+# License
+
+This software is licensed under the [EUROPEAN UNION PUBLIC LICENCE v. 1.2 (EUPL-1.2)](LICENSE).
+