mani-calc 1.2.2 → 2.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,132 @@
1
+ # 🧮 Mani-Calc - Setup Guide for Friends
2
+
3
+ ## What is Mani-Calc?
4
+
5
+ A **Spotlight-style instant calculator** for Windows! Press `Alt+Space` anywhere to get a floating search bar for:
6
+ - ✅ Quick math calculations
7
+ - ✅ Unit conversions (km to miles, kg to pounds)
8
+ - ✅ Currency conversion (USD to INR)
9
+ - ✅ Date calculations
10
+ - ✅ Programmer mode (hex, binary)
11
+ - ✅ Password generator
12
+ - ✅ And more!
13
+
14
+ ---
15
+
16
+ ## 🚀 Quick Setup (2 Minutes)
17
+
18
+ ### Prerequisites
19
+ Make sure you have **Node.js** installed. If not, download it from: https://nodejs.org/
20
+
21
+ ---
22
+
23
+ ### Option 1: Double-Click Setup (Easiest) ⭐
24
+
25
+ 1. **Double-click `SETUP.bat`**
26
+ 2. Choose option **[3] Both** to install auto-start and start now
27
+ 3. Done! Press `Alt+Space` to use!
28
+
29
+ ---
30
+
31
+ ### Option 2: Command Line Setup
32
+
33
+ Open **Command Prompt** or **PowerShell** in this folder:
34
+
35
+ ```bash
36
+ # Step 1: Install dependencies (only first time)
37
+ npm install
38
+
39
+ # Step 2: Enable auto-start (runs when Windows boots)
40
+ npm run install-autostart
41
+
42
+ # Step 3: Start now
43
+ npm run overlay
44
+ ```
45
+
46
+ ---
47
+
48
+ ## 📱 How to Use
49
+
50
+ 1. **Press `Alt+Space`** anywhere on your computer
51
+ 2. A floating search bar appears
52
+ 3. Type your calculation:
53
+ - `2 + 3 * 5` → Result: 17
54
+ - `10 km to miles` → Result: 6.21 miles
55
+ - `100 USD to INR` → Shows converted amount
56
+ - `today + 30 days` → Shows the date
57
+ - `255 to hex` → Result: 0xFF
58
+ 4. **Press Enter** - result is copied to clipboard!
59
+ 5. **Press Escape** to hide the overlay
60
+
61
+ ---
62
+
63
+ ## 🎯 Commands Reference
64
+
65
+ | Command | Example | Result |
66
+ |---------|---------|--------|
67
+ | Math | `sqrt(144)` | 12 |
68
+ | Percentage | `20% of 500` | 100 |
69
+ | Conversion | `5 miles to km` | 8.05 km |
70
+ | Currency | `100 USD to EUR` | Converted amount |
71
+ | Time | `time in tokyo` | Current time in Tokyo |
72
+ | Date | `today + 2 weeks` | Future date |
73
+ | Programmer | `255 to hex` | 0xFF |
74
+ | Password | `password 16` | Random 16-char password |
75
+ | Themes | `themes` | List available themes |
76
+
77
+ ---
78
+
79
+ ## ⚙️ Useful Commands
80
+
81
+ ```bash
82
+ # Start the overlay
83
+ npm run overlay
84
+
85
+ # Stop the overlay
86
+ npm run stop
87
+
88
+ # Enable auto-start (runs when Windows boots)
89
+ npm run install-autostart
90
+
91
+ # Disable auto-start
92
+ npm run uninstall-autostart
93
+ ```
94
+
95
+ ---
96
+
97
+ ## 🎨 Change Theme
98
+
99
+ Type in the search bar:
100
+ - `themes` - See available themes
101
+ - `theme dark` - Switch to dark mode
102
+ - `theme gradient` - Use gradient theme
103
+
104
+ ---
105
+
106
+ ## ❓ Troubleshooting
107
+
108
+ ### App doesn't start?
109
+ 1. Make sure Node.js is installed
110
+ 2. Run `npm install` first
111
+ 3. Try `npm run overlay`
112
+
113
+ ### Can't stop the app?
114
+ Run: `npm run stop`
115
+
116
+ ### Want to remove auto-start?
117
+ Run: `npm run uninstall-autostart`
118
+
119
+ ---
120
+
121
+ ## 💡 Tips
122
+
123
+ - **Results are auto-copied** to clipboard - just paste anywhere!
124
+ - Works **100% offline** (except currency conversion)
125
+ - **8 beautiful themes** to choose from
126
+ - Press **Escape** to quickly hide the overlay
127
+
128
+ ---
129
+
130
+ Made with ❤️ by Manideep Reddy Eevuri
131
+
132
+ Enjoy! 🎉