Swiftpack.co -  will-lumley/FaviconFinder as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
will-lumley/FaviconFinder
A small swift library for iOS & macOS to detect favicons used by a website.
.package(url: "https://github.com/will-lumley/FaviconFinder.git", from: "3.2.0")

FaviconFinder: Simple Favicon Finding

FaviconFinder

CI Status Version Carthage Compatible SPM Compatible Swift 5.0 Platform License Twitter

FaviconFinder is a small, pure Swift library designed for iOS and macOS applications that allows you to detect favicons used by a website.

Why not just download the file that exists at https://site.com/favicon.ico? There are multiple places that a developer can place there favicon, not just at the root directory with the specific filename of favicon.ico. The favicons address may be linked within the HTML header tags, or it may be within a web application manifest JSON file, or it could even be a file with a custom filename.

FaviconFinder handles the dirty work for you and iterates through the numerous locations that the favicon could be located at, and simply delivers the image to you in a closure, once the image is found.

FaviconFinder will:

  • ☑ Detect the favicon in the root directory of the URL provided
  • ☑ Automatically check if the favicon is located within the root URL if the subdomain failed (Will check https://site.com/favicon.ico if https://subdomain.site.com/favicon.ico fails)
  • ☑ Detect and parse the HTML at the URL for the declaration of the favicon
  • ☑ Resolve the favicon URL for you, even if it's a relative URL to the subdomain that you're querying
  • ☑ Allow you to prioritise which format of favicon you would like served
  • ☑ Detect and parse web application manifest JSON files for favicon locations

To do:

  • ☐ Detect and parse web application Microsoft browser configuration XML

Usage

FaviconFinder uses simple syntax to allow you to easily download the favicon you need, and get on with your project. Just insert this code into your project:

FaviconFinder(url: url).downloadFavicon { result in
    switch result {
    case .success(let favicon):
        print("URL of Favicon: \(favicon.url)")
        DispatchQueue.main.async {
            self.imageView.image = favicon.image
        }

    case .failure(let error):
        print("Error: \(error)")
    }
}

Advanced Usage

However if you're the type to want to have some fine-tuned control over what sort of favicon's we're after, you can do so.

FaviconFinder allows you to specify which download type you'd prefer (HTML, actual file, or web application manifest file), and then allows you to specify which favicon type you'd prefer for each download type.

For example, you can specify that you'd prefer a HTML tag favicon, with the type of appleTouchIcon. FaviconFinder will then search through the HTML favicon tags for the appleTouchIcon type. If it cannot find the appleTouchIcon type, it will search for the other HTML favicon tag types.

If the URL does not have a HTML tag that specifies the favicon, FaviconFinder will default to other download types, and will search the URL for each favicon download type until it finds one, or it'll return an error.

Just like how you can specify which HTML favicon tag you'd prefer, you can set which filename you'd prefer when search for actual files.

Similarly, you can specify which JSON key you'd prefer when iterating through the web application manifest file.

For the .ico download type, you can request FaviconFinder searchs for a filename of your choosing.

Here's how you'd make that request:

    FaviconFinder(
        url: url, 
        preferredType: .html, 
        preferences: [
            .html: FaviconType.appleTouchIcon.rawValue,
            .ico: "favicon.ico",
            .webApplicationManifestFile: FaviconType.launcherIcon4x.rawValue
        ],
        logEnabled: true
    ).downloadFavicon { result in
        switch result {
        case .success(let favicon):
            print("URL of Favicon: \(favicon.url)")
            DispatchQueue.main.async {
                self.imageView.image = favicon.image
            }

        case .failure(let error):
            print("Error: \(error)")
        }
    }

This allows you to control:

  • What type of download type FaviconFinder will use first
  • When iterating through each download type, what sub-type to look for. For the HTML download type, this allows you to prioritise different "rel" types. For the file.ico type, this allows you to choose the filename.

If your desired download type doesn't exist for your URL (ie. you requested the favicon that exists as a file but there's no file), FaviconFinder will automatically try all other methods of favicon storage for you.

Example Project

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

FaviconFinder supports iOS 10.0 and above & macOS 10.10 and above.

Installation

Cocoapods

FaviconFinder is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'FaviconFinder', '3.2.0'

Carthage

FaviconFinder is also available through Carthage. To install it, simply add the following line to your Cartfile:

github "will-lumley/FaviconFinder" == 3.2.0

Swift Package Manager

FaviconFinder is also available through Swift Package Manager. To install it, simply add the dependency to your Package.Swift file:

...
dependencies: [
    .package(url: "https://github.com/will-lumley/FaviconFinder.git", from: "3.2.0"),
],
targets: [
    .target( name: "YourTarget", dependencies: ["FaviconFinder"]),
]
...

Author

William Lumley, will@lumley.io

License

FaviconFinder is available under the MIT license. See the LICENSE file for more info.

GitHub

link
Stars: 15
Last commit: 1 week ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Dependencies

Release Notes

3.2.0
2 weeks ago

Added support for web application manifest file favicons

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics