Files
SurvivalCalc/README.md
2026-04-06 18:33:13 +00:00

139 lines
3.4 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, volume, and electricity 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
***Electricity Calculations** Voltage, current, resistance, and power with various formulas, plus a color band resistance calculator.
* 🌙 **Dark Mode** Toggle between light and dark themes
* 🌍 **Multi-Language Support** German (DE) and English (EN)
* 📏 **Unit System** Support for pm, nm, μm, mm, cm, dm, m, km, Mm, Gm 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
* 🔄 **Automatic Updates** Notifies you when a new version is available.
---
## 🚀 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
### Electricity Calculations
1. Open **Shapes** menu
2. Select **Electricity**
3. Choose the quantity to calculate (e.g., Voltage, Current)
4. Select the formula you want to use (e.g., U = I · R)
5. Enter your values
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 and update checks
---
## ⌨️ 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**
---
## 📬 Support
* 🌐 **Website**: [https://Survivalful.de](https://survivalful.de)
* 📧 **Email**: [team@survivalful.de](mailto:team@survivalful.de)
---
## 📜 License
GPL License © 2026 Survivalful
---
## 📊 Version Info
* **Version**: 1.0.2
* **Release**: 24.03.2026
* **Status**: Stable
---
## ⭐ Support the Project
If you like Survivalcalc, consider sharing it with others!
**Enjoy calculating!** 🎯