Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tale/iconset
A nifty command-line tool to customize macOS icons
https://github.com/tale/iconset
command-line-tool macos swift
Last synced: 11 days ago
JSON representation
A nifty command-line tool to customize macOS icons
- Host: GitHub
- URL: https://github.com/tale/iconset
- Owner: tale
- License: apache-2.0
- Created: 2021-06-20T00:26:38.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-02-27T19:10:33.000Z (over 1 year ago)
- Last Synced: 2024-10-25T04:25:13.296Z (20 days ago)
- Topics: command-line-tool, macos, swift
- Language: Swift
- Homepage:
- Size: 56.6 KB
- Stars: 42
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# iconset
A nifty command line tool to manage macOS icons
`iconset` is a new command line tool for macOS that allows you to change icons for macOS apps (excluding system ones of course).
It's considered generally stable and utilizes `NSWorkspace()` to change icons, so it should work on all macOS versions above 15.4.1.
## Installing
In the future, I plan to set this up on brew, but for now the following command should work:
`curl https://github.com/tale/iconset/releases/download/v1.0.0/iconset -Lo /usr/local/bin/iconset`
`sudo chmod +x /usr/local/bin/iconset`
## Usage
```
OVERVIEW: A nifty command line tool to manage macOS icons
USAGE: iconset
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
folder Set icons using a folder of '.icns' files with the same names as their '.app' counterparts
single Set the icon of a '.app' file using a '.icns' file
revert Revert a custom icon by supplying a path to a '.app' file or directory
See 'iconset help ' for detailed help.
```
## Current Options
- Specifying an icon and an application file to theme
- Specifying the directory where Applications are stored (defaults to `/Applications, ~/Applications`)
- Specifying a folder of `.icns` files who's names match their respective icons
- Reverting an icon by supplying a folder of `.icns` or the path to a `.app`
- Recursively searches through folders for `.app` files
## Possible Expansions
- Advanced manifest file which lets you map `.icns` files to `.app` files directly
- Accompanying status bar app for macOS with automation and easy config UI
## Building
The project is an SPM Package that requires Xcode 13 and Swift 5.5.
Run `swift build --disable-sandbox` in the project root to build a debug binary.
For release binaries, instead run `swift build -c release --arch arm64 --arch x86_64 --disable-sandbox` in the project root
Currently, the in-app Xcode builds are sandbox enforced, potentially breaking `iconset`'s access to certain files.