Skip to content

In this space I will share tools or modules that I consider useful for day to day projects. They will be updated according to my needs at the moment.

License

Notifications You must be signed in to change notification settings

VoxHash/KillerTools

KillerTools

KillerTools Logo

A modern, cross-platform Swiss-army toolkit for developers and makers

CI License: MIT Python 3.11+ Code style: Ruff PyPI version

DocumentationInstallationQuickstartPlugins

🚀 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

🤝 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


About

In this space I will share tools or modules that I consider useful for day to day projects. They will be updated according to my needs at the moment.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published