{"id":25605668,"url":"https://github.com/hitblast/alter","last_synced_at":"2025-04-13T10:34:36.432Z","repository":{"id":278618254,"uuid":"936217918","full_name":"hitblast/Alter","owner":"hitblast","description":"Alter is a minimal macOS app which can be used to customize your app icons with ease.","archived":false,"fork":false,"pushed_at":"2025-04-04T05:44:45.000Z","size":29370,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T06:28:29.241Z","etag":null,"topics":["dart","flutter","icon-changer","macos","macos-app","macos-application","macos-utilities","swift","utilities"],"latest_commit_sha":null,"homepage":"http://hitblastis.me/Alter/","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hitblast.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-20T18:05:28.000Z","updated_at":"2025-04-04T05:44:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"6c2092a4-cb4d-4da8-a42b-403670dc0edc","html_url":"https://github.com/hitblast/Alter","commit_stats":null,"previous_names":["hitblast/alter"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitblast%2FAlter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitblast%2FAlter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitblast%2FAlter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hitblast%2FAlter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hitblast","download_url":"https://codeload.github.com/hitblast/Alter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248699656,"owners_count":21147683,"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":["dart","flutter","icon-changer","macos","macos-app","macos-application","macos-utilities","swift","utilities"],"created_at":"2025-02-21T18:18:30.147Z","updated_at":"2025-04-13T10:34:36.425Z","avatar_url":"https://github.com/hitblast.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"macos/Runner/Assets.xcassets/AppIcon.appiconset/icon_512x512@2x.png\" width=\"30%\" height=\"30%\" alt=\"Alter Icon\"\u003e\n\n# Alter\n\n_\"A minimal app to customize your macOS app icons with ease.\"_\u003cbr\u003e\nWorks on **macOS Ventura 13 or newer.**\n\n\u003c/div\u003e\n\n## Installation\n\n🍺 Install Alter using [Homebrew](https://brew.sh/) **(Recommended)**:\n\n```bash\nbrew install --cask hitblast/tap/alter\n```\n\n\u003e [!IMPORTANT]\n\u003e Make sure the app has access to **Privacy \u0026 Security \u003e App Management** permission so that it can operate as usual.\n\nAlternatively, use [GitHub Releases](https://github.com/hitblast/alter/releases) to download the latest builds.\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"assets/app_screenshot.png\" width=\"700\"\u003e\n    \u003cbr\u003e\n    \u003ci\u003eThe icons shown in the image are available on \u003ca href=\"https://macosicons.com/\"\u003emacosicons.com\u003c/a\u003e.\u003c/i\u003e\n    \u003cbr\u003e\n\u003c/div\u003e\n\n\u003e [!NOTE]\n\u003e By using Alter, you acknowledge that Alter is not [notarized.](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution)\n\u003e\n\u003e It's a security feature of Apple, based on which binaries are validated before running on consumer hardware. Since I do not plan to notarize Alter, the [Homebrew installation script]() will automatically remove the `com.apple.quarantine` attribute upon installation.\n\u003e\n\u003e A better reference could be found for this concept and why invalidating the attribute is important in [this section](https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution) of the documentation nikitabobko wrote for AeroSpace.\n\n## Table of Contents\n\n- [Key Features](#key-features)\n- [Backstory](#backstory)\n- [Common Pitfalls](#common-pitfalls)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Key Features\n\n- Simple workflow for changing regular app icons\n- Doesn't require disabling [SIP (System Integrity Protection)]()\n- Continuous and managed app synchronization in the background\n- Small binary size (19 MiB when compressed)\n- Based on the [Flutter](https://flutter.dev/) framework\n\n## Backstory\nI come from a Linux and Windows background, and customizability was at the forefront of what\nI was doing with my laptop back when I started learning. However, when I\nswitched to my Apple Silicon-powered machine, I wasn't really sure how to take\n\"customizability\" like I used to. Sure, there are apps which help me power through my everyday\nworkflow now, but aside of keybindings and shortcuts, I also wanted my Mac to\nlook and feel just like how I want it to.\n\nI eventually came across\n[IconChamp](https://www.macenhance.com/iconchamp.html)\nand [Pictogram](https://pictogramapp.com/), and while the latter one allows me\nto easily change \"some\" of my app icons, IconChamp can change basically all of\nthem. Including, obviously, system icons. The problem? None of them are really\n\"open-source\" and not \"really stable\" either, according to [this Reddit\nthread](https://www.reddit.com/r/macapps/comments/1dm1uad/has_iconchamp_been_abandoned/)\nwhich describes IconChamp glitching out while changing system icons on a regular\nbasis.\n\nI wanted to take the good parts of both apps and make my own, personal solution\nwith a fully open-sourced near-native development experience.\n\n---\n\n## Common Pitfalls\n\nBased on basic analysis of the project, a few, possibly resolvable issues have been found so far:\n\n- Self-validating binaries like [Discord](https://discord.com/) do not cooperate with the attribute\nmodifications happening inside, and could very as well broken once they're\ncustomized. To solve this, I've tried incorporating a blacklist of\napps which should be prohibited from modifying unless the user really desires.\n\n- The [Flutter Engine](https://github.com/flutter/engine) is a part of the\ncompiled binary (obviously since it's a Flutter project), so there will always be a tiny difference in size when it comes to comparing with a Swift binary.\n\n- For now, Alter cannot modify the system apps on macOS due to SIP (System Integrity Protection) being a thing. I'm still working on possible workarounds.\n\n## Contributing\n\nContributions are always welcome. If you are a developer who is willing to improve *any* aspect of the application,\nconsider reading [dev-docs/DEVELOPMENT.md](/dev-docs/DEVELOPMENT.md) for everything related to\nreproducing the development environment and more. If you have already attached the development environment, however,\nconsider following through the ethical guidelines of contributing written in [CONTRIBUTING.md](/CONTRIBUTING.md).\n\n## License\n\nThis project has been licensed under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhitblast%2Falter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhitblast%2Falter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhitblast%2Falter/lists"}