You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Finish renaming the application prior to renaming the GitHub repository
Finally settled on the name `ficonic`, which kind of means that it's an
application related to ficons, where "ficon" is a smooshed form of
"favicon" and also a structure in that program that contains a favicon's
image and other data.
Utility for retrieving favicons and other site-related icons for a given URL
3
3
4
-
This utility currently only provides icons based on files stored in a site's root directory where those files exist. A site's `favicon.ico` file is retrieved, split into its constituent icon images, and each icon image is provided in both BMP and PNG formats. A site's `apple-touch-icon.png` file is also retrieved and stored. The resultant image files are stored in a user specified directory.
4
+
## Description
5
+
The purpose of _ficonic_ is to download all icons intended for use in identifying a site at a given URL. This allows the user to select the icon best suited for the medium through which they intend to identify the site.
5
6
6
-
If desired, the retrieved `favicon.ico` file from the last run of the application may be recovered from the system's temporary directory (currently assumed to be `/tmp`; that needs to be fixed...) until the directory is cleared by the system.
7
+
_ficonic_ downloads `favicon.ico` and `apple-touch-icon.png` files where found in the site's root directory and any icons identified in HTML `link` tags having recognized `rel` values. Any properly formatted `.ico`files are split into their contained icons and saved in as both `.bmp` and `.png` format files. Therefore, if a `.ico`file contains three different sized icons, for example, _ficonic_ will save six icons for the one file: three `.bmp` files and three `.png` files. An attempt is made to determine the actual format of an improperly formatted `.ico` file, e.g. where a `.png` file has simply been renamed `favicon.ico`; if successful, the icon is saved in that format with the proper extension.
7
8
8
-
Run `FaviconGofer -h` for usage information.
9
+
The downloaded icons are saved to a user-specified directory. While their contained icons are saved, `.ico` files themselves are not currently saved.
10
+
11
+
If desired, the retrieved `favicon.ico` file from the last run of the application may be recovered from the system's temporary directory (currently assumed to be `/tmp`) until the directory is cleared by the system.
12
+
13
+
Run `ficonic -h` for usage information.
9
14
10
15
## Dependencies
11
16
The following libraries are required:
@@ -15,4 +20,8 @@ The following libraries are required:
15
20
* Magick++ version 6 (C++ Bindings library for ImageMagick)
16
21
* htmlcxx
17
22
18
-
Note: Magick++ for GraphicsMagick _**may**_ work but has not been tested. If you should happen to test it, please post an Issue describing your experience so I can refer to the information here, giving you credit of course. _Thanks!_
23
+
## To Do
24
+
* Properly obtain the path to a system's temporary directory.
25
+
* Save `.ico` files along with icon files.
26
+
* Handle HTML `meta` tags referring to Microsoft tiles.
27
+
* Handle Progressive Web App manifests referring to icons.
0 commit comments