Rujukan Perintah

Gambaran Keseluruhan

iconchanger <command> [options]

Perintah

status

Tunjukkan status konfigurasi semasa.

iconchanger status

Memaparkan:

• Bilangan alias aplikasi yang dikonfigurasi
• Bilangan ikon yang dicache
• Status skrip pembantu

---

list

Senaraikan semua alias dan ikon yang dicache.

iconchanger list

Menunjukkan jadual semua alias yang dikonfigurasi dan semua entri ikon yang dicache.

---

set-icon

Tetapkan ikon tersuai untuk aplikasi.

iconchanger set-icon <app-path> <image-path>

Argumen:

• app-path — Laluan ke aplikasi (contohnya, /Applications/Safari.app)
• image-path — Laluan ke imej ikon (PNG, JPEG, ICNS, dll.)

Contoh:

# Tetapkan ikon Safari tersuai
iconchanger set-icon /Applications/Safari.app ~/icons/safari.png

# Laluan relatif juga berfungsi
iconchanger set-icon /Applications/Slack.app ./slack-icon.icns

---

remove-icon

Buang ikon tersuai dan pulihkan ikon asal.

iconchanger remove-icon <app-path>

Contoh:

iconchanger remove-icon /Applications/Safari.app

---

restore

Pulihkan semua ikon tersuai yang dicache. Berguna selepas kemas kini sistem atau apabila aplikasi menetapkan semula ikon mereka.

iconchanger restore [options]

Pilihan:

• --dry-run — Pratonton apa yang akan dipulihkan tanpa membuat perubahan
• --verbose — Tunjukkan output terperinci untuk setiap ikon
• --force — Pulihkan walaupun ikon kelihatan tidak berubah

Contoh:

# Pulihkan semua ikon yang dicache
iconchanger restore

# Pratonton apa yang akan berlaku
iconchanger restore --dry-run --verbose

# Paksa pulihkan semuanya
iconchanger restore --force

---

export

Eksport alias dan konfigurasi ikon yang dicache ke fail JSON.

iconchanger export <output-path>

Contoh:

iconchanger export ~/Desktop/my-icons.json

---

import

Import fail konfigurasi.

iconchanger import <input-path>

Import hanya menambah item baharu — ia tidak pernah menggantikan atau membuang entri sedia ada.

Contoh:

iconchanger import ~/Desktop/my-icons.json

---

validate

Sahkan fail konfigurasi sebelum mengimport.

iconchanger validate <file-path>

Menyemak struktur JSON, medan yang diperlukan, dan integriti data tanpa membuat perubahan.

Contoh:

iconchanger validate ~/Desktop/my-icons.json

---

escape-jail

Lepaskan diri dari squircle jail macOS Tahoe dengan menggunakan semula ikon yang dibundel sebagai ikon tersuai. Ikon tersuai memintas penguatkuasaan squircle, mengekalkan bentuk ikon asal.

iconchanger escape-jail [app-path] [options]

Argumen:

• app-path — (Pilihan) Laluan ke bundel .app tertentu. Jika ditinggalkan, memproses semua aplikasi dalam /Applications.

Pilihan:

• --dry-run — Pratonton apa yang akan dilakukan tanpa membuat perubahan
• --verbose — Tunjukkan output terperinci

Contoh:

# Lepaskan jail untuk semua aplikasi dalam /Applications
iconchanger escape-jail

# Pratonton apa yang akan berlaku
iconchanger escape-jail --dry-run --verbose

# Lepaskan jail untuk aplikasi tertentu
iconchanger escape-jail /Applications/Safari.app

WARNING

Ikon tersuai tidak menyokong mod ikon Clear, Tinted, atau Dark macOS Tahoe. Ia kekal sebagai bitmap statik.

---

completions

Jana skrip pelengkapan shell untuk pelengkapan tab.

iconchanger completions <shell>

Argumen:

• shell — Jenis shell: zsh, bash, atau fish

Contoh:

# Zsh (tambah ke ~/.zshrc)
source <(iconchanger completions zsh)

# Bash (tambah ke ~/.bashrc)
source <(iconchanger completions bash)

# Fish
iconchanger completions fish > ~/.config/fish/completions/iconchanger.fish