Files
SurvivalCalc/README.md
2026-03-25 20:44:08 +00:00

128 lines
3.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🧮 Survivalcalc
A modern desktop calculator with advanced features for area and volume calculations, built with Python and Tkinter.
---
## ✨ Features
* 🔢 **Standard Calculator** Basic arithmetic with real-time computation
* 📐 **Area Calculations** Square, rectangle, circle, triangle, trapezoid, cylinder, sphere, cone
* 📦 **Volume Calculations** Cube, rectangular prism, cylinder, cone, sphere, tetrahedron, trapezoidal prism
* 🌙 **Dark Mode** Toggle between light and dark themes
* 🌍 **Multi-Language Support** German (DE) and English (EN)
* 📏 **Unit System** Support for mm, cm, m, km with automatic conversion
* 🔄 **Adjustable Rounding** Configure decimal places (020)
* 🕓 **Calculation History** Track last 3 calculations with SQLite storage
* ⚙️ **Persistent Settings** All preferences saved automatically
* ⌨️ **Keyboard Support** Full keyboard shortcuts for calculator operations
---
## 🚀 Installation
1. Download **Survivalcalc_Installer.exe**
2. Run the installer
3. Select your language (Deutsch / English)
4. Follow the setup wizard
5. Choose optional shortcuts (Start Menu, Desktop)
6. Launch **Survivalcalc** from your shortcuts
**No additional setup required!**
---
## 🎮 Quick Start
### Calculator
- Use on-screen buttons or keyboard numbers
- Press `=` or `Enter` to calculate
- Press `AC` or `Escape` to clear
- Use `Backspace` to delete last digit
### Shape Calculations
1. Open **Shapes** menu
2. Select area or volume calculation
3. Choose radius or diameter (if applicable)
4. Enter your dimensions
5. Select your units
6. Results update automatically
### Settings
- Toggle dark mode
- Enable/disable rounding
- Change default units
- Switch languages
- Manage calculation history
---
## 🛠️ Technologies
* **Python** Core application
* **Tkinter** Cross-platform GUI
* **SQLite** Calculation history storage
* **JSON** Settings persistence
---
## 💻 System Requirements
* **OS**: Windows 7 or later
* **RAM**: 50 MB minimum
* **Disk Space**: 10 MB
* **Internet**: Required for initial download only
---
## ⌨️ Keyboard Shortcuts
| Key | Action |
|-----|--------|
| `09` | Number input |
| `+`, ``, `×`, `÷` | Operations |
| `.` | Decimal point |
| `Enter` / `=` | Calculate |
| `Escape` / `C` | Clear |
| `Backspace` | Delete last digit |
---
## 🗑️ Uninstallation
### Windows
1. Go to **Settings → Apps → Apps & Features**
2. Find **Survivalcalc**
3. Click **Uninstall**
Or run **Survivalcalc_Uninstaller.exe** directly.
---
## 📬 Support
* 🌐 **Website**: [Github](https://survivalful.de/survivalcalc/)
* 📧 **Email**: [team@survivalful.de](mailto:team@survivalful.de)
---
## 📜 License
MIT License © 2026 Survivalful
---
## 📊 Version Info
* **Version**: 1.0.0
* **Release**: 24.03.2026
* **Status**: Stable
---
## ⭐ Support the Project
If you like Survivalcalc, consider sharing it with others!
**Enjoy calculating!** 🎯