How macho25/sps-jokes works
sps-jokes is a command-line tool for discovering SSH-accessible hosts and applying GNOME pranks over SSH, with additional reverse-shell deployment and SSH persistence commands. The main workflow is scan or load hosts, select a discovered target, choose and configure a prank, then execute it remotely. The graph separates host discovery, prank orchestration, SSH transport, and reverse-shell operations. README documentation is minimal; prank details are based on partial source excerpts, so uncertain internal wiring is omitted.
Main entry points: main.py Command interface · ssh_connection.py SSH transport · scanner.py SSH scanner · jokes.py Prank manager
Components 11
CLI workflow
- Command interface
main.py
Host discovery
- SSH scanner
scanner.py - Host mapping
scanner.py
Prank execution
- Prank manager
jokes.py - Prank implementations
pranks.py
Remote access
- SSH transport
ssh_connection.py - Reverse-shell manager
reverse_shell.py
Other components
- Operator
- Nmap
- SSH hosts
- Netcat
Connections 16
- Operator → Command interface: enters commands
- Command interface → SSH scanner: runs scan
- SSH scanner → Nmap: scans subnet
- SSH scanner → SSH hosts: queries hostname
- SSH scanner → Host mapping: loads or saves
- Command interface → Host mapping: lists hosts
- Command interface → Prank manager: selects target or prank
- Prank manager → Host mapping: resolves target
- Prank manager → Prank implementations: configures and runs
- Prank manager → SSH transport: executes remote commands
- Prank implementations → SSH transport: transfers files
- SSH transport → SSH hosts: executes commands or copies files
- Command interface → Reverse-shell manager: starts listener and deploys
- Reverse-shell manager → SSH transport: deploys or cleans up
- Reverse-shell manager → Netcat: checks or listens
- Command interface → SSH transport: enables persistence