Skip to main content

Tracker Icons

Cached icons live in your data directory under tracker-icons/ (next to qui.db). Icons are stored as 16×16 PNGs; anything larger than 1024×1024 is rejected.

qui automatically downloads a favicon the first time it encounters a tracker host and caches it for future sessions. Failed downloads are retried automatically.

Set trackerIconsFetchEnabled = false in config.toml (or QUI__TRACKER_ICONS_FETCH_ENABLED=false) to disable these network fetches.

Add Icons Manually​

Copy PNGs named after each tracker host (e.g. tracker.example.com.png) into the tracker-icons/ directory. Files are served as-is, so trimming or resizing is up to you, but matching the built-in size (16×16) keeps them crisp and avoids extra scaling.

Preload a Bundle of Icons​

If you have a library of icons, preload them via a mapping file: tracker-icons/preload.json (also accepts .js variants).

Format​

The file can be either a plain JSON object or a snippet exported as const trackerIcons = { ... };.

  • Keys must be the real tracker hostnames (e.g. tracker.example.org)
  • If you include a www.* host, qui automatically mirrors the icon to the bare hostname when missing
  • On startup qui decodes each data URL, normalises the image to 16×16, and writes the PNG to <host>.png

JSON Example​

{
  "tracker.example.org": "data:image/png;base64,AAA...",
  "www.tracker.org": "data:image/png;base64,BBB..."
}

JavaScript Example​

const trackerIcons = {
  "tracker.example.org": "data:image/png;base64,CCC...",
  "www.tracker.org": "data:image/png;base64,DDD..."
};

Community Resources​

See Audionut/add-trackers for an example icon bundle.