Skip to content
iTsawaysuPublic

About

A macOS app aggregating various practical tools.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

XTools Icon

XTools

A quiet, native macOS developer toolbox. Fast, local-first, and keyboard-driven.

Release Stars License macOS 14+ Swift 6

Why

Developers constantly run into small, recurring tasks: formatting JSON, converting timestamps, decoding Base64, testing regexes, generating UUIDs, or inspecting HTTP status codes.

Opening browser tabs for routine transformations is tedious and can expose sensitive data (tokens, configs, keys) to third-party services. XTools keeps those transformations on the Mac and uses native macOS controls instead of a browser-based shell.

XTools packs 33 developer utilities into a single native macOS application. Most tools work entirely offline. HTML → Markdown can fetch an HTTP(S) URL that passes the host safety policy or load preview images when you explicitly allow them. Use Cmd + K in the app to open any tool quickly.

Quick Start

1. Download DMG (Recommended)

Download the latest DMG from GitHub Releases, open it, and drag XTools into Applications. Requires macOS 14.0+ on Apple Silicon or Intel; packaged builds target the current architecture.

2. Build from Source

Requires macOS 14+ and Xcode 16+.

git clone https://github.com/iTsawaysu/XTools.git
cd XTools
./build.sh           # Release build, package, and open the app
./build.sh dev       # Debug build for fast iteration
./build.sh build     # Release build and package without opening
swift test           # Run the complete automated test suite

Packaged builds are written to build/XTools.app.

Features

  • Swift 6 Native: Built with SwiftUI and AppKit, with core algorithms separated into the XToolsCore package.
  • Local-First: Cryptography, hashing, formatting, diffing, regex evaluation, and image processing execute on-device. XTools includes no telemetry or cloud tracking. HTML URL fetching and remote preview images require an explicit user action; the host policy blocks local or private address literals and known metadata hosts.
  • Keyboard-First: Press Cmd + K in the app for fuzzy search across all tools. Use Cmd + 1 through Cmd + 7 to switch categories, and Cmd + Return to run primary actions.
  • Clay Design System: Shared workbench components provide consistent panels, controls, diagnostics, keyboard focus, and accessibility behavior.
  • 34 Built-in Utilities: Curated essentials across conversions, cryptography, developer tools, Web debugging, image handling, time math, and system inspectors.
  • Automated Regression Tests: Core behavior and selected native UI paths have automated regression tests. A passing suite does not establish complete behavior or visual coverage.

Tool Catalog

Category Tools
Converters (5) Base64 File, Text Encoding (Base64 / URL / ASCII & Binary / Unicode), Base Converter, Roman Numerals, Case Converter
Crypto & Generators (4) Hash Text (MD5, SHA-1/256/512, SHA-3), AES Text Encryption, String Obfuscator, Generators (Token / UUID / Password)
Development (8) Formatters (JSON / SQL / XML / YAML), Diff (Text / JSON), Regex Tester, Docker Run ↔ Compose, HTML → Markdown, Crontab Generator, Random Port, Chmod Calculator
Web (5) JWT Parser & Signer, Basic Auth Generator, HTTP Status Codes, User-Agent Parser, Keycode Inspector
Image & Color (2) Image Processing (Format Converter / Compressor / Grayscale / Watermark / Favicon), Color Converter (HEX, RGB, HSL)
Time & Date (4) Unix Timestamp Converter (s/ms), Timezone Viewer, Date Calculator, Chronometer & Stopwatch
Utilities (5) Device & Hardware Info, MIME File Type Detector, Math Evaluator, Text Statistics, Emoji & Symbol Catalog

Shortcuts

Shortcut Action Description
Cmd + K Command Palette Global search across all 33 tools and commands
Cmd + 0 Workbench Return to dashboard with recent and favorite tools
Cmd + 1 – Cmd + 7 Switch Category Jump directly to any tool category
Cmd + F Filter Sidebar Focus the sidebar search filter
Cmd + B Toggle Sidebar Expand to full-width distraction-free workspace
Cmd + Return Primary Action Run format, generate, encrypt, or convert
Cmd + , Preferences Toggle appearance and app settings
Esc Dismiss Close command palette or reset current focus

Contributing

Contributions, bug reports, and tool suggestions are welcome!

  1. Fork the repository and create your feature branch.
  2. Follow the established code style and keep core algorithms inside XToolsCore.
  3. Run swift test before submitting to ensure all tests pass.

License

XTools is released under the MIT License.

About

A macOS app aggregating various practical tools.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages