VoxTools

A modern, cross-platform Swiss-army toolkit for developers and makers with plugin architecture, multiple interfaces (CLI/TUI/GUI), and professional tooling.

✨ Features

• Multiple Interfaces: CLI, TUI, and GUI applications
• Plugin Architecture: Extensible with custom plugins
• Cross-Platform: Works on Windows, macOS, and Linux
• Theme Support: System theme detection with manual switching
• Rich Output: Beautiful terminal output with Rich
• Modern UI: PyQt6 GUI with native look and feel
• Developer Tools: JSON/YAML formatters, regex tester, file operations, cryptography, and more

🧭 Table of Contents

• Quick Start
• Installation
• Usage
• Configuration
• Examples
• Architecture
• Roadmap
• Contributing
• License

🚀 Quick Start

# 1) Install
pipx install voxtools
# or
pip install voxtools

# 2) Run
voxtools --help
voxtools list-plugins
voxtools tui  # Launch TUI
voxtools gui  # Launch GUI

💿 Installation

See docs/installation.md for platform-specific steps.

Using pipx (Recommended)

pipx install voxtools

Using Poetry

git clone https://github.com/VoxHash/VoxTools.git
cd VoxTools
poetry install
poetry run voxtools --help

Using pip

pip install voxtools

🛠 Usage

Basic usage here. Advanced usage in docs/usage.md and docs/cli.md.

# Core commands
voxtools version
voxtools info
voxtools list-plugins

# Launch interfaces
voxtools tui   # Terminal UI
voxtools gui   # Graphical UI

⚙️ Configuration

Configuration is stored in ~/.voxtools/config.json. See docs/configuration.md for full reference.

Variable	Description	Default
theme.mode	Theme mode (system/light/dark)	system
theme.accent_color	Accent color in hex	#7C3AED
ui.window_width	Default window width	1200
ui.window_height	Default window height	800
logging.level	Log level	INFO

📚 Examples

• Start here: docs/examples/example-01.md
• More: docs/examples/

🧩 Architecture

VoxTools uses a plugin-based architecture with dynamic loading. See docs/architecture.md for details.

Key Components:

• Plugin Registry: Auto-discovers and registers plugins
• Core System: Settings, theming, logging
• Interfaces: CLI (Typer), TUI (Textual), GUI (PyQt6)

🔌 Plugins

Built-in Plugins

• Files Plugin: File hashing, duplicate detection, bulk operations
• Crypto Plugin: Hash functions, HMAC, JWT, UUID/ULID generation, Base64
• DevTools Plugin: JSON/YAML/TOML formatters, regex testing, .env parsing
• Image Plugin: AI image generation with OpenAI DALL-E

Coming Soon

• Media Plugin: Audio/video conversion, thumbnails, metadata
• Network Plugin: Ping, DNS lookup, HTTP probing, speed testing
• AI Plugin: Text summarization, translation, code generation

🗺 Roadmap

Planned milestones live in ROADMAP.md. For changes, see CHANGELOG.md.

🤝 Contributing

We welcome PRs! Please read CONTRIBUTING.md and follow the PR template.

🔒 Security

Please report vulnerabilities via SECURITY.md.

📞 Support

• Documentation: docs/ and full docs
• Issues: GitHub Issues
• Contact: See SUPPORT.md

📄 License

This project is licensed under the terms in LICENSE.

---

Made with ❤️ by VoxHash

⭐ Star this repo • 🐛 Report a bug • 💡 Request a feature