⚡ Mani-Calc v2.1.0

Spotlight-style instant calculator for Windows — Math, Currency, Date/Time, Programmer Mode, Password Generator, Color Converter, Text Utils, Emoji Search, Web Search, System Commands & 8 Beautiful Themes!

Press Alt+Space anywhere on your desktop to instantly calculate, convert, and control your system!

🚀 Quick Start

Installation

# Clone or download the repository
cd mani-calc

# Install dependencies
npm install

# Run the overlay
npm run overlay

Usage

1. Press Alt+Space to open the floating calculator
2. Type your query and see live results as you type
3. Press Enter to copy the result to clipboard
4. Press Escape to close

📖 Complete Feature Guide

📊 Math Calculations

Perform any mathematical calculation with live preview!

| Example | Result | |---------|--------| | 2 + 3 * 5 | 17 | | sqrt(144) | 12 | | sin(45 deg) | 0.7071 | | log(100) | 2 | | 2^10 | 1024 | | 15% of 200 | 30 | | (100 + 50) / 3 | 50 |

Supported Functions:

• Basic: +, -, *, /, ^ (power)
• Trigonometry: sin, cos, tan, asin, acos, atan
• Logarithms: log, log10, ln
• Roots: sqrt, cbrt, nthRoot
• Constants: pi, e
• Rounding: round, floor, ceil, abs

💱 Currency Converter

Convert between 40+ world currencies with live or cached exchange rates!

| Example | Result | |---------|--------| | 100 USD to INR | $100 USD = ₹8,312.00 INR | | 50 euros to dollars | €50 EUR = $54.35 USD | | 1000 yen to usd | ¥1000 JPY = $6.73 USD | | 500 rupees to gbp | ₹500 INR = £4.76 GBP |

Supported Currencies:

• Americas: USD, CAD, MXN, BRL, ARS, CLP, COP, PEN
• Europe: EUR, GBP, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, TRY
• Asia: INR, JPY, CNY, KRW, SGD, HKD, TWD, THB, MYR, PHP, IDR, VND, PKR, BDT
• Middle East: AED, SAR, ILS
• Oceania: AUD, NZD
• Africa: ZAR, NGN, EGP

📅 Date & Time Calculator

Calculate dates, countdowns, and check world time!

World Clock

| Example | Result | |---------|--------| | time in tokyo | Tokyo: 8:57 PM (Wed, Jan 22) | | time in london | London: 10:57 AM (Wed, Jan 22) | | time in new york | New York: 5:57 AM (Wed, Jan 22) |

50+ Locations Supported: Tokyo, London, New York, Paris, Sydney, Dubai, Singapore, Mumbai, Berlin, Moscow, and more!

Date Arithmetic

| Example | Result | |---------|--------| | today + 30 days | Friday, February 21, 2026 | | today - 2 weeks | Wednesday, January 8, 2026 | | today + 6 months | Wednesday, July 22, 2026 | | today + 1 year | Friday, January 22, 2027 |

Countdowns

| Example | Result | |---------|--------| | days until christmas | 337 days from now | | days until new year | 344 days from now | | days since jan 1 | 21 days ago |

Quick Queries

| Example | Result | |---------|--------| | today | Wednesday, January 22, 2026, 4:27 PM | | time | 4:27:07 PM | | week | Week 4 of 2026 | | what day is dec 25 | Thursday, December 25, 2025 |

💻 Programmer Calculator

Hex, Binary, Octal conversions and bitwise operations for developers!

Number Conversions

| Example | Result | |---------|--------| | 255 to hex | 255 = 0xFF (hex) | | 255 to binary | 255 = 1111 1111 (binary) | | 255 to octal | 255 = 0o377 (octal) | | 0xFF to decimal | 0xFF = 255 (decimal) | | 0b11111111 to decimal | 0b11111111 = 255 (decimal) | | hex 255 | 0xFF | | bin 255 | 0b11111111 |

Bitwise Operations

| Example | Result | |---------|--------| | 255 AND 128 | 255 AND 128 = 128 | | 255 OR 64 | 255 OR 64 = 255 | | 255 XOR 128 | 255 XOR 128 = 127 | | NOT 255 | NOT 255 = 4294967040 (32-bit) | | 16 << 2 | 16 << 2 = 64 | | 64 >> 2 | 64 >> 2 = 16 |

📏 Unit Conversions

Convert between various units instantly!

Length

| Example | Result | |---------|--------| | 10 km to miles | 6.2137 miles | | 100 meters to feet | 328.084 feet | | 5 inches to cm | 12.7 cm |

Weight

| Example | Result | |---------|--------| | 100 kg to pounds | 220.462 pounds | | 150 lbs to kg | 68.039 kg | | 1 ton to kg | 1000 kg |

Temperature

| Example | Result | |---------|--------| | 100 F to C | 37.78 °C | | 0 C to F | 32 °F | | 300 K to C | 26.85 °C |

Volume

| Example | Result | |---------|--------| | 1 gallon to liters | 3.785 liters | | 500 ml to cups | 2.11 cups |

Data

| Example | Result | |---------|--------| | 1 GB to MB | 1024 MB | | 1 TB to GB | 1024 GB |

🔐 Password Generator

Generate secure random passwords instantly!

| Example | Result | |---------|--------| | password | 🔐 Password: xK9#mP2$nL7@qR | | password 16 | 16-character secure password | | password 20 | 20-character secure password |

🎲 Random Generator

Random numbers, dice rolls, coin flips, and UUIDs!

| Example | Result | |---------|--------| | random | 🎲 Random (1-100): 42 | | random 1 1000 | 🎲 Random (1-1000): 567 | | dice | 🎲 Dice (d6): 4 | | d20 | 🎲 Dice (d20): 17 | | coin | 🪙 Coin Flip: Heads | | flip | 🪙 Coin Flip: Tails | | uuid | 🔑 UUID: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d |

🎨 Color Converter

Convert between HEX, RGB, and HSL color formats!

| Example | Result | |---------|--------| | #FF5733 | 🎨 Color: #FF5733 | rgb(255, 87, 51) | hsl(11, 100%, 60%) | | #FF5733 to rgb | 🎨 Color: rgb(255, 87, 51) | | rgb(255,0,0) to hex | 🎨 Color: #FF0000 |

📝 Text Utilities

Transform and analyze text!

| Example | Result | |---------|--------| | upper hello world | 📝 upper: HELLO WORLD | | lower HELLO WORLD | 📝 lower: hello world | | reverse hello | 📝 reverse: olleh | | capitalize hello world | 📝 capitalize: Hello World | | count hello world | 📊 Count: 11 chars, 2 words | | camelcase hello world | 📝 camelcase: helloWorld | | snakecase hello world | 📝 snakecase: hello_world | | kebabcase hello world | 📝 kebabcase: hello-world |

😀 Emoji Search

Find emojis by category!

| Example | Result | |---------|--------| | emoji happy | 😀 Emojis: 😀 😃 😄 😁 😆 😊 🙂 😇 🥰 😍 | | emoji heart | 😀 Emojis: ❤️ 🧡 💛 💚 💙 💜 🖤 🤍 🤎 💔 | | emoji fire | 😀 Emojis: 🔥 💥 ⚡ ✨ 💫 🌟 ⭐ | | emoji food | 😀 Emojis: 🍕 🍔 🍟 🌭 🍿 🥗 🍣 🍜 🍩 🍪 | | emoji music | 😀 Emojis: 🎵 🎶 🎼 🎹 🎸 🎺 🥁 🎷 🎻 | | emoji animal | 😀 Emojis: 🐶 🐱 🐭 🐹 🐰 🦊 🐻 🐼 🐨 🦁 |

Categories: happy, sad, love, heart, angry, laugh, cool, fire, music, food, drink, animal, nature, weather, sport, travel, work, money, celebrate, thumbs, hand, face, star, check, cross, time, arrow

🔒 Hash & Encoding

Generate hashes and encode/decode Base64!

| Example | Result | |---------|--------| | md5 hello | 🔒 MD5: 5d41402abc4b2a76b9719d911017c592 | | sha256 hello | 🔒 SHA256: 2cf24dba5fb0a30e... | | sha1 hello | 🔒 SHA1: aaf4c61ddcc5e8a... | | base64 encode hello | 🔤 Base64 encode: aGVsbG8= | | base64 decode aGVsbG8= | 🔤 Base64 decode: hello |

🔍 Quick Web Search

Search the web directly from the calculator!

| Example | Action | |---------|--------| | google AI news | Opens Google search for "AI news" | | youtube music videos | Opens YouTube search for "music videos" | | wiki Albert Einstein | Opens Wikipedia search | | github react | Opens GitHub search for "react" | | stackoverflow javascript | Opens StackOverflow search | | amazon laptop | Opens Amazon search for "laptop" | | maps New York | Opens Google Maps search | | reddit programming | Opens Reddit search | | twitter elon musk | Opens Twitter search |

Supported Search Engines: google, youtube, bing, duckduckgo, wiki, wikipedia, github, stackoverflow, amazon, twitter, reddit, maps

⚙️ System Commands

Control your Windows PC directly from the calculator!

Power Controls

| Command | Action | |---------|--------| | sleep | Put computer to sleep | | lock | Lock the computer | | shutdown | Shutdown the computer | | restart | Restart the computer | | logout | Log out current user |

Volume Controls

| Command | Action | |---------|--------| | mute | Toggle mute | | unmute | Toggle mute | | volume up | Increase volume | | volume down | Decrease volume |

Screen & Connectivity

| Command | Action | |---------|--------| | brightness up | Increase screen brightness | | brightness down | Decrease screen brightness | | wifi on | Enable WiFi | | wifi off | Disable WiFi | | bluetooth on | Enable Bluetooth | | bluetooth off | Disable Bluetooth |

Quick Launch Apps

| Command | Action | |---------|--------| | notepad | Open Notepad | | calculator | Open Windows Calculator | | explorer / files | Open File Explorer | | task manager | Open Task Manager | | control panel | Open Control Panel | | settings app | Open Windows Settings | | cmd | Open Command Prompt | | powershell | Open PowerShell | | browser | Open default browser | | screenshot / snip | Open Snipping Tool |

System Info

| Command | Action | |---------|--------| | ip | Show your IP address | | battery | Show battery percentage |

🎨 Themes

Customize your calculator with 8 beautiful themes!

| Command | Theme | |---------|-------| | theme dark | Dark Mode (default) | | theme light | Light Mode | | theme midnight | Midnight Blue | | theme forest | Forest Green | | theme sunset | Sunset Orange | | theme purple | Royal Purple | | theme neon | Neon Glow | | theme ocean | Deep Ocean | | themes | List all available themes |

⚡ Settings & Configuration

| Command | Action | |---------|--------| | settings | View current settings | | autostart on | Start with Windows | | autostart off | Disable auto-start | | help | Show all commands | | history | View calculation history | | clear history | Clear calculation history | | quit / exit | Close Mani-Calc |

⌨️ Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | Alt + Space | Toggle calculator overlay | | Enter | Execute & copy result to clipboard | | Escape | Close overlay |

🛠️ Development

Project Structure

mani-calc/
├── src/
│   ├── core/
│   │   ├── math-engine.js       # Math calculations
│   │   ├── currency-converter.js # Currency conversion
│   │   ├── date-time-calculator.js # Date/time calculations
│   │   ├── programmer-calc.js   # Hex/Binary/Bitwise
│   │   ├── unit-converter.js    # Unit conversions
│   │   ├── nlp-parser.js        # Natural language parsing
│   │   ├── history-manager.js   # Calculation history
│   │   ├── clipboard-manager.js # Clipboard operations
│   │   └── settings-manager.js  # User settings
│   ├── ui/
│   │   ├── main-electron.js     # Electron main process
│   │   ├── floating-search.js   # Overlay window logic
│   │   └── overlay.html         # UI template
│   ├── integration/
│   │   └── windows-search.js    # Windows Search integration
│   └── index.js                 # Main entry point
├── bin/
│   ├── cli.js                   # CLI interface
│   └── overlay.js               # Overlay launcher
├── test/
│   └── test.js                  # Test suite
└── package.json

Run in Development

# Run overlay mode
npm run overlay

# Run CLI mode
npm start

# Run tests
npm test

📋 Requirements

• OS: Windows 10/11
• Node.js: v14.0.0 or higher
• Electron: Included in dependencies

📝 Changelog

v2.1.0 (January 2026)

• ✨ Password Generator - Generate secure random passwords (8-64 chars)
• ✨ Random Generator - Random numbers, dice rolls, coin flips, UUIDs
• ✨ Color Converter - Convert HEX, RGB, HSL formats
• ✨ Text Utilities - upper, lower, reverse, capitalize, camelcase, snakecase, kebabcase, count
• ✨ Emoji Search - Find emojis by category (30+ categories)
• ✨ Hash Generator - MD5, SHA1, SHA256, SHA512 hashes
• ✨ Base64 Encoding - Encode/decode Base64 strings
• ✨ Quick Web Search - Google, YouTube, Wikipedia, GitHub, StackOverflow, Amazon, Reddit, Maps
• 📚 Complete README documentation with all features

v2.0.0 (January 2026)

• ✨ Currency Converter - 40+ world currencies
• ✨ Date/Time Calculator - World clock, date arithmetic, countdowns
• ✨ Programmer Mode - Hex, Binary, Octal, Bitwise operations
• ✨ 8 Color Themes - Dark, Light, Midnight, Forest, Sunset, Purple, Neon, Ocean
• ✨ 25+ System Commands - Control Windows from the overlay
• ✨ Auto-Start - Start with Windows option
• ✨ Live Calculation - See results as you type
• 🔧 Fixed volume controls (replaced nircmd with native PowerShell)
• 🔧 Fixed help command visibility
• 🔧 Improved settings persistence

v1.2.3 (Previous)

• Basic math calculations
• Unit conversions
• Windows Search integration

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

📄 License

MIT License - see LICENSE for details.

👨‍💻 Author

Manideep Reddy Eevuri

Made with ❤️ for Windows users who love productivity!