Ffind
Bestandstype detectie via libmagic plus ext/F2FS bestandssysteem extractie voor firmware
Werkt met setup
Wat het doet
Wikkelt de iothackbot `ffind` CLI om bestandstypen te identificeren via libmagic en optioneel ext2/3/4 of F2FS bestandssystemen te extraheren uit firmware-images, met tekst/JSON-uitvoer. Activeert wanneer de gebruiker een firmware-blob wil analyseren, bestandstypen in een directory wil identificeren, of ingebedde bestandssystemen wil extraheren. Type detectie werkt overal waar libmagic is geïnstalleerd; extractie is alleen voor Linux en vereist sudo plus e2fsprogs/f2fs-tools.
Testrapport
De repo gekloond en bin/ffind live uitgevoerd: --help kwam exact overeen met de gedocumenteerde flags, en in een testdirectory met 6 bestanden groepeerde het bestanden op MIME-type met tellingen en gaf gestructureerde JSON (total_files, detection_failures) uit. Baseline was `file`/`file --mime-type`: dezelfde onderliggende libmagic beschrijvingen maar een platte lijst per bestand, terwijl ffind recursieve directory-walk in één aanroep, MIME-groepering, JSON, en device.pem als application/x-pem-file categoriseerde versus baseline text/plain — een bescheiden verbetering, dus uitvoer ~6. Vereist python-magic+libmagic (fouten "python-magic not available" anders); de belangrijkste bestandssysteem-extractie (-e) is alleen voor Linux (losetup/mount) en ontestbaar op macOS. Gedocumenteerde bug waargenomen: SKILL.md beweert dat `-a` schakelt tussen alleen artefacten versus alle typen, maar de tekstformatter print altijd alle typen, dus de flag had geen effect. Oordeel setup omdat de tool niet is gebundeld in de skill-directory (vereist de hele repo op PATH) en extractie sudo+e2fsprogs op Linux nodig heeft.
Getest op: 2026-07-21 · Claude Code 2.x (agent harness)
Installatie
git clone --depth 1 https://github.com/BrownFineSecurity/iothackbot.git /tmp/ffind-src mkdir -p ~/.claude/skills cp -R /tmp/ffind-src/skills/ffind ~/.claude/skills/ffind # The SKILL.md invokes the `ffind` CLI, which is NOT inside the skill dir — it lives in the cloned repo. # Put it on PATH and install deps to actually run it: # export PATH="/tmp/ffind-src/bin:$PATH" # (bin/ffind adds tools/ to sys.path; keep the repo, don't delete /tmp/ffind-src) # pip install python-magic colorama # macOS: brew install libmagic | Debian/Ubuntu: apt-get install libmagic1 # Usage: ffind <path> [-a] [-v] [--format text|json|quiet] # Extraction (ffind <path> -e) is Linux-only: needs sudo + losetup/mount + e2fsprogs (ext) / f2fs-tools (F2FS). # Name collision: The Sleuth Kit also ships /usr/bin/ffind — check `ffind --help` shows --extract/--format, else call bin/ffind by full path.
Commando's en voorbeeldprompts
/ffindBestandstype detectie via libmagic plus ext/F2FS bestandssysteem extractie voor firmware
Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):
Identify file types inside this firmware dumpExtract the ext4 filesystem from this imageFind embedded F2FS partitions in this firmware file