{"id":13479505,"url":"https://github.com/tale/iconset","last_synced_at":"2025-05-07T08:44:25.310Z","repository":{"id":89667525,"uuid":"378528524","full_name":"tale/iconset","owner":"tale","description":"A nifty command-line tool to customize macOS icons","archived":false,"fork":false,"pushed_at":"2023-02-27T19:10:33.000Z","size":58,"stargazers_count":46,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-31T08:21:16.528Z","etag":null,"topics":["command-line-tool","macos","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tale.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2021-06-20T00:26:38.000Z","updated_at":"2025-02-16T15:26:34.000Z","dependencies_parsed_at":"2024-01-14T09:00:45.330Z","dependency_job_id":null,"html_url":"https://github.com/tale/iconset","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tale%2Ficonset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tale%2Ficonset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tale%2Ficonset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tale%2Ficonset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tale","download_url":"https://codeload.github.com/tale/iconset/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252846146,"owners_count":21813384,"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":["command-line-tool","macos","swift"],"created_at":"2024-07-31T16:02:17.848Z","updated_at":"2025-05-07T08:44:25.290Z","avatar_url":"https://github.com/tale.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"# iconset\n\nA nifty command line tool to manage macOS icons\u003cbr/\u003e\n\n`iconset` is a new command line tool for macOS that allows you to change icons for macOS apps (excluding system ones of course).\u003cbr/\u003e\nIt's considered generally stable and utilizes `NSWorkspace()` to change icons, so it should work on all macOS versions above 15.4.1.\u003cbr/\u003e\n\n## Installing\n\nIn the future, I plan to set this up on brew, but for now the following command should work:\u003cbr/\u003e\n`curl https://github.com/tale/iconset/releases/download/v1.0.0/iconset -Lo /usr/local/bin/iconset`\u003cbr/\u003e\n`sudo chmod +x /usr/local/bin/iconset`\u003cbr/\u003e\n\n## Usage\n\n```\nOVERVIEW: A nifty command line tool to manage macOS icons\n\nUSAGE: iconset \u003csubcommand\u003e\n\nOPTIONS:\n  --version               Show the version.\n  -h, --help              Show help information.\n\nSUBCOMMANDS:\n  folder                  Set icons using a folder of '.icns' files with the same names as their '.app' counterparts\n  single                  Set the icon of a '.app' file using a '.icns' file\n  revert                  Revert a custom icon by supplying a path to a '.app' file or directory\n\n  See 'iconset help \u003csubcommand\u003e' for detailed help.\n```\n\n## Current Options\n\n- Specifying an icon and an application file to theme\u003cbr/\u003e\n- Specifying the directory where Applications are stored (defaults to `/Applications, ~/Applications`)\u003cbr/\u003e\n- Specifying a folder of `.icns` files who's names match their respective icons\u003cbr/\u003e\n- Reverting an icon by supplying a folder of `.icns` or the path to a `.app`\u003cbr/\u003e\n- Recursively searches through folders for `.app` files\u003cbr/\u003e\n\n## Possible Expansions\n\n- Advanced manifest file which lets you map `.icns` files to `.app` files directly\u003cbr/\u003e\n- Accompanying status bar app for macOS with automation and easy config UI\u003cbr/\u003e\n\n## Building\n\nThe project is an SPM Package that requires Xcode 13 and Swift 5.5.\u003cbr/\u003e\nRun `swift build --disable-sandbox` in the project root to build a debug binary.\u003cbr/\u003e\nFor release binaries, instead run `swift build -c release --arch arm64 --arch x86_64 --disable-sandbox` in the project root\u003cbr/\u003e\nCurrently, the in-app Xcode builds are sandbox enforced, potentially breaking `iconset`'s access to certain files.\u003cbr/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftale%2Ficonset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftale%2Ficonset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftale%2Ficonset/lists"}