88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
# 🧮 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) | **Released:** 10.10.2025 | **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
|