Hemo OS documentation
How to install Hemo, drive it day to day, and fix the things that trip people up. Hemo is a Kali-based OS for security professionals that you rebuild for every engagement: pick a role and only that discipline's tools install.
Getting started
Hemo ships as a ready-to-run VMware virtual machine image (OVA). Give the VM 8 GB of RAM and turn on 3D acceleration, and take a snapshot after your first login so you can roll back.
Download the image
Download the VMware image, a single
.ovaof about 5 GB. To check it, getSHA256SUMS,SHA256SUMS.minisigandhemo-release.pubfrom the latest release and keep them next to the.ova.minisign -Vm SHA256SUMS -p hemo-release.pub &&sha256sum -c --ignore-missing SHA256SUMSAlready on Hemo 0.1.1 or later? Run
hemo-verifyin the download folder instead. It checks the signature with the key baked into the system, not the copy that came with the download.Import
Open the
.ovain VMware Workstation, Player or Fusion to import it.Log in
Log in as
hemowith the passwordhemo, just like Kali'skali/kali. You aren't forced to change it; do it withpasswdwhen you're ready.Pick your roles
Hemo Welcome opens automatically. Tick the roles the job needs; their tools install from the internet. The first role you pick is your primary and sets the wallpaper, accent and bookmarks.
Make it yours
On a clone, rename the machine and switch the look whenever you like.
sudo hemo-identity james officehemo-theme red_team
Everyday use
Add a role later
Install another discipline's tools any time.
sudo hemo-rolesSwitch the look
Re-skin to a role you already have, without installing anything.
hemo-theme blue_hostSet your target
Put the target in the bar and the prompt. It lives in a file, never an exported variable, so t prints it when you need it.
hemo-target 10.10.10.5nmap -sV "$(t)"Capture for the report
Frame the active window identically every time, straight to the clipboard.
shot # or Super+PrintMatch the team's screenshots
Flip the whole desktop to the shared standard, then back.
hemo-report toggle # Super+PCatch callbacks
Drop the roaming firewall before you need reverse shells.
sudo hemo-harden offKeep it awake
Stop the lock and suspend during a long crack or scan.
hemo-caffeine on # Super+Shift+CRecord the build
Write down exactly what's installed, for the engagement record.
hemo-bomOpen PowerShell
A second shell with the same themed prompt as zsh.
hemo-pwsh # Super+Shift+EnterEngagements
Each client gets its own folder under ~/engagements/. Make one active and everything that saves evidence (screenshots, the bill of materials, notes, terminal logs) lands in it. eng is short for hemo-engagement; both work.
Start a client
Creates scope, loot, scans, notes, creds and screenshots, records a baseline bill of materials, and makes it active.
eng new acme-corpSwitch clients
Points screenshots, notes and logs at the other client and brings back its saved target.
eng use other-clienteng # which one am I on?Note what happened
Adds a timestamped line to notes/timeline.md.
eng log "pivoted to DC01 via WinRM"tail "$(eng path)/notes/timeline.md"Log the terminal
In tmux, Ctrl+b then Shift+H starts a transcript of the pane in the engagement's tmux-logs/. Switch engagements mid-session and the rest of the output follows you. Press it again to stop.
tmux new -s acmeTime every command
While an engagement is active, a dated line prints before each command runs, so logs and screenshots carry the time. Pick the date, time and time zone in Settings → Appearance.
hemo-appearance set date isohemo-appearance set time 24h-tzhemo-appearance set tz estServe files to a target
Starts a file server on your VPN address (LAN if no VPN), with upload on, and copies a fetch one-liner to the clipboard. Serves the engagement's loot/ by default.
hemo-servehemo-serve --tls # or --webdav, --smbWrap up
Records a final bill of materials and clears the active engagement. Nothing is deleted.
eng closeWhat the prompt shows
Every prompt shows @client while an engagement is active. Pick the Engagement prompt in Settings → Appearance to also see the IP a target would see from you, and the current target:
# VPN up@acme-corp VPN up, 10.10.14.42 → 10.10.10.5 ~ ❯# no VPN: your public IP@acme-corp 203.0.113.7 → 10.10.10.5 ~ ❯
The IP is green with a shield when a VPN is up. When it isn't, it turns yellow and shows your public address instead, so a dropped tunnel is obvious on the next prompt.
~/.config/hemo/ and never exports them as environment variables, so they don't show up in env, aren't inherited by tools, and don't travel over SSH.Keyboard shortcuts
The Super key is the Windows / Command key. Press Super / at any time for a searchable list on the desktop itself.
Launchers & apps
- Super Enter
- Terminal (zsh)
- Super Shift Enter
- PowerShell terminal
- Super Alt Enter
- Screenshot-standard terminal
- Super d
- App launcher
- Super b
- Firefox (sandboxed)
- Super t
- File manager (Thunar)
- Super Shift d
- Settings / Welcome panel
- Super `
- Drop-down terminal
- Super c
- Clipboard history
- Alt Tab
- Window switcher
Windows & layout
- Super q
- Close the focused window
- Super h / j / k / l
- Focus left / down / up / right
- Super Shift h / j / k / l
- Move the window
- Super f
- Fullscreen
- Super Shift Space
- Toggle floating
- Super e / w / s
- Split / tabbed / stacked layout
- Super r
- Resize mode
- Super minus
- Show the scratchpad
- Super Shift minus
- Send window to the scratchpad
Workspaces
- Super 1–4
- Switch to workspace 1–4
- Super Shift 1–4
- Move window to workspace 1–4
- Super Tab
- Back to the previous workspace
- Super F2
- Rename the focused workspace
Screenshots & report
- Flameshot region capture, to mark up
- Super Print
- Capture the active window, framed
- Super Shift Print
- Capture a region, framed
- Super p
- Toggle report (team screenshot) mode
System & toggles
- Super Shift e
- Power menu
- Super Shift x
- Lock the screen
- Super Shift r
- Restart i3 in place
- Super /
- Searchable list of every shortcut
- Super Shift c
- Caffeine (keep awake)
- Super Shift m
- Do not disturb
- Super Shift b
- Night light
- Super n
- Dismiss the current notification
tmux
- Ctrl b then Shift H
- Start or stop logging the pane to the engagement
- Ctrl b then d
- Detach (the session keeps running)
- Ctrl b then r
- Reload the tmux config
Command reference
The hemo-* helpers you'll actually type. Most settings also live in the Hemo Welcome panel (Super Shift D).
Roles & look
hemo-rolesOpen the role picker to add roles. Each ticked role installs its tools; the first (primary) role sets the look.
sudo hemo-roleshemo-themeRe-skin the desktop to a role you already installed (wallpaper, accent, bookmarks, workspace names). Installs nothing.
hemo-themehemo-theme <role>hemo-theme <role> --allhemo-welcomeThe Welcome control center: roles, appearance, hotkeys and the setup checklist.
hemo-welcomehemo-welcome --settingshemo-welcome --setuphemo-appearanceChange one appearance setting and reload the app that owns it. Mostly driven by the GUI.
hemo-appearance set <key> <value>hemo-appearance get <key>hemo-appearance set prompt engagementhemo-appearance set tz Europe/Oslohemo-pywalOpt in to deriving the whole theme from the current wallpaper, instead of the curated palette. No contrast guarantee.
hemo-pywal onhemo-pywal offhemo-pywal statusEngagements & reporting
hemo-engagementCreate and switch per-client workspaces under ~/engagements/. Screenshots, notes, the bill of materials and tmux logs follow the active one. Short alias: eng.
eng new <client>eng use <client>engeng listeng log "<note>"eng noteseng closeeng patheng helphemo-logAdd a timestamped note to the active engagement's notes/timeline.md. Same as eng log.
hemo-log "<note>"hemo-targetSet or show the current target. It shows in the bar (click to copy) and the engagement prompt, and is saved with the active engagement. Kept in a file, never exported; print it with t.
hemo-target <ip|host|range>hemo-targethemo-target --clearnmap "$(t)"hemo-serveQuick file server for transfers (goshs), bound to your VPN address, else LAN. Upload is on; a fetch one-liner is copied to the clipboard. Serves the engagement's loot/ or the current folder.
hemo-serve [dir] [port]hemo-serve --tlshemo-serve --webdavhemo-serve --smbhemo-serve --read-onlyhemo-serve --allshotCapture a window or region, framed and sized identically for every report, saved to the engagement folder and copied to the clipboard.
shotshot -sSHOT_WIDTH=1280 shothemo-reportFlip the whole desktop to your team's screenshot standard, and back. Bound to Super P.
hemo-report togglehemo-report sethemo-report put <KEY> <VALUE>hemo-report resethemo-shottermOpen one terminal locked to the screenshot standard, without switching the whole desktop.
hemo-shottermhemo-shotterm --prompt <name>hemo-bomRecord a bill of materials, everything actually installed (apt, pipx, pip, go, /opt clones), for the current engagement.
hemo-bomhemo-bom <output-dir>Machine & network
hemo-verifyCheck a downloaded Hemo release: the signature against the key baked into this system, then every file against the signed checksums.
hemo-verifyhemo-verify <dir>hemo-bar-ipPrint or copy the addresses the bar shows. visible is the IP a target would see: the VPN address when one is up, else your public address.
hemo-bar-ip visiblehemo-bar-ip copy-visiblehemo-bar-ip vpnhemo-bar-ip egresshemo-identityRename the operator user and hostname on a fresh clone. Run it early, as root.
sudo hemo-identity <user> [host]sudo hemo-identity <user> --forcehemo-hardenToggle the roaming / hostile-network posture (firewall default-deny inbound plus strict network settings). Off by default so it never fights offensive work.
hemo-harden statussudo hemo-harden onsudo hemo-harden offhemo-gpuDetect a passed-through GPU and enable GPU cracking with hashcat, or stay CPU-only.
hemo-gpu detectsudo hemo-gpu enablesudo hemo-gpu disablehemo-caffeineKeep the session awake for long jobs: no idle lock, screen blanking or suspend. Bound to Super Shift C.
hemo-caffeine togglehemo-caffeine statushemo-dndPause notification popups for screen-shares and report captures. Bound to Super Shift M.
hemo-dnd togglehemo-nightToggle a warm night-light tint. Off by default so captures keep true colors. Bound to Super Shift B.
hemo-night toggleHeavy services (local Docker stacks)
hemo-bloodhoundBloodHound Community Edition, the AD attack-path graph. The web UI is bound to localhost.
hemo-bloodhound uphemo-bloodhound urlhemo-bloodhound passwordhemo-bloodhound downhemo-arkimeArkime full-packet PCAP indexing and search, for offline analysis.
hemo-arkime uphemo-arkime inithemo-arkime import <file.pcap>hemo-arkime downhemo-elkA local log-analytics stack (OpenSearch or Elasticsearch), bound to localhost.
hemo-elk uphemo-elk ingest <file>hemo-elk downhemo-adaptixBuild and run the AdaptixC2 teamserver in Docker, and launch its client on the host.
hemo-adaptix uphemo-adaptix clienthemo-adaptix downdown. destroy deletes it, and asks first. BloodHound, Arkime and the ELK stack all want roughly 8 GB, so run only one at a time.Troubleshooting
The things people hit most often, and the fix for each.
Apps are slow to open and the desktop feels sluggish
Why 3D acceleration is off, so the screen is drawn on the CPU.
Fix Power off the VM. In VMware, open Settings → Display and tick Accelerate 3D graphics (1 GB of graphics memory is plenty), then boot again. A cold Firefox launch drops to about a second.
Reverse shells, Responder or SMB catchers get no callbacks
Why The roaming firewall is on and dropping inbound connections.
Fix Turn it off for the engagement with sudo hemo-harden off, and back on with sudo hemo-harden on when you are on an untrusted network. Check the state with hemo-harden status. It is off by default.
No tools installed after first boot
Why Roles install their tools over the internet when you pick them, and the box had no network.
Fix Once you are online, run sudo hemo-roles, or open Hemo Welcome and install roles there.
The theme change didn't reach Firefox, Neovim or GTK apps
Why These apps read their theme only when they start.
Fix Fully quit and reopen the app. Close Cherrytree before switching themes, because it rewrites its config on exit.
Clipboard, drag-and-drop or window resizing with the host doesn't work
Why VMware Tools starts at login, and the session hadn't picked it up.
Fix Log out and back in. Hemo bakes in VMware Tools (open-vm-tools) and starts it automatically.
Flameshot captures come out blank
Why Flameshot needs the legacy X11 capture path on i3.
Fix Hemo sets useX11LegacyScreenshot=true and reapplies it on every theme change, so this is already handled. If you ever see it, set that key in ~/.config/flameshot/flameshot.ini and restart Flameshot.
You want Hemo Welcome to open again
Why It opens at login only until you finish setup.
Fix Run hemo-welcome any time, press Super+Shift+D, or use “Run setup again” in Settings.
You need to rename the machine from hemo@hemo
Why Linux can't rename a user who has running processes.
Fix Run sudo hemo-identity <user> <host> right after first boot, from a fresh text console (Ctrl+Alt+F2), or add --force.
Importing a VPN profile hangs
Why The minimal i3 build has no graphical file picker for the dialog.
Fix Import from the command line instead, for example nmcli connection import type openvpn file client.ovpn. The connection then appears in the network menu.
Starting BloodHound, and finding its password
Why BloodHound CE runs as a local container stack.
Fix Run hemo-bloodhound up (the first run downloads it), then hemo-bloodhound url for the address and hemo-bloodhound password for the admin password.
The app launcher is full of Kali “-h” help entries
Why Kali ships a launcher entry for every tool's help text.
Fix Run sudo hemo-menu-tidy to hide them, or hemo-menu-tidy --undo to bring them back.
The screen locks or the VM suspends during a long job
Why Idle locking and suspend are on by default.
Fix Press Super+Shift+C, or run hemo-caffeine on, to keep the session awake until you turn it back off.
Windows stack up or go tabbed after a stray key
Why Super+S and Super+W switch the container to a stacked or tabbed layout.
Fix Press Super+E to return to the normal split layout.
No date line prints before commands
Why The stamp only prints while an engagement is active, in a shell started after it was turned on.
Fix Run eng use <client>, then open a new terminal or run exec zsh. Check that Stamp date and Stamp time aren't both Off in Settings → Appearance. HEMO_STAMP=0 turns it off for one shell.
The IP in the prompt turned yellow
Why No VPN is up, so the prompt shows your public address, which is what a target on the internet would see.
Fix Reconnect the VPN from the network menu. The prompt goes back to the green shield on the next command. To stop the public-address lookup entirely, run touch ~/.config/hemo/no-egress.
The tmux log is missing or in the wrong folder
Why Logging writes to the active engagement's tmux-logs/, or to ~/engagements/tmux-logs/ when none is active.
Fix Check the active one with eng, then ls "$(eng logdir)". The line where you ran eng use stays in the old engagement's log; everything after it goes to the new one.
Firefox can't save a file outside Downloads
Why Firefox runs in a sandbox that only allows writes to Downloads and its own profile.
Fix Save to Downloads, or launch once with HEMO_NO_SANDBOX=1 firefox-esr when you need the full filesystem.
Tool catalog
Every tool Hemo can install, across all roles. Search by name, or filter by the roles that include it. Each links to its project. Pick a role on first boot and only its tools install.
Enumerate AD-integrated DNS records
Wireless WEP/WPA cracking utilities
In-depth DNS Enumeration and Network Mapping
Symbolic execution / binary analysis
Tool for reverse engineering Android apk files
Network flow (Argus) analysis clients
Parameter discovery
Arp scanning and fingerprinting tool
Graphical interface to SleuthKit
Or apt; pipx keeps it current
Confirm pipx support; else MS apt repo
Azure AD collector for BloodHound CE
Complete, modular, portable and easily extensible MITM framework
Tool library for analyzing binary blobs and executable code
Ce python
CravateRouge/bloodyAD
Extracts information without parsing filesystem
Implementation of the WPS brute force attack, written in C
Platform for security testing of web applications
Command-line WebDAV client
Modern Rust intercepting proxy (lighter Burp alt); CLI + desktop
FLARE capability detection in executables (blue_host)
Tool for attacking AD Certificate Services
Dump NTDS hashes remotely via AD CS
Custom word list generator
EVTX / Sigma hunting (blue_host)
If not taken from apt
Rootkit detector
NT SAM password recovery utility
Anti-virus utility for Unix - command-line interface
Find exploitable paths in cloud infrastructure
CMS Detection and Exploitation suite
Coerce a Windows server to authenticate on an arbitrary machine
Automated All-in-One OS Command Injection and Exploitation Tool
Python tool to extract credentials and secrets from Windows registry…
Tool for creating wordlist
XSS scanner
Testing tool for WebDAV servers
Patched version of GNU dd with forensic features
Tools to work with android .dex and java .class files
URL bruteforcing tool
Web server directory brute-forcer
Recon wrapper scripts
Deepmagic Information Gathering Tool
TCP-over-DNS tunnel server and client
Tool to enumerate domain DNS information
DNS domain name brute forcing tool
Powerful DNS enumeration script
Domain name permutation engine
Perform multiple dns queries
Remote DPAPI dumping
Generates position-independent shellcode from memory and runs them
Various tools to sniff network traffic for cleartext insecurities
Cross platform x86/x86-64 debugger
Next generation version of enum4linux
Ettercap GUI-enabled executable
Ultimate WinRM shell for hacking/pentesting
MFA bypass phishing proxy
Collection of tools for reading and writing EWF files
Searchable Exploit Database archive
Fast, simple, recursive content discovery tool written in Rust
Fast web fuzzer written in Go (program)
Domain DNS scanner
String extraction from malware; binary `floss`
Forensic program to recover lost files
Sends ICMP ECHO_REQUEST packets to network hosts
Tools)
Getallurls
GNU Debugger
GNU Debugger (with support for multiple architectures)
Software Reverse Engineering Framework
Detect secrets committed to git repositories
High-performance discovery tool for directories, DNS and cloud storage
Web screenshot utility using Chrome Headless
Group Policy Preferences decrypter
GraphQL exploitation
GraphQL engine fingerprinting
SBOM / container vuln scanner (vuln_assessor)
Forensic imaging tool based on Qt
Remote network security auditor - metapackage and useful scripts
Tool to identify hash types
World's fastest and most advanced password recovery utility
Set of small utilities for advanced password cracking
Recursively compute hashsums or piecewise hashings
Identify the different types of hashes used to encrypt data
Security/hayabusa Windows EVTX / Sigma hunting (blue_host)
Viewer and editor in hexadecimal or ASCII for files or devices
> which sites it is registered on (OSINT)
Active Network Smashing Tool
Fast and multi-purpose HTTP toolkit
Very fast network logon cracker
Links to useful impacket scripts examples
Projectdiscovery OAST catcher (not in apt; go tool)
Tool for tunneling IPv4 data through a DNS server
Dex to Java decompiler
GUI Java .class decompiler
Active password cracking tool
JWT attacks
Next-generation crawling and spidering framework
Brute-force and enumerate Kerberos principals
Basic programs to authenticate using MIT Kerberos
Collection of injectable web files
OpenLDAP utilities
Dump Active Directory info over LDAP
Rich offline LDAP/AD enumeration
Semi-automated network penetration testing tool
Library and program to read and write meta information in multimedia…
Advanced, yet simple, tunneling/pivoting tool that uses a TUN interface
IOC + YARA scanner (NOT the apt 'loki' genetics pkg)
Remotely extract credentials from LSASS
Tracks runtime library calls in dynamically linked programs
Security auditing tool for Unix based systems
Utility for manipulating the MAC address of network interfaces
Recover files by looking for magic bytes
> accounts across sites (OSINT)
Open source intelligence and forensics application
High-performance word generator with a per-position configurable charset
TCP port scanner
Fast, parallel, modular, login brute-forcer for network services
Tool designed for extracting metadata of public documents
Framework for exploit development and vulnerability research
Uses admin rights on Windows to display passwords in plaintext
Pwning IPv4 via IPv6
SSL-capable man-in-the-middle HTTP proxy
MSFvenom Payload Creator (MSFPC)
Fast port scanner with a focus on reliability and simplicity
Id); binary `nth`
Scan networks searching for NetBIOS information
NMAP netcat reimplementation
High-speed network authentication cracking tool
TCP/IP swiss army knife
Active/passive network address scanner using ARP requests
Network Execution Tool
Linux network packet sniffer toolkit
PCAP > artifacts (blue_net)
Netflow capture daemon
Grep for network traffic
Web server security scanner
The Network Mapper
Fast and customizable vulnerability scanner based on simple YAML base…
Analyze MS OLE2 files and MS Office documents
Fast and simple SNMP scanner
Endpoint telemetry / live IR queries (blue_host)
Passive OS fingerprinting tool
Open Source AWS Exploitation Framework
Patched tools to use password hashes as authentication input
Multi-purpose brute-forcer
Modify properties of ELF executables
Payloads and bypass techniques for pentests
Parses PDF files to identify fundamental elements
Scans PDF files for certain PDF keywords
WinPEAS + linPEAS privesc enumeration
Shell handler (single script)
Offline WPS bruteforce tool
Super timeline all the things -- metapackage
Extracts the password policy from a Windows system
PowerShell is an automation and configuration management platform
PowerShell and Python post-exploitation agent
AWS/Azure/GCP security assessment
Redirect connections through socks/http proxies (proxychains-ng)
Help SSH and other protocols through HTTP(S) proxies
Pspy64 release asset
Tunnel TCP connections over ICMP packets
Gdb plugin; run its setup.sh after clone
Dev / CTF toolkit
Mimikatz implementation in pure Python
Python3 module to easily build and dissect network protocols
Free and advanced command line hexadecimal editor
Brute force attack tool against Wi-Fi Protected Setup PIN number
Web Reconnaissance framework written in Python
Arbitrary TCP connection redirector to a SOCKS or HTTPS proxy server
Perform forensic analysis of registry hives
LLMNR/NBT-NS/mDNS Poisoner
Reverse engineering framework and command-line toolset
Reverse engineering platform powered by rizin
Rootkit, backdoor, sniffer and exploit scanner
Azure AD exploration and recon (ROADtools)
ROP gadget finder
Wordlist mangling tool
Modern Port Scanner
Dump Windows 2k/NT/XP password hashes
Fast filesystem-independent file recovery
Multi-cloud security auditing
Collection of multiple types of security lists
Social-Engineer Toolkit
Precompiled .NET offensive tools to drop on targets
Find usernames across social networks
Fully automated, active web application security reconnaissance tool
Tools for forensics analysis on volume and filesystem data
Command-line SMB/CIFS clients for Unix
Handy SMB enumeration tool
Snaffler.exe release asset
SNMP service enumeration tool
Flexible Network Intrusion Detection System
Multipurpose relay for bidirectional data transfer
OSINT collection and reconnaissance tool
Automates spoofing or cloning Bluetooth devices
Automatic SQL injection tool
Transparent proxy server for VPN over SSH
SSLv3/TLS network protocol analyzer
Applicative protocol multiplexer
Tests SSL/TLS enabled services to discover supported cipher suites
Fast and full-featured SSL scanner
Frontend for Powershell Empire
System call tracer
Subdomain discovery tool
Next Generation Intrusion Detection and Prevention Tool
Command-line network traffic analyzer
TCP flow recorder
Tool to replay saved tcpdump files at arbitrary speeds
Terminal UI for tshark, inspired by Wireshark
Command line tool to check TLS/SSL ciphers, protocols and cryptograph…
Tool for gathering e-mail accounts and subdomain names from public so…
O365/Azure password spraying
Container/IaC/vuln scanner (vuln_assessor)
Searches through git repositories for secrets
Network traffic analyzer - console version
Tunnel UDP packets over a TCP connection
Efficient live-compressor for executables
Endpoint DFIR (blue_host)
Multi session handler
Memory forensics (blue_host role)
Identify and fingerprint Web Application Firewall products
Collection of webshells
Stealth tiny web shell
Web application bruteforcer
Next generation web scanner
Python script to automate wireless auditing using aircrack-ng tools
Various pentesting Windows binaries
Network traffic analyzer - graphical interface
Black box WordPress vulnerability scanner
Pattern matching swiss knife for malware researchers
Testing tool for finding vulnerabilities in web applications
Passive network traffic analyzer
No tools match that search.