Skip to content

A terminal UI for Hack The Box built with Textual — manage and browse machines, and submit flags directly from your terminal.

Notifications You must be signed in to change notification settings

scmanjarrez/htbpanel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛠️ HTBPanel

HTBPanel is a terminal user interface (TUI) built with Textual, designed for interacting with Hack The Box machines directly from your terminal.

Whether you're hacking on a challenge or just exploring the platform, HTBPanel makes your workflow faster and more efficient — no more switching between browser tabs and terminal windows.


🚀 Features

HTBPanel supports a set of core functionalities that cover most day-to-day HTB tasks:

  • ⚙️ Start, stop, and reset machines
  • 🧠 View machine info (including IP address and status)
  • 🔍 Search for machines by name or filter criteria
  • 🏁 Submit flags

🔜 Coming Soon

Planned enhancements include:

  • 🔄 Force machine/tag update within the app

📦 Installation

Set up the project with a few simple steps:

# Create a virtual environment (using uv for speed, but pip works too)
$ uv venv venv
$ source venv/bin/activate

# Install dependencies
$ uv pip install -r requirements.txt

🧑‍💻 Usage

Launch the TUI with:

$ python -m htbpanel

From there, you can browse, manage, and interact with HTB machines right in your terminal.


🙌 Contributing

Have an idea or improvement? Feel free to open issues or submit pull requests! This is a learning-focused project and contributions are always welcome.


📸 Screenshots

🔛 Active Tab

🖥️ Machines Tab

🧩 Filters Screen

📡 VPN Tab

About

A terminal UI for Hack The Box built with Textual — manage and browse machines, and submit flags directly from your terminal.

Topics

Resources

Stars

Watchers

Forks

Languages