Ffind - Advanced File Finder

VerifiedCaution

Tool that analyzes files and directories, identifies file types, and extracts embedded filesystems like ext2/3/4 and F2FS. Useful for firmware analysis and IoT device security assessments. It can output results in text or JSON format.

Sby Skills Guide Bot
SecurityIntermediate
406/2/2026
Claude Code
#file-finder#type-detection#filesystem-extraction#firmware-analysis

Recommended for

Our review

Analyzes and extracts file types and filesystems (ext2/3/4, F2FS) from firmware images.

Strengths

  • Automatically detects file types relevant to security analysis
  • Can extract embedded filesystems for further examination
  • Supports multiple output formats (text, JSON, minimal)

Limitations

  • Requires root/sudo privileges for extraction
  • Depends on external tools (e2fsprogs, f2fs-tools)
  • Only supports ext2/3/4 and F2FS filesystems
When to use it

Use Ffind when analyzing firmware or IoT device images to identify file types and extract filesystems for deeper security analysis.

When not to use it

Do not use it if you don't need firmware analysis or filesystem extraction, or if you lack the necessary privileges.

Security analysis

Caution
Quality score85/100

The ffind tool is a legitimate file analysis utility, but its extraction feature needs root privileges. While the skill does not instruct any destructive or exfiltrating actions, the elevation to root warrants a caution rating.

Findings
  • Requires sudo privileges for filesystem extraction, which could be dangerous if misused or applied to maliciously crafted firmware containing known exploits against extraction tools.

Examples

Analyze firmware file types
Analyze the file types in /path/to/firmware.bin using ffind and show all types.
Extract filesystems from firmware
Extract any ext2/3/4 or F2FS filesystems from the firmware image at /path/to/firmware.bin and place them in /tmp/extracted.
Find security artifacts in multiple files
Analyze /path/to/file1.bin and /path/to/file2.bin for artifact file types relevant to security analysis.

name: Ffind description: Advanced file finder with type detection and filesystem extraction for analyzing firmware and extracting embedded filesystems. Use when you need to analyze firmware files, identify file types, or extract ext2/3/4 or F2FS filesystems.

Ffind - Advanced File Finder with Extraction

You are helping the user find and analyze files with advanced type detection and optional filesystem extraction capabilities using the ffind tool.

Tool Overview

Ffind analyzes files and directories, identifies file types, and can extract filesystems (ext2/3/4, F2FS) for deeper analysis. It's designed for firmware and IoT device analysis.

Instructions

When the user asks to analyze files, find specific file types, or extract filesystems:

  1. Understand the target:

    • Ask what path(s) they want to analyze
    • Determine if they want to extract filesystems or just analyze
    • Ask if they want all file types or just artifact types
  2. Execute the analysis:

    • Use the ffind command from the iothackbot bin directory
    • Basic usage: ffind <path> [<path2> ...]
    • To extract filesystems: ffind <path> -e
    • Custom extraction directory: ffind <path> -e -d /path/to/output
    • Show all file types: ffind <path> -a
    • Verbose output: ffind <path> -v
  3. Output formats:

    • --format text (default): Human-readable colored output with type summaries
    • --format json: Machine-readable JSON
    • --format quiet: Minimal output
  4. Extraction capabilities:

    • Supports ext2/ext3/ext4 filesystems (requires e2fsprogs)
    • Supports F2FS filesystems (requires f2fs-tools)
    • Requires sudo privileges for extraction
    • Default extraction location: /tmp/ffind_<timestamp>

Examples

Analyze a firmware file to see file types:

ffind /path/to/firmware.bin

Extract all filesystems from a firmware image:

sudo ffind /path/to/firmware.bin -e

Analyze multiple files and show all types:

ffind /path/to/file1.bin /path/to/file2.bin -a

Extract to a custom directory:

sudo ffind /path/to/firmware.bin -e -d /tmp/my-extraction

Important Notes

  • Extraction requires root/sudo privileges
  • Requires external tools: e2fsprogs, f2fs-tools, util-linux
  • Identifies "artifact" file types relevant to security analysis by default
  • Use -a flag to see all file types including common formats
Related skills