KillerTools

🚀 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, and more

📦 Installation

Using pipx (Recommended)

pipx install killertools

Using Poetry

git clone https://github.com/VoxHash/KillerTools.git
cd KillerTools
poetry install
poetry run killertools --help

Using pip

pip install killertools

🏃 Quickstart

CLI Interface

# Show help
killertools --help

# List available plugins
killertools list-plugins

# Run a specific plugin
killertools files --help
killertools crypto --help

TUI Interface

# Launch the TUI dashboard
killertools tui

GUI Interface

# Launch the GUI application
killertools gui

🔌 Plugins

KillerTools comes with several built-in plugins:

Files Plugin

• File hashing (MD5, SHA256, BLAKE3)
• Duplicate file detection
• Bulk file operations
• Directory tree with sizes

Crypto Plugin

• Hash functions and HMAC
• JWT token decoding
• UUID and ULID generation
• Base64 encoding/decoding

DevTools Plugin

• JSON/YAML/TOML formatters
• Regex pattern testing
• .env file parsing
• README badge generation

Media Plugin (Coming Soon)

• Audio/video conversion
• Thumbnail generation
• Media metadata extraction

Network Plugin (Coming Soon)

• Ping and DNS lookup
• HTTP probing
• Speed testing

AI Plugin (Optional)

• Text summarization
• Translation
• Code generation

🎨 Theming

KillerTools supports automatic system theme detection and manual theme switching:

• System: Automatically detects your OS theme preference
• Light: Force light theme
• Dark: Force dark theme

Themes are consistent across CLI, TUI, and GUI interfaces.

🛠️ Development

Setup Development Environment

# Clone the repository
git clone https://github.com/VoxHash/KillerTools.git
cd KillerTools

# Install dependencies
poetry install

# Install development dependencies
poetry install --with dev

# Set up pre-commit hooks
poetry run pre-commit install

Running Tests

# Run all tests
poetry run pytest

# Run with coverage
poetry run pytest --cov=killer_tools --cov=apps

# Run specific test file
poetry run pytest tests/test_plugins.py

Code Quality

# Run linters
poetry run ruff check killer_tools/ apps/ tests/

# Format code
poetry run black killer_tools/ apps/ tests/
poetry run isort killer_tools/ apps/ tests/

# Type checking
poetry run mypy killer_tools/ apps/

Building

# Build wheels
poetry build

# Build binaries
poetry run pyinstaller apps/cli/main.py --name killertools-cli --onefile
poetry run pyinstaller apps/tui/main.py --name killertools-tui --onefile
poetry run pyinstaller apps/gui/main.py --name killertools-gui --onefile --windowed

📚 Documentation

• Full Documentation
• API Reference
• Creating Plugins

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Typer for the CLI framework
• Textual for the TUI framework
• PyQt6 for the GUI framework
• Rich for beautiful terminal output
• Poetry for dependency management

📞 Contact

• Author: Silas Renner (VoxHash)
• Email: contact@voxhash.dev
• GitHub: @VoxHash
• Twitter: @VoxHash
• LinkedIn: VoxHash
• Telegram: @VoxHash

---