Skip to content

keeweb/favicon-cdn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KeeWeb Favicon CDN ☁️


Used in combination with the KeeWeb Favicon Service to store favicons for various websites.


Last Commit Size All Contributors






About

The KeeWeb Favicon Service allows users of KeeWeb to download favicons for the websites within their vault.

This repo serves as a content delivery network to override certain website favicons that are either difficult to see, or may implement measures which disallow grabbing the favicon from their website.


Icons can be fetched from the KeeWeb favicon service with the following syntax:

https://services.keeweb.info/favicon/{DOMAIN}/{ICON_SIZE}

A working example using the above syntax:

https://services.keeweb.info/favicon/reddit.com/64



Contributing

If you have attempted to grab an icon within KeeWeb for a certain website that is either difficult to see, or will not properly capture; you may submit an override icon to this repo. However, ensure the following:


  • Submissions MUST be a proper .ico icon
  • Icons must include the following sizes:
    • 64 x 64
    • 48 x 48
    • 32 x 32
    • 24 x 24
    • 20 x 20
    • 16 x 16
  • All sizes need to be combined into a single .ico file
  • Each icon should not exceed 80kb
  • Icon should be placed in a parent folder which starts with the first letter of the service
    • Ex: /r/reddit.com.ico for Reddit
    • If you are providing a favicon for a subdomain, the folder name should start with the first letter of the subdomain, not the base domain.
      • Ex: /f/forum.libriv.ox.org.ico
    • Domains with dashes should be labeled with the same character.
      • Ex: /r/random-website.com.ico
    • Anything after the TLD (top-level domain : .com, .org, .net, etc.) is ignored.

If you need an easy solution for converting icons to .ico with the proper sizes, you can install:





Self-Hosted Ports

This repo supports fetching icons for locally hosted web-apps. However, keep in mind that some applications conflict and may share the same port.

In order to fetch the icon, you will need to change conflicting web-app ports to the same port specified below:

App Default Port Repo Port
Duplicacy 3875 3875
Duplicati 8200 8200
FileBrowser 22534 22534
Gitea 3000 3000
Gogs 3000 3002
Jackett 9117 9117
Linkwarden 3000 3003
Netdata 19999 19999
OpenGist 6157 6157
Portainer 9443 9443
Prowlarr 9696 9696
qBittorrent 8081 8081
ShellInABox 4200 4200
Sonarr 8989 8989
Swizzin 8333 8333
Syncthing 8384 8384
TheLounge 9000 9000
Uptime Kuma 3001 3001
Webmin 10000 10000



Takedown Requests

If you are the representative for a company who wishes to not have your companies' icon hosted within this repository; you may send us a request to remove the favicon by contacting us at keeweb[at]keeweb.info




Trademark Disclaimer

All trademarks, logos and brand names are the property of their respective owners. All company, product and service names used in this repository are for identification purposes only. Use of these names, trademarks and brands does not imply endorsement.




Contributors ✨

We are always looking for contributors. If you feel that you can provide something useful to KeeWeb, then we'd love to review your suggestion. Before submitting your contribution, ensure you read the policy in the section Contributing.


The following people have helped get this project going:




About

A repository for storing favicons utilized with the KeeWeb favicon service worker.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published