Skip to content

Your friendly digital detective, sniffing out hidden cryptocurrency wallet files.

License

Notifications You must be signed in to change notification settings

willibrandon/snif

Repository files navigation

🐕‍🦺 Snif: On the Trail of Your Hidden Wallets

Snif is your friendly digital detective, sniffing out cryptocurrency wallet files on your system with precision and care. Using advanced heuristics, magic bytes, and context-aware pattern matching, Snif helps you track down those elusive wallet files.

🦴 Key Features

  • Expert Nose: Identifies wallet files through known signatures (xpub, xprv, wallet.dat, etc.)
  • Thorough Search: Digs through directories while respecting your exclusion rules
  • Trust Rating: Confidence scoring ensures you only get reliable leads
  • Flexible Reports: Get results in CSV, JSON, or text format

🐾 Quick Start

# Install from crates.io
cargo install snif

# Or install from source
git clone https://github.com/willibrandon/snif.git
cd snif
cargo install --path .

# Basic search in current directory
snif

# More detailed search with options
snif --path ~/Documents \
     --exclude .git \
     --exclude-pattern "*.mp4" \
     --min-confidence 60 \
     --verbose

🦮 Usage Guide

Let Snif help you track down those wallet files:

Command What it Does
--path <DIR> Where should Snif start hunting? (default: current)
--exclude <DIR> Skip these directories (repeatable)
--exclude-pattern <GLOB> Skip files matching this pattern (repeatable)
--max-size-mb <MB> Don't sniff files larger than this (default: 200MB)
--follow-symlinks Follow symbolic links (careful with this one!)
--min-confidence <0-100> Only report finds with this confidence or higher
--threads <N> Use this many threads for the search
--output <FORMAT> Choose output style: text, json, or csv
--output-file <FILE> Save results to a file instead of showing them
--verbose Show extra sniffing details

For more detailed instructions:

snif --help

🦺 Security & Privacy

Your system, your data! Snif is a well-behaved pup:

  • Only reads minimal file data needed for detection
  • Never modifies any files
  • Respects file permissions and access controls
  • Open source - you can verify everything it does

🐕 Contributing

Want to help make Snif an even better detective? Check out our Contributing Guide!

📜 License

MIT License - See LICENSE for details.


Because every .dat deserves to be found. 🐾