diff --git a/site/index.html b/site/index.html index 5c22811..a3b771c 100644 --- a/site/index.html +++ b/site/index.html @@ -3,11 +3,11 @@ - KeeFetch - Favicon Fetcher for KeePass - + KeeFetch — Favicon Fetcher for KeePass + - + @@ -15,955 +15,976 @@ + +
- - - KeeFetch - Open source + + + KeeFetch + Open source -
-
+ + +
-

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 -
-
-
-
Presets4 modes
-
-
FastDirect site first, fewer resolver calls.
-
BalancedSpeed and coverage for daily vaults.
-
ThoroughChecks every enabled provider lane.
-
CustomManual order, toggles, and fallbacks.
-
+
+
+ KeePass 2.x plugin + .NET Framework 4.8 + MIT
-
-
Provider traceCSV ready
-
Direct site182 ms
-
Favicone417 ms
-
Icon Horse1.3 s
+

Kee.Fetch

+
Your vault has URLs. Give them faces.
+

A fast, smart favicon fetcher for KeePass. KeeFetch finds the best icon, ranks competing sources, avoids duplicate blobs, and gives you explicit control over third-party requests.

+
+ ↓ Download KeeFetch.plgx + See how it works
+ +
+
Direct firstParse site-declared icons before resolver fallbacks.
+
RankedSite canonical → strong resolver → synthetic fallback.
+
Bulk readySingle entries, whole groups, and database maintenance.
+
PrivateNo telemetry. Providers can be disabled individually.
+
-
-
- +
+
+ +
+
requestexample.comnormalized
+
directapple-touch-icon.pngaccepted
+
hashsha-256 content checkunique
+
storecustom icon → KeePassdone
+
+ +
+
01best surviving candidate
+
SHA-256content deduplication
+
0telemetry events
+
+
-
-
Features
+
+
+ 01 +

Useful, not noisy

+ Six things KeeFetch does well +
-
- +
+

Direct-site parsing

-

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

+

Reads favicon links, apple-touch icons, and manifest declarations directly from the target site before stronger fallback lanes compete.

-
- -

Apple-touch priority

-

Prefers high quality icons when sites expose proper mobile assets.

+
+ +

Availability-first ranking

+

Candidates are classified by trust tier so a placeholder-prone synthetic result cannot outrank a stronger real icon.

-
- -

Bulk group processing

-

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

+
+ +

Bulk processing

+

Run KeeFetch on a single entry, a whole group, or your database maintenance flow without turning the UI into a waiting room.

-
- +
+

Android URL mapping

-

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

+

Understands androidapp:// entries, maps packages to web domains, and can fall back through Play Store discovery.

-
- -

SHA-256 deduplication

-

Content-addressed storage prevents duplicate icons and saves space.

+
+ +

SHA-256 dedup

+

Icons are content-addressed before storage, preventing the same image from being inserted over and over across entries.

-
- -

Privacy toggles

-

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

+
+ +

Privacy controls

+

Disable third-party providers, synthetic fallbacks, or individual resolvers. KeeFetch has no telemetry or analytics.

-
-
Workflow
+
+
+ 02 +

URL in. Good icon out.

+ The pipeline, without the mystery +
-
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.

+
01

Read the entry

Resolve the URL, references, or Android package into a usable target.

+
02

Inspect the site

Look for declared favicons, touch icons, manifests, and strong direct candidates.

+
03

Race fallbacks

Enabled providers return structured candidates instead of blindly overwriting one another.

+
04

Rank + dedup

Trust tier and candidate quality decide the winner; SHA-256 prevents duplicate storage.

+
05

Apply

The selected icon is stored once and attached to the KeePass entry.

-
-
-
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 +

Remote lookups, on your terms

+ Clear defaults. Clear switches. +
+
+
+
◈ Privacy model
+

No telemetry. No analytics. No secret side-channel.

+

KeeFetch reads URL and title information locally. Direct Site contacts the target origin. When enabled fallback providers are needed, the target domain can be sent to those services to resolve an icon. Credentials, usernames, passwords, and full database contents are not sent.

+
+
Direct siteContacts the website you are already storing in the entry.
+
FallbacksCan receive the target domain only when those providers are enabled.
+
Your controlsDisable third-party or synthetic providers from KeeFetch 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 +

Install in three moves

+ No package manager required +
+
+
Step 01DownloadGrab KeeFetch.plgx from the latest GitHub release.
+ +
Step 02CopyPut it in KeePass/Plugins/ (portable) or the installed KeePass 2 Plugins folder.
+ +
Step 03RestartOpen KeePass again, then right-click an entry and choose KeeFetch.
+
+
+ +
+
+ 05 +

Open source means doors open

+ Bugs, edge cases, providers, docs +
+
+ GHGitHubRead the code, inspect releases, or follow the project. + ISIssuesFound a stubborn site or strange icon? Drop a reproducible case. + PRContributeTests, provider integrations, fixes, and documentation are welcome. +
+
+