diff --git a/site/index.html b/site/index.html index 5c22811..ad10fad 100644 --- a/site/index.html +++ b/site/index.html @@ -3,11 +3,11 @@ - KeeFetch - Favicon Fetcher for KeePass - + KeeFetch — Give every login a face + - + @@ -15,957 +15,427 @@ + + + +
- - - KeeFetch - Open source + + + KeeFetch -
-
-
+
+
-

KeeFetch

-
Fetch. Resolve. Store. No noise.
-
-

Automatic favicon discovery for KeePass. Direct-site parsing, ranked fallbacks, privacy-first controls, and SHA-256 deduplication.

-
- Privacy first - Local controls - Bulk ready - SHA-256 dedup +
KeePass 2.x · open source · favicon retrieval
+

Give every login a face.

+

KeeFetch hunts down the strongest favicon it can find, ranks competing candidates, removes duplicates, and stores the winner in your KeePass database.

+
+ Download latest ↘ + Watch the fetch + No account. No dashboard. Just a KeePass plugin doing the annoying icon work.
-
-
-
Presets4 modes
-
-
FastDirect site first, fewer resolver calls.
-
BalancedSpeed and coverage for daily vaults.
-
ThoroughChecks every enabled provider lane.
-
CustomManual order, toggles, and fallbacks.
-
-
-
-
Provider traceCSV ready
-
Direct site182 ms
-
Favicone417 ms
-
Icon Horse1.3 s
-
+
+
Direct firstSite-backed candidates compete before fallbacks
+
Ranked fallbacksResolver candidates are compared by trust tier
+
SHA-256 dedupeRepeated icon payloads do not multiply in your vault
-
-
- +
+
Resolver field / live specimen view
+ +
KeeFetch iconbest candidate → vault
+
S
+
A
+
M
+
R
+
V
+
F
+
+
candidate queuerank →
+
site
A
+
resolver
B
+
synthetic
C
- -
-
-
Features
-
-
- -

Direct-site parsing

-

Reads the target website first. No third-party resolver wins by default.

-
-
- -

Apple-touch priority

-

Prefers high quality icons when sites expose proper mobile assets.

-
-
- -

Bulk group processing

-

Fetch icons for full groups. Concurrent, cancellable, and resumable.

-
-
- -

Android URL mapping

-

Maps packages to web domains, then fetches native-looking icons.

-
-
- -

SHA-256 deduplication

-

Content-addressed storage prevents duplicate icons and saves space.

-
-
- -

Privacy toggles

-

Disable third-party lookups or synthetic fallbacks. You control remote requests.

-
+ + +
+
01
+

The retrieval machine

+

From messy URL to useful icon.

+

One click starts a small investigation. KeeFetch collects evidence, lets candidates compete, then keeps the strongest surviving result.

+ +
+
+ + + + + +
+
+
+
Stage 01 / Normalize

Make the entry fetchable.

KeeFetch handles schemes, KeePass references, and Android-style URLs before it starts asking the web for icon candidates.

+
entry:// raw target
↗
+
+
+
Stage 02 / Discover

Collect before choosing.

Direct site icons, Apple touch icons, manifest entries, and resolver candidates can all enter the same competition.

+
S
A
M
R
★
+
+
+
Stage 03 / Rank

Trust beats convenience.

The availability-first selector ranks candidates by trust tier so a placeholder-prone fallback cannot casually beat stronger site-backed evidence.

+
A
Site canonicalstrongest tier
B
Strong resolvercompetitive fallback
C
Synthetic fallbacklast resort
+
+
+
Stage 04 / Dedupe

No icon clone army.

SHA-256 hashing keeps repeated payloads from multiplying as separate custom icons inside the database.

+
payload fingerprint matrix
K
F
K
P
A
F
S
R
sha256 → compare existing → reuse where identical → store only what is needed
+
+
+
Stage 05 / Store

Winner gets the square.

The selected icon lands back in KeePass — one entry, a group, or a broader maintenance pass depending on what you asked KeeFetch to process.

+
KeePass / custom icon assigned ✓
+
+
-
-
Workflow
-
-
1

Entry URL detected

From URL field, references, or Android package.

-
2

Parse target site

Extract favicon links, manifest data, and icon declarations.

-
3

Download icon

Compare direct candidates with configured providers.

-
4

SHA-256 check

Deduplicate and store efficiently in the database.

-
5

Cache and apply

Store once, reuse everywhere, keep scans fast.

+
+
02
+

Availability-first selector

+

The first answer is not always the best answer.

+
+

Instead of treating every provider equally, KeeFetch lets candidates survive discovery and then compares them with explicit trust tiers.

Strong evidence moves forward.
Placeholders move back.
+
+ +
Tier ASite-backedCanonical / direct evidence from the target site
+
Tier BResolverStrong third-party resolver candidate
+
Tier CSyntheticFallback only when stronger evidence does not survive
+
-
-
-
Architecture and fallback chain
-
-
1. Direct site/favicon.ico
/apple-touch-icon
manifest.json
-
2. Twenty IconsStrong resolver
coverage fallback
-
3. Search servicesDuckDuckGo
Google
Yandex
-
4. Synthetic APIsFavicone
Icon Horse
-
5. No iconUse default placeholder only when needed
+
+
03
+

Privacy is a setting, not fine print

+

You decide how far KeeFetch may look.

+

Third-party favicon services improve availability, but they can receive domains from entries. KeeFetch discloses that tradeoff and lets you narrow the resolver surface.

+
+

More reach, or less exposure.

The default configuration keeps the availability-first resolver chain enabled. You can disable third-party providers, synthetic fallbacks, or individual resolvers from KeeFetch settings.

Tools → KeeFetch → Settings…
First-run disclosure included.
+
+
resolver policy / illustrative control surfacelocal settings
+
Direct site fetching

Look at the target site for canonical icon evidence.

+
Third-party resolvers

Use configured fallback services when direct discovery is insufficient.

+
Synthetic fallbacks

Permit lowest-tier candidates when stronger sources do not survive.

+
Provider-by-provider control

Disable individual resolver services from plugin settings.

-
All lookups respect your privacy settings. No telemetry. No analytics.
-
+
+
-
-
Contribute and community
- - GHGitHub
Source code, releases, issuesgithub.com/tzii/KeeFetch - - - ISIssues
Report bugs and edge casesopen - - - PRContribute
Tests, providers, docspull requests welcome - -
-
+
+
04
+

Three-step install

+

Drop it in. Restart. Fetch.

+
+
1
↓

Download the PLGX.

Grab KeeFetch.plgx from the latest GitHub release.

Latest release ↗
+
2
□

Move it to Plugins.

Place the plugin inside your KeePass 2.x Plugins directory.

Portable: KeePass/Plugins/
Installed: %ProgramFiles%/KeePass Password Safe 2/Plugins/
+
3
↻

Restart KeePass.

Then right-click an entry and choose KeeFetch — Download Favicons, or use the Tools menu for broader maintenance.

+
+
+ +
+
KeeFetch

Your vault has enough grey squares.

Give KeePass entries recognizable icons without babysitting favicon URLs one by one.

Get KeeFetch ↘Explore source ↗
+
-
- KeeFetch - MIT License - built by the community - Simple. Powerful. Respects your data. -
+ +