README.md
# Exfavicon
A exfavicon to detect a site's favicon.
## Installation
If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:
1. Add exfavicon to your list of dependencies in `mix.exs`:
```elixir
def deps do
[{:exfavicon, "~> 0.2"}]
end
```
2. Ensure exfavicon is started before your application:
```elixir
def application do
[applications: [:exfavicon]]
end
```
## Usage
```elixir
# Find http://elixir-lang.org
Exfavicon.find("http://elixir-lang.org") # "http://elixir-lang.org/favicon.ico"
# Find http://twitter.com
Exfavicon.find("http://twitter.com") # "http://abs.twimg.com/favicons/favicon.ico"
# Find http://facebook.com
Exfavicon.find("http://facebook.com") # "https://static.xx.fbcdn.net/rsrc.php/yV/r/hzMapiNYYpW.ico"
# Find http://youtube.com
Exfavicon.find("http://youtube.com") # "https://s.ytimg.com/yts/img/favicon-vflz7uhzw.ico"
```