tools

Local Tool Management

Manage local enrichment capabilities on your device. Detect available tools like FFmpeg and ExifTool, configure their settings, test them, and run them against your files to extract metadata.

Why Local Tools?

Cloud providers like S3 don't analyze your files. Local tools let you extract rich metadata (video duration, dimensions, hashes) from any cloud storage.

Subcommands

tools list List available tools and status

Display all available tools on this device.

filefortress tools list

tools detect Auto-detect available tools

Scan your system for available tools.

filefortress tools detect

filefortress tools detect --force

tools configure Configure tool settings

Configure tool paths, enable/disable tools, and set preferences.

filefortress tools configure ffmpeg --path "C:\ffmpeg\bin\ffprobe.exe"

filefortress tools configure ffmpeg --enable

filefortress tools configure --hash-algorithms "SHA256,MD5"

tools test Test a tool

Verify that a tool works correctly.

filefortress tools test ffmpeg

filefortress tools test --all

filefortress tools test ffmpeg --file "video.mp4"

tools run MAIN COMMAND Run tools against files

Download files from remotes and process them with local tools to extract metadata.

filefortress tools run [options]

--remote

Filter by remote

--media-type

Filter by media type

--tools, -t

Specific tools to use

--dry-run

Preview without downloading

Cost Warning: Downloading from paid providers (S3, BackBlaze) incurs egress costs. Use --dry-run first.

Available Tools

FileHasher

Built-in

MD5, SHA1, SHA256, SHA384, SHA512 hashes for all files

BasicImageInfo

Built-in

Image width and height for JPEG, PNG, GIF, BMP, WebP, TIFF

MimeTypeDetector

Built-in

MIME type detection via magic numbers for all files

FFmpeg

External

Duration, dimensions, codec, bitrate for MP4, MKV, AVI, MOV, MP3, FLAC, WAV

ExifTool

External

EXIF, IPTC, XMP, camera settings, GPS for JPEG, PNG, TIFF, RAW, PDF

Common Use Cases

Get video duration from S3 files:

filefortress tools run --remote "My S3" --media-type video --tools FFmpeg

S3 doesn't provide duration - FFmpeg extracts it locally.

Calculate hashes for duplicate detection:

filefortress tools run --tools FileHasher

Process local storage (no download needed):

filefortress tools run --remote-type Local

Local files are processed directly - fast and free!

Preview before processing:

filefortress tools run --dry-run --remote "My S3"

Best Practices

Run tools detect after installing new tools

Use --dry-run before processing large batches

Start with --remote-type Local for free processing

Use --media-type to target specific files

Related Commands

remotes enrich

Get metadata from cloud APIs (no download)

search

Search using extracted metadata

find

Advanced queries with metadata filters

In-Depth Guide

For a comprehensive guide on local tools including setup instructions, cost considerations, and practical examples, see the Local Tools Guide.