iconsur

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [
    "node",
    "python@3.14"
  ],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "macOS Big Sur Adaptive Icon Generator",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:38:46+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "iconsur",
  "github_default_branch": "main",
  "github_last_commit_at": "2023-08-03T06:07:49Z",
  "github_readme_excerpt": "\u003cspan align=\"center\"\u003e\n  \n# IconSur: macOS Big Sur Adaptive Icon Generator\n\n\u003ca href=\"https://www.npmjs.com/package/iconsur\"\u003e\u003cimg title=\"npm version\" src=\"https://badgen.net/npm/v/iconsur\" \u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/iconsur\"\u003e\u003cimg title=\"npm downloads\" src=\"https://badgen.net/npm/dt/iconsur\" \u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/rikumi/iconsur/commit\"\u003e\u003cimg title=\"github commits\" src=\"https://badgen.net/github/last-commit/rikumi/iconsur\" \u003e\u003c/a\u003e\n\n\u003c/p\u003e\n\n\u003c/span\u003e\n\n`iconsur` is a command line tool to easily generate macOS Big Sur styled adaptive icons for third-party apps.\n\nThe generation is based on the most related iOS app from the App Store, or, if there isn\u0027t one, is created from the original icon, in which case the background color and the scaling can be customized.\n\n![image](https://user-images.githubusercontent.com/5051300/85926574-ebfb9d80-b8d2-11ea-836b-28e38d1f3447.png)\n\n## Installation\nInstall it easily:\n\n### Using homebrew\n``` shell\nbrew install iconsur\n```\n\n### Using npm\n``` shell\nnpm install -g iconsur\n```\n## Usage\n\nDownload the `iconsur` binary for macOS x64 from [Releases](https://github.com/rikumi/iconsur/releases), `chmod +x` and include it in your PATH.\n\nStart generating your first adaptive app icon:\n\n```sh\nsudo iconsur set /Applications/Microsoft\\ Word.app/\n\n# Update the system icon cache and reload Finder \u0026 Dock\nsudo iconsur cache\n\n# Then the new icon will appear, and will last until the App is updated next time.\n```\n\nThis will search for the App Store and use the most related iOS app. For apps from the Mac App Store, `sudo` is required to set the alternative icon.\n\nBy default, the name for the macOS app is used to search for a corresponding iOS app. You can change the keyword by specifying `-k`/`--keyword`.\n\nIf your app only has a corresponding iOS app in non-America store, you may like to specify the 2-letter country code with option `-r`/`--region`.\n\n```sh\nsudo iconsur set /Applications/QQMusic.app/ -r cn\nsudo iconsur cache\n```\n\nFor apps ",
  "github_repo": "rikumi/iconsur",
  "github_stars": 706,
  "github_topics": [],
  "homepage": "https://github.com/rikumi/iconsur",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 32,
  "installs_365d": 544,
  "installs_90d": 99,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "MIT",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "iconsur",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 5686,
  "rank_365d": 4939,
  "rank_90d": 5595,
  "raw_hash": "6ec56b4f4ec24123",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/i/iconsur.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": null,
  "version_stable": "1.7.0",
  "versioned_formulae": [],
  "why_use_this": null
}