TruffleHog GUI 🐷🛡️

A Single-File, Lightweight, and High-Performance Desktop GUI for the TruffleHog Security Scanner. Built with Python and CustomTkinter for a modern, dark-themed experience.

🚀 Features

• ⚡ High Performance: Optimized background processing using subprocess and communicate() to prevent deadlocks and ensure maximum speed.
• 🎨 Modern Dark UI: Sleek Charcoal background (#1A1A1A) with Emerald Green accents (#10B981).
• 📊 Real-time Analytics: Live cards showing "Verified", "Unverified", and "Total Scanned" results.
• 🛡️ Smart Parsing: Distinguishes between TruffleHog logs and actual secret findings.
• 🛑 No-Update Flag: Hardcoded --no-update to prevent permission issues on Windows.
• 📂 Auto-Fallbacks: Leverages trufflehog github for blazing-fast scans on GitHub repositories.

🛠️ Installation

Prerequisites

1. Python 3.8+ installed on your system.
2. TruffleHog installed and added to your system's PATH.
   • Download from TruffleHog Releases.

Setup

1. Clone this repository:

   git clone https://github.com/PhakapholDherachaisuphakij/TruffleHog_Gui.git
   cd TruffleHog_Gui
   

2. Create a virtual environment and install dependencies:

   python -m venv .venv
   # On Windows:
   .venv\Scripts\activate
   # On macOS/Linux:
   source .venv/bin/activate
   
   pip install -r requirements.txt
   

🖥️ Usage

Run the application:

python main.py

1. Enter the target Git repository URL.
2. Click "Dig for Secrets".
3. Watch the logs stream and check the result cards for any exposed credentials.

📁 Project Structure

TruffleHog_Gui/
├── .github/                  # GitHub specific templates and workflows
├── src/                      # Source code (Planned for future expansion)
├── main.py                   # Main application file (Single-file architecture)
├── requirements.txt          # Python dependencies
├── LICENSE                   # MIT License
├── README.md                 # Project documentation
└── .gitignore                # Git ignore rules

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ for the security community.