# TkinterCalculator

**Repository Path**: adamo1209/TkinterCalculator

## Basic Information

- **Project Name**: TkinterCalculator
- **Description**: A calculator window(GUI) application built with Python(3.11) and its standard library Tkinter.
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-17
- **Last Updated**: 2025-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

TkinterCalculator
=================

A calculator window application built with Python 3.11 and its standard library tkinter.

---

## ✨ Features
- **Basic arithmetic**: addition, subtraction, multiplication, division  
- **Percentage** and **sign toggle**  
- **Clear** (`C`) and **Clear Entry** (`CE`)  
- **Real-time expression preview** on the top label  
- **Keyboard-friendly** – every button has an on-screen counterpart  
- **Cross-platform** – runs on Windows, macOS, and Linux without modification  

---

## 🚀 Quick Start

### Requirements
- Python 3.7+ (no external packages needed)

### Run from source
```bash
git clone https://github.com/Adamo1209/TkinterCalculator.git
cd TkinterCalculator
python3 TkinterCalculator.py
```

---

## 📸 Usage

1. **Numbers & operators**: click or use the keyboard.  
2. **Expression preview**: the top label shows the ongoing calculation.  
3. **Equals (`=`)**: computes the result and displays it in the main area.  
4. **Clear (`C`)**: resets the entire expression.  
5. **Clear Entry (`CE`)**: deletes only the last entry.  

---

## 🛠️ Development

### Project layout
```
TkinterCalculator/
├── TkinterCalculator.py   # source code
├── calculator.png         # window icon
└── README.md
```