An open API service indexing awesome lists of open source software.

https://github.com/devilfruitdev/calc-arcade

๐ŸŽฎ A retro Game Boy-style calculator with personality! Features reactive face expressions, easter eggs, and professional math functions. 100% tested, cross-platform, and actually makes math fun.
https://github.com/devilfruitdev/calc-arcade

phython tkinter-python ui-components

Last synced: 5 months ago
JSON representation

๐ŸŽฎ A retro Game Boy-style calculator with personality! Features reactive face expressions, easter eggs, and professional math functions. 100% tested, cross-platform, and actually makes math fun.

Awesome Lists containing this project

README

          

# ๐ŸŽฎ Calc-Arcade: The Calculator with Personality

**A retro Game Boy-inspired calculator that makes math fun!**

[![Python](https://img.shields.io/badge/Python-3.6%2B-blue?style=for-the-badge&logo=python)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE.md)
[![Tests](https://img.shields.io/badge/Tests-100%25%20Passing-brightgreen?style=for-the-badge)](tests/)

[![Download](https://img.shields.io/badge/Download-Latest%20Release-red?style=for-the-badge&logo=download)](https://github.com/yourusername/calc-arcade/releases/latest)

## โœจ What Makes It Special?

| ๐ŸŽฎ **Retro Gaming Style** | ๐Ÿ˜Š **Reactive Personality** | ๐Ÿงฎ **Professional Math** |
|---------------------------|----------------------------|---------------------------|
| Game Boy Color design | Face reacts to calculations | 100% test coverage |
| CRT scanline effects | Special number reactions | Advanced trig functions |
| Pixel-perfect fonts | Easter eggs & secrets | Mathematical constants |

## ๐Ÿ“ธ Screenshots

| Arcade Mode | Basic Mode | Personality Reactions |
|-------------|------------|----------------------|
| ![Arcade](assets/screenshots/arcade_mode.png) | ![Basic](assets/screenshots/basic_mode.png) | ![Reactions](assets/screenshots/reactions.png) |

## ๐Ÿš€ Quick Start

### ๐Ÿ’ป **Ready to Use** (No Installation)
1. **[Download latest release](https://github.com/DevilFruitDev/calc-arcade/releases/latest)**
2. **Extract and run** `calc-arcade.exe`
3. **Start calculating!** ๐ŸŽ‰

### ๐Ÿ **From Source**
```bash
git clone https://github.com/yourusername/calc-arcade.git
cd calc-arcade
python main.py # No dependencies needed!
```

## ๐ŸŽฏ Key Features

- **๐Ÿงฎ Complete Calculator**: Basic arithmetic + advanced functions (sin, cos, tan, โˆš, ^, %)
- **๐Ÿ˜Š Personality System**: Face expressions and reactions to your calculations
- **๐ŸŽฎ Dual Modes**: Arcade (full retro experience) vs Basic (minimal interface)
- **โŒจ๏ธ Keyboard Support**: Full keyboard shortcuts for power users
- **๐Ÿ’พ Memory Functions**: M+, M-, MR, MC
- **๐ŸŽŠ Easter Eggs**: Try calculating 42, ฯ€, or numbers over 9000!

## ๐ŸŽฎ Try These Easter Eggs!

| Input | Reaction | Why? |
|-------|----------|------|
| `42` | ๐Ÿ˜Ž "The answer!" | Hitchhiker's Guide reference |
| `3.14159` | ๐Ÿ˜Š "Mmm, pi!" | Pi recognition |
| `9001+` | ๐Ÿ˜ฑ "Over 9000!" | Dragon Ball Z meme |
| `69` or `420` | ๐Ÿ˜‰ "Nice." | Internet culture |

## ๐Ÿ“š Documentation

- **[User Guide](docs/usage.md)** - Learn all features and shortcuts
- **[Installation](docs/installation.md)** - Setup for all platforms
- **[Development](docs/development.md)** - Architecture and contributing

## ๐Ÿงช Quality

![Test Coverage](https://img.shields.io/badge/Calculator%20Tests-32%2F32%20โœ…-brightgreen)
![UI Tests](https://img.shields.io/badge/UI%20Tests-29%2F30%20โœ…-brightgreen)

- **32 calculator tests** - 100% pass rate
- **30 UI component tests** - 96.7% pass rate
- **Cross-platform tested** - Windows, macOS, Linux

## ๐Ÿค Contributing

Want to add features or fix bugs? We welcome contributions!

**Easy first issues:**
- ๐ŸŽจ Add new themes
- ๐Ÿ˜Š Create more face expressions
- ๐ŸŽฏ Implement easter eggs
- ๐Ÿ“– Improve docs

## ๐Ÿ“„ License

MIT License - see [LICENSE.md](LICENSE.md) for details.

---

**Made with โค๏ธ and lots of โ˜• by DEV**

[![โญ Star this repo](https://img.shields.io/github/stars/DevilFruitDev/calc-arcade?style=social)](https://github.com/DevilFruitDev/calc-arcade)
[![๐Ÿด Fork it](https://img.shields.io/github/forks/DevilFruitDev/calc-arcade?style=social)](https://github.com/DevilFruitDev/calc-arcade/fork)

**Transform boring math into an engaging experience! ๐ŸŽฎโœจ**