Metadata-Version: 2.1
Name: favihunter
Version: 1.3.2
Summary: Discover and monitor internet assets using favicon hashes across search engines.
Home-page: https://github.com/eremit4/favihunter
License: MIT
Author: eremit4
Author-email: eremit4@protonmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: PyYAML (==6.0.2)
Requires-Dist: colorama (==0.4.6)
Requires-Dist: favicon (==0.7.0)
Requires-Dist: mmh3 (==4.0.1)
Requires-Dist: pillow (==10.4.0)
Requires-Dist: requests (>=2.32.4,<2.33.0)
Project-URL: Repository, https://github.com/eremit4/favihunter
Description-Content-Type: text/markdown

# Favihunter

> Favicons are tiny icons used by modern web applications. When combined with search engines, they’re great pivots for discovering related internet assets.

This tool helps security practitioners find assets using favicon hashes across multiple search engines:

- [Censys](https://search.censys.io/)
- [Criminal IP](https://www.criminalip.io/) 
- [FOFA](https://en.fofa.info/)
- [Hunter-How](https://hunter.how/)
- [Netlas](https://app.netlas.io)
- [Odin](https://search.odin.io/)
- [Shodan](https://www.shodan.io) 
- [Silent Push](https://explore.silentpush.com) 
- [Validin](https://app.validin.com)
- [VirusTotal](https://virustotal.com)
- [Zoomeye](https://www.zoomeye.ai)

## 🛠️ Installation

### Option A — PyPI (standard)

```bash
pip install favihunter
```

### Option B — pipx (isolated CLI install) — **recommended for command-line tools**

```bash
# install pipx if you don’t have it
python3 -m pip install --user pipx
python3 -m pipx ensurepath  # then restart your shell

# install favihunter
pipx install favihunter

# upgrade later
pipx upgrade favihunter

# run without installing (one-shot)
pipx run favihunter --help
```

### Option C — From source (Poetry)

```bash
git clone https://github.com/eremit4/favihunter.git
cd favihunter
poetry install
```

> Using a virtual environment is recommended to avoid dependency conflicts.

## ⚡ Quickstart

```bash
favihunter --url https://python.org
```

Favihunter downloads the favicon, computes hashes (MMH3, MD5, SHA256, and optional perceptual hash), and prints ready-to-click search URLs.

## 🕵️‍♂️ Usage

```bash
favihunter --help
```

Analyze a single URL:

```bash
favihunter --url <url>
```
![](logo/favihunter.gif)

Analyze a file with URLs (one per line):

```bash
favihunter --urls <file>
```

Analyze a local favicon file:

```bash
favihunter --favicon <path/to/favicon.ico>
```

Clean the temp folder:

```bash
favihunter --remove
```

VirusTotal pivot:

```bash
favihunter --url <url> --virus-total
```
![](logo/favihunter_vt.gif)


> ## ✅ Requirements

* Python **3.8+**
* Linux/macOS (Windows is likely fine via PowerShell; please open an issue if you hit problems)

## 🧹 Uninstall / Upgrade

**pip**

```bash
pip install --upgrade favihunter
pip uninstall favihunter
```

**pipx**

```bash
pipx upgrade favihunter
pipx uninstall favihunter
```



