My Simple Tools

Cross-platform desktop application with a collection of developer utilities.

Features

Base64 to File

Convert base64 strings to files.

• Extract base64 from JSON or arbitrary text
• Auto-detect file format by magic bytes (PNG, JPG, PDF, ZIP, EXE, etc.)
• Manual format selection for saving
• Drag & drop file support

File to Base64

Convert files to base64 strings.

• Support for any file format
• Copy result to clipboard

JWT Decoder

Decode and analyze JWT tokens.

• Display header and payload in formatted JSON
• Check expiration status (expired/valid)
• Show expiration time in human-readable format

Generator

UUID and Password/Secret generation.

• Generate UUID v4
• Configurable password length (8-64)
• Customizable character sets (Uppercase, Numbers, Symbols)
• One-click copy to clipboard

Barcode Generator

Generate 2D Barcodes and QR Codes instantly.

• Support for QR Code, DataMatrix, and Code 128
• Export and save as PNG image
• Built-in live preview canvas

Unix Timestamp Converter

Bidirectional date-time conversion.

• Timestamp ↔ Human-readable date
• Support for Seconds and Milliseconds
• Current time display and "Use Current" feature
• Support for ISO and local formats

Cron Expression Explainer

Human-readable cron descriptions.

• Instant translation of cron expressions
• 24-hour format support
• Predefined common examples
• Real-time syntax validation

XRay Config Editor

Edit XRay routing configuration via SSH.

• SSH connection to remote server
• Load and save 05_routing.json
• Text search with result navigation
• JSON formatting
• Xkeen control (start/stop/restart)

Reverse Proxy

Lightweight reverse proxy server.

• Route by path prefix → target URL
• Add/delete/edit routes
• Enable/disable individual routes
• Request Inspector (view headers and body)
• Repeat Request functionality
• Real-time request logging

DOCX to Markdown

Convert Microsoft Word documents to Markdown format.

• Upload .docx files via drag & drop or file picker
• Automatic conversion preserving structure (headings, lists, code blocks, etc.)
• Toggle for images: Include/exclude images in output
  • When enabled: Images embedded as data URI in markdown
  • When disabled: Images are skipped during conversion
• Syntax-highlighted preview with character limit for large files
• Copy full Markdown to clipboard
• Download as .md file

Tech Stack

• Runtime: Bun.js
• Frontend: React 19, Vite 7, TypeScript
• Desktop: webview-bun (native OS webview)
• SSH: ssh2

Development

# Install dependencies
bun install

# Run backend server
bun run dev

# Run frontend (in another terminal)
bun run dev:frontend

Build

bun run build

This will run the cross-platform builds relying on the current OS. Output in dist/:

• Executable (my-simple-tools.exe on Windows or my-simple-tools on Unix)
• frontend/ — static frontend files
• config.json — configuration

Environment Variables

For SSH password, use a .env file (recommended for security):

# .env
SSH_PASSWORD=your_password_here

Copy .env.example to .env and set your password. The .env file is included in .gitignore.

Usage

1. Place config.json and .env next to the executable
2. Run my-simple-tools.exe (Windows) or ./my-simple-tools (macOS/Linux)
3. The application will open in a native window

Auto-Updates

The application automatically checks for new releases on GitHub upon launch and displays a banner with a download link if a new version is available.

Requirements

• Windows 10/11, macOS, or modern Linux distribution
• For building: Bun.js 1.0+