{"id":13726869,"url":"https://github.com/nativefier/nativefier-icons","last_synced_at":"2025-05-07T22:30:43.511Z","repository":{"id":37058233,"uuid":"51153419","full_name":"nativefier/nativefier-icons","owner":"nativefier","description":"Server and Icon Repository for Nativefier","archived":true,"fork":false,"pushed_at":"2023-05-06T14:56:42.000Z","size":18736,"stargazers_count":194,"open_issues_count":39,"forks_count":93,"subscribers_count":9,"default_branch":"gh-pages","last_synced_at":"2024-11-14T17:47:40.282Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://nativefier.github.io/nativefier-icons","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nativefier.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-02-05T15:07:03.000Z","updated_at":"2024-11-02T10:23:06.000Z","dependencies_parsed_at":"2024-01-07T21:05:01.027Z","dependency_job_id":"59503926-1396-4b54-b80e-f62580a6b774","html_url":"https://github.com/nativefier/nativefier-icons","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nativefier%2Fnativefier-icons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nativefier%2Fnativefier-icons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nativefier%2Fnativefier-icons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nativefier%2Fnativefier-icons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nativefier","download_url":"https://codeload.github.com/nativefier/nativefier-icons/tar.gz/refs/heads/gh-pages","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252965100,"owners_count":21832822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T01:03:28.649Z","updated_at":"2025-05-07T22:30:38.498Z","avatar_url":"https://github.com/nativefier.png","language":"Shell","readme":"# Nativefier Icons\n\nIcon Repository for [Nativefier](https://github.com/nativefier/nativefier/).\n\nNativefier will look in this repository for high resolution icons before trying to automatically infer an icon from the target Url.\n\nThe [index](https://nativefier.github.io/nativefier-icons/) is automatically generated with [GitCloud](https://github.com/jiahaog/gitcloud) using Jekyll.\n\n## Contributing\n\nFeel free to submit a pull request for any `.ico`, `.icns` or `.png` icon!\n\n- `.ico` - For Windows\n- `.icns` - For macOS (Apple Icon Image format)\n- `.png` - For Linux\n\nIf the icons for the correct platforms are found here, the [optional dependencies](https://github.com/nativefier/nativefier/#optional-dependencies) for Nativefier might not be required to infer an icon for that particular target web page.\n\n### Naming Convention\n\nName the icon file to `${PRODUCT}.${EXT}`, just use the key identifier for the page.\n\nHowever, if the product name is generic enough, name it as `${COMPANY}-${PRODUCT}.${EXT}`, with `-` as the delimiter. The matching algorithm works by taking a score of the number of words matched in the file name with the target url. \n\nTake the example of naming Google Photos for the target url `https://photos.google.com/`. Using `photos.png` is too generic, and we want it to be specific to google. Thus, we will name the icon file `google-photos.png` for a `.png` file. \n\n### Step 1\n\nFirst prepare the image files, for the respective platform as stated above\n\nA helpful tool for converting the icons is [iconverticons.com](https://iconverticons.com/online/).\n\nCopy the images to `./files`.\n\n```\n$ ls -a ./files\n\ngoogle-photos.png\ngoogle-photos.ico\ngoogle-photos.icns\n```\n\n### Step 2\n\nAdd an entry for the file to `./_data/gitCloud.yml`, in alphabetical order\n\n```yml\n- name: google-photos\n  href: files/google-photos.png\n- name: google-photos\n  href: files/google-photos.ico\n- name: google-photos\n  href: files/google-photos.icns\n```\n\n### Step 3\n\nYou're done! Submit a pull request with the changes and I'll merge them in as soon as possible.\n\n## Helper Scripts\n\nThe main [`./addIcon`](addIcon) script is also provided which takes an input `.png` or `.svg` and does steps 1 and 2 automatically for you.\n \nThis script only runs on OSX with XCode installed as [iconutil](https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Optimizing/Optimizing.html) is required for conversion to a `.icns` file.\n\nOther helpful scripts are:\n\n- [`./bin/convertToIcns`](bin/convertToIcns) \n- [`./bin/convertToIco`](bin/convertToIco) (Supported on Linux)\n- [`./bin/convertToPng`](bin/convertToPng) (Supported on Linux)\n\nYou need the following dependencies:\n\n- [ImageMagick](http://www.imagemagick.org/script/index.php) with `convert` and `identify` in your `$PATH` (required for `.png` input)\n- [CairoSVG](https://cairosvg.org) (required for `.svg` input)\n- [iconutil](https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Optimizing/Optimizing.html): Xcode needs to be installed (required to generate `.icns`)\n\n## Work In Progress\n\n- [ ] CI tests for pull requests\n- [ ] Just use a `.png` or `.svg` and let CI convert the icons to the other formats\n\n## Credits\n\nSome logos are sourced and converted from the really awesome svg logo repository [gilbarbara/logos](https://github.com/gilbarbara/logos).\n\nAll logos appearing on the site are the property of their respective owners.\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnativefier%2Fnativefier-icons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnativefier%2Fnativefier-icons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnativefier%2Fnativefier-icons/lists"}