Client Interface

Overview#

JustClient is a Qt6 desktop application that provides a tabbed, dockable interface for managing C2 operations. All panels can be rearranged, detached, and reorganized to suit your workflow.

Main Toolbar#

The left sidebar provides quick access to all major sections:

Sessions Table#

The sessions table is the primary view for managing agent connections. Each row represents an active agent session.

Columns#

• Agent ID — Unique identifier for the session
• Name — Agent display name
• Listener — Which listener the agent is connected through
• External IP — The agent’s public IP address
• Internal IP — The agent’s local network IP
• Username — The user context the agent is running as
• Computer — Hostname of the target machine
• OS — Operating system (with icon: Windows, Linux, macOS)
• Process — The process hosting the agent
• PID — Process ID
• Architecture — CPU architecture (x86, x64, arm64)
• Sleep — Current sleep interval
• Last Seen — Time since last check-in

Session Actions#

Right-click a session to access the context menu:

• Interact — Open the agent console
• Set Tag — Apply a custom tag for organization
• Set Mark — Mark the session (e.g., important, compromised)
• Set Color — Color-code the session row
• Remove — Remove the session from the table
• Terminate — Send a kill command to the agent

Session Colors#

• Blue icon — Active session (checking in within expected interval)
• Red icon — Elevated/admin session
• Grey icon — Stale session (missed check-ins)

Agent Console#

Double-click a session (or right-click → Interact) to open its console. The console provides a command-line interface for interacting with the agent.

Commands are typed in the input field at the bottom. Output appears in the scrollable console area above. The console supports:

• Syntax highlighting for output
• Scrollable history
• Task status indicators (pending, completed, error)
• File and process browser integration

Sessions Graph#

The graph view provides a visual representation of the network:

• Cloud node — The teamserver
• Firewall node — Network boundary
• Target nodes — Compromised hosts (color-coded by OS and status)
• Lines — Communication paths between agents and listeners

Graph styles can be configured in settings (v1, v2, v3 icon sets).

Docking System#

All panels use the KDDockWidgets framework, which means:

• Drag tabs to rearrange panels
• Detach panels into floating windows
• Stack panels as tabs within the same area
• Split the view horizontally or vertically

The layout persists across sessions when saved in the client settings.

Theme and Appearance#

JustClient uses the Qlementine theme engine with JSON-based theme configuration. The default theme is a modern dark theme optimized for extended use.

Console themes can be customized separately from the main UI theme, allowing different color schemes for the agent console output.

Theme settings are accessible via the Settings dialog.

Settings Dialog#

Access settings via the gear icon or menu. Available options include:

• Main theme — Application-wide visual theme
• Console theme — Agent console color scheme
• Graph icon set — Choose between v1, v2, or v3 graph node icons
• Font settings — Console and UI font configuration
• Connection profiles — Save and load server connection profiles