From 0950df49372df31f681e623ea7469bd7c6c245db Mon Sep 17 00:00:00 2001
From: Survivalful <admin@survivalful.de>
Date: Sun, 22 Mar 2026 15:01:25 +0000
Subject: [PATCH] Upload files to "/"

---
 README.md | 87 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a3239d3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,87 @@
+# 🧮 Python Calculator
+
+A feature-rich GUI calculator built with Python and tkinter — supporting basic arithmetic as well as area and volume calculations for a wide range of geometric shapes.
+
+> **Version:** 0.0.1 (BETA) &nbsp;|&nbsp; **Released:** 10.10.2025 &nbsp;|&nbsp; **Developer:** [Survivalful](https://Survivalful.de/)
+
+---
+
+## Features
+
+- **Standard Calculator** — basic arithmetic (+, −, ×, ÷) with keyboard support
+- **Area Calculations** for:
+  - Square, Rectangle, Triangle, Trapezoid
+  - Circle (radius or diameter)
+  - Cylinder (radius or diameter)
+  - Sphere (radius or diameter)
+  - Cone (radius or diameter)
+- **Volume Calculations** for:
+  - Cube, Rectangular Prism
+  - Cylinder (radius or diameter)
+  - Cone (radius or diameter)
+  - Sphere (radius or diameter)
+  - Tetrahedron
+  - Trapezoidal Prism
+- **Live calculation** — results update as you type, no need to press Enter
+- **Dark / Light mode** — toggle between themes in Settings
+- **Configurable rounding** — enable/disable and set decimal places in Settings
+- **System info** — displays OS, architecture and app version in the Info screen
+
+---
+
+## Installation
+
+**Requirements:** Python 3.x (tkinter is included in the standard Python installation)
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/your-username/python-calculator.git
+   cd python-calculator
+   ```
+
+2. Run the calculator:
+   ```bash
+   python main.py
+   ```
+
+No additional packages need to be installed.
+
+---
+
+## Usage
+
+After launching the app, use the **Menu** in the top bar to navigate:
+
+| Menu item | Description |
+|-----------|-------------|
+| `Menu → Calculator` | Standard calculator with keyboard input |
+| `Menu → Shape → Area` | Area calculations for various shapes |
+| `Menu → Shape → Volume` | Volume calculations for various shapes |
+| `Menu → Settings` | Toggle dark mode and configure rounding |
+| `Menu → Info` | App version, support contact and system info |
+| `Menu → Exit` | Close the application |
+
+### Keyboard shortcuts (Calculator)
+
+| Key | Action |
+|-----|--------|
+| `0–9`, `+`, `-`, `*`, `/`, `.` | Input |
+| `Enter` | Calculate |
+| `Escape` or `C` | Clear |
+
+---
+
+## Settings
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| Dark Mode | On | Toggle between dark and light theme |
+| Rounding | On | Enable or disable result rounding |
+| Rounding Decimals | 2 | Number of decimal places for results |
+
+---
+
+## Support
+
+- 🌐 Website: [https://Survivalful.de/](https://Survivalful.de/)
+- 📧 E-Mail: team@survivalful.de