pyfav is simple, and simple to use

The easiest way to get started is to use the download_favicon function,

from pyfav import download_favicon

favicon_saved_at = download_favicon('https://www.python.org/')

You should now see the favicon in your /tmp directory. If you want to control where the favicon gets written to disk,

from pyfav import download_favicon
import os

os.mkdir('/tmp/favicon-downloads')

favicon_saved_at = download_favicon('https://www.python.org/', \
file_prefix='python.org-', target_dir='/tmp/favicon-downloads')

Get the location

If you’d prefer to only get the location of the favicon, use the get_favicon_url function,

from pyfav import download_favicon

favicon_url = get_favicon_url('https://www.python.org/')

Install

The easiest to get pyfav is through PIP

pip install pyfav

pyfav

A Python library that removes the annoyance of retrieving favicons

About

Favicons are the small icons that show up in a web browser's tab when you navigate to a page.

They can be annoying to programmatically retrieve because they’re commonly located in a handful of different places. pyfav is a Python library that removes the annoyance by handling the details for you – you supply a URL and pyfav will give you the favicon.

What's so great about a favicon?

Favicons are fascinating because of the tight constraint they enforce. They ask an organization to represent their identity in one 16 pixel by 16 pixel image.

This constraint surfaces things about the organization. Do they value their logo over a more abstract representation? Maybe the first letter of their organization's name is most important. What colors do they use to represent themselves? This scarcity of space can be revealing.

Source Code

Source code is available through a dual MIT/GPL license on GitHub.

Check it out

Install and read more about PyPI.

Explore other projects