|
1 | 1 | # DevToolbox |
2 | 2 |
|
3 | | -[](https://github.com/vuon9/devtoolbox/actions/workflows/ci.yml) |
4 | | -[](https://github.com/vuon9/devtoolbox/actions/workflows/release.yml) |
5 | | -[](https://opensource.org/licenses/MIT) |
6 | | -[](https://go.dev) |
| 3 | +> [Download for macOS](https://github.com/vuon9/devtoolbox/releases) · [Windows](https://github.com/vuon9/devtoolbox/releases) · [Linux](https://github.com/vuon9/devtoolbox/releases) |
7 | 4 |
|
8 | | -Essential software development tools for everyday tasks. |
| 5 | +A single app for 45+ common development tasks. Works offline, zero setup. |
9 | 6 |
|
10 | | -<img width="1552" height="922" alt="image" src="https://github.com/user-attachments/assets/7dc24777-7330-485a-b6b4-b522739536c0" /> |
| 7 | +Base64, JWT, JSON formatting, hashing, encoding, escaping, color conversion, regex testing, cron parsing, diff checking, Unix time conversion, barcode generation, mock data, and 30+ more. |
11 | 8 |
|
| 9 | +<img width="1552" height="922" alt="DevToolbox interface" src="https://github.com/user-attachments/assets/7dc24777-7330-485a-b6b4-b522739536c0" /> |
12 | 10 |
|
13 | | -## Features |
| 11 | +No browser tabs. No data sent to servers. Just open and use. |
14 | 12 |
|
15 | | -### **Browser Support** |
| 13 | +## Desktop or Browser |
16 | 14 |
|
17 | | -DevToolbox now works in both desktop and browser modes: |
18 | | - |
19 | | -- **Desktop**: Native Wails application with native performance (default) |
20 | | -- **Browser**: Access via `http://localhost:8081` when the desktop app is running |
21 | | - |
22 | | -The frontend automatically detects the environment and uses the appropriate API (Wails runtime for desktop, HTTP for browser). See [docs/BROWSER_MODE.md](docs/BROWSER_MODE.md) for details. |
23 | | - |
24 | | -### **Text Based Converter** (Unified Tool) |
25 | | -The central hub with 45+ algorithms across 5 categories: |
26 | | - |
27 | | -| Category | Algorithms | |
28 | | -|----------|------------| |
29 | | -| **🔐 Encrypt / Decrypt** | AES, AES-GCM, DES, Triple DES, ChaCha20, Salsa20, XOR, RC4 | |
30 | | -| **🔀 Encode / Decode** | Base64, Base64URL, Base32, Base58, Base16 (Hex), URL, HTML Entities, Binary, Morse Code, ROT13, ROT47, Quoted-Printable | |
31 | | -| **✂️ Escape / Unescape** | String Literal, Unicode/Hex, HTML/XML, URL, Regex | |
32 | | -| **🔄 Convert** | JSON ↔ YAML, JSON ↔ XML, JSON ↔ CSV, YAML ↔ TOML, CSV ↔ TSV, Properties ↔ JSON, INI ↔ JSON, Key-Value ↔ Query String, Number Bases, Case Swapping, Color Codes | |
33 | | -| **#️⃣ Hash** | MD5, SHA-1, SHA-224, SHA-256, SHA-384, SHA-512, SHA-3, BLAKE2b, BLAKE3, RIPEMD-160, bcrypt, scrypt, Argon2, HMAC, CRC32, Adler-32, MurmurHash3, xxHash, FNV-1a | |
34 | | - |
35 | | -**Special Features:** |
36 | | -- **"All Hashes" view** - Compute all 19 hash algorithms at once with copy buttons for each |
37 | | -- **Quick Action Tags** - Save frequently used conversions for instant access |
38 | | -- **Base64 Image Preview** - Automatically displays base64 images in output pane |
39 | | -- **Smart key/IV detection** - Automatically shows configuration pane when needed |
40 | | -- **Auto-run mode** - Results update instantly as you type |
41 | | -- **Horizontal/Vertical layout toggle** - Customize the workspace layout |
42 | | - |
43 | | -### **Other Tools** |
44 | | - |
45 | | -| Tool | Description | |
46 | | -|------|-------------| |
47 | | -| **JWT Debugger** | Decode and verify JWT tokens with header/payload inspection | |
48 | | -| **Barcode / QR Code Generator** | Create QR codes and 1D barcodes (EAN-13, EAN-8, Code 128, Code 39) with preview and download | |
49 | | -| **Data Generator** | Generate mock data with templates using Faker library (UUID, ULID, Random String, Lorem Ipsum, User Profiles, API responses, SQL inserts, and more) | |
50 | | -| **Code Formatter** | Format and minify JSON, XML, HTML, SQL, CSS, and JavaScript with advanced filtering support (jq for JSON, XPath for XML, CSS selectors for HTML) | |
51 | | -| **Color Converter** | Pick colors with eyedropper and generate code snippets for 11+ programming languages (CSS, Swift, .NET, Java, Android, Obj-C, Flutter, Unity, React Native, OpenGL, SVG) | |
52 | | -| **RegExp Tester** | Test regular expressions with real-time matching | |
53 | | -| **Unix Time Converter** | Convert between Unix timestamps and human-readable dates | |
54 | | -| **String Utilities** | Sort/Dedupe lines, Case conversion (camelCase, snake_case, etc.), String Inspector | |
55 | | -| **Cron Job Parser** | Parse and explain cron expressions | |
56 | | -| **Text Diff Checker** | Compare two text blocks and highlight differences | |
57 | | -| **Number Converter** | Convert between Decimal, Hex, Octal, and Binary | |
| 15 | +- **Desktop:** Native app (default). Fast, works offline. |
| 16 | +- **Browser:** Access at `http://localhost:8081` when desktop app is running. |
58 | 17 |
|
59 | 18 | ## Installation |
60 | 19 |
|
61 | | -### Download Pre-built Binaries |
62 | | -Download the latest release for your platform from the [Releases](https://github.com/vuon9/devtoolbox/releases) page. |
63 | | - |
64 | | -**Supported Platforms:** |
65 | | -- Windows (x64) |
66 | | -- macOS (Intel & Apple Silicon) |
67 | | -- Linux (x64) |
68 | | - |
69 | | -### Build from Source |
70 | | - |
71 | | -**Prerequisites:** |
72 | | -- Bun (>= 1.0) - Required for frontend dependencies |
73 | | -- Go (>= 1.22) |
74 | | -- Wails CLI: `go install github.com/wailsapp/wails/v2/cmd/wails@latest` |
| 20 | +### macOS |
75 | 21 |
|
76 | | -**Build Steps:** |
77 | 22 | ```bash |
78 | | -# Clone the repository |
79 | | -git clone https://github.com/your-org/devtoolbox.git |
80 | | -cd devtoolbox |
81 | | - |
82 | | -# Install dependencies and build |
83 | | -wails build |
84 | | - |
85 | | -# Or run in development mode |
86 | | -wails dev |
| 23 | +# Download from releases, then: |
| 24 | +xattr -cr /Applications/devtoolbox.app # First run only |
87 | 25 | ``` |
88 | 26 |
|
89 | | -## Installation |
90 | | - |
91 | | -Download the latest release for your platform from the [Releases](https://github.com/vuon9/devtoolbox/releases) page. |
92 | | - |
93 | | -### macOS |
94 | | - |
95 | | -⚠️ **Note:** The macOS build is not signed with an Apple Developer certificate (requires $99/year). You may see a security warning when opening the app. |
96 | | - |
97 | | -**To bypass the security warning:** |
98 | | - |
99 | | -1. Download the `devtoolbox-macos.dmg` file |
100 | | -2. Open the DMG and drag the app to your Applications folder |
101 | | -3. **First time only:** Open Terminal and run: |
102 | | - ```bash |
103 | | - xattr -cr /Applications/devtoolbox.app |
104 | | - ``` |
105 | | - Or alternatively: |
106 | | - - Go to **System Settings** → **Privacy & Security** |
107 | | - - Scroll down to the "Security" section |
108 | | - - Click **"Open Anyway"** next to the message about "devtoolbox" |
109 | | - - Click **"Open"** in the dialog that appears |
110 | | - |
111 | | -4. The app will now open normally |
112 | | - |
113 | 27 | ### Windows |
114 | 28 |
|
115 | | -1. Download `devtoolbox-windows.exe` |
116 | | -2. Run the executable |
117 | | -3. If Windows Defender shows a warning, click **"More info"** → **"Run anyway"** |
| 29 | +Download `devtoolbox-windows.exe` from releases and run. |
118 | 30 |
|
119 | 31 | ### Linux |
120 | 32 |
|
121 | | -1. Download `devtoolbox-linux.tar.gz` |
122 | | -2. Extract: `tar -xzf devtoolbox-linux.tar.gz` |
123 | | -3. Run: `./devtoolbox` |
124 | | - |
125 | | -## Key Features |
126 | | - |
127 | | -✅ **Works Offline** - All tools run locally, no internet connection required |
128 | | -✅ **Dark/Light Themes** - Switch between themes or use system preference |
129 | | -✅ **Pin Tools** - Pin frequently used tools to the top of the sidebar |
130 | | -✅ **Keyboard Shortcuts** - `Cmd/Ctrl + B` to toggle sidebar |
131 | | -✅ **Copy to Clipboard** - One-click copy buttons on all output fields |
132 | | -✅ **Auto-run** - See results instantly as you type (can be disabled) |
133 | | -✅ **Responsive Layout** - Horizontal or vertical split panes |
134 | | - |
135 | | -## UI Design |
| 33 | +```bash |
| 34 | +tar -xzf devtoolbox-linux.tar.gz |
| 35 | +./devtoolbox |
| 36 | +``` |
136 | 37 |
|
137 | | -Built with **Carbon Design System** for a consistent, professional look: |
138 | | -- Clean, modern interface |
139 | | -- Accessible components |
140 | | -- Consistent spacing and typography |
141 | | -- Monospace fonts for code/data |
| 38 | +Build from source: [docs/BUILD.md](docs/BUILD.md) |
142 | 39 |
|
143 | 40 | ## License |
144 | 41 |
|
145 | | -MIT License - free to use, modify, and distribute. |
146 | | - |
147 | | ---- |
148 | | - |
149 | | -*Built with ❤️ using Go, React, and Wails.* |
| 42 | +MIT |
0 commit comments