Riferimento dei comandi

Panoramica

iconchanger <comando> [opzioni]

Comandi

status

Mostra lo stato della configurazione corrente.

iconchanger status

Visualizza:

• Numero di alias delle app configurati
• Numero di icone nella cache
• Stato dello script helper

---

list

Elenca tutti gli alias e le icone nella cache.

iconchanger list

Mostra una tabella di tutti gli alias configurati e di tutte le voci delle icone nella cache.

---

set-icon

Imposta un'icona personalizzata per un'applicazione.

iconchanger set-icon <percorso-app> <percorso-immagine>

Argomenti:

• percorso-app — Percorso dell'applicazione (ad es. /Applications/Safari.app)
• percorso-immagine — Percorso del file immagine dell'icona (PNG, JPEG, ICNS, ecc.)

Esempi:

# Impostare un'icona personalizzata per Safari
iconchanger set-icon /Applications/Safari.app ~/icons/safari.png

# Funzionano anche i percorsi relativi
iconchanger set-icon /Applications/Slack.app ./slack-icon.icns

---

remove-icon

Rimuove un'icona personalizzata e ripristina quella originale.

iconchanger remove-icon <percorso-app>

Esempio:

iconchanger remove-icon /Applications/Safari.app

---

restore

Ripristina tutte le icone personalizzate nella cache. Utile dopo un aggiornamento del sistema o quando le app ripristinano le proprie icone.

iconchanger restore [opzioni]

Opzioni:

• --dry-run — Anteprima di ciò che verrebbe ripristinato senza apportare modifiche
• --verbose — Mostra un output dettagliato per ogni icona
• --force — Ripristina anche se l'icona sembra invariata

Esempi:

# Ripristinare tutte le icone nella cache
iconchanger restore

# Anteprima di ciò che accadrebbe
iconchanger restore --dry-run --verbose

# Forzare il ripristino di tutto
iconchanger restore --force

---

export

Esporta gli alias e la configurazione delle icone nella cache in un file JSON.

iconchanger export <percorso-output>

Esempio:

iconchanger export ~/Desktop/my-icons.json

---

import

Importa un file di configurazione.

iconchanger import <percorso-input>

L'importazione aggiunge solo nuovi elementi — non sostituisce né rimuove mai le voci esistenti.

Esempio:

iconchanger import ~/Desktop/my-icons.json

---

validate

Valida un file di configurazione prima dell'importazione.

iconchanger validate <percorso-file>

Verifica la struttura JSON, i campi obbligatori e l'integrità dei dati senza apportare modifiche.

Esempio:

iconchanger validate ~/Desktop/my-icons.json

---

escape-jail

Evade dallo squircle jail di macOS Tahoe riapplicando le icone incluse nelle app come icone personalizzate. Le icone personalizzate aggirano l'imposizione dello squircle, preservando la forma originale dell'icona.

iconchanger escape-jail [percorso-app] [opzioni]

Argomenti:

• percorso-app — (Facoltativo) Percorso di uno specifico bundle .app. Se omesso, elabora tutte le app in /Applications.

Opzioni:

• --dry-run — Anteprima di ciò che verrebbe fatto senza apportare modifiche
• --verbose — Mostra un output dettagliato

Esempi:

# Evadere dallo jail per tutte le app in /Applications
iconchanger escape-jail

# Anteprima di ciò che accadrebbe
iconchanger escape-jail --dry-run --verbose

# Evadere dallo jail per una specifica app
iconchanger escape-jail /Applications/Safari.app

WARNING

Le icone personalizzate non supportano le modalità Clear, Tinted o Dark delle icone di macOS Tahoe. Rimangono come bitmap statiche.

---

completions

Genera script di completamento per la shell per il completamento con il tasto Tab.

iconchanger completions <shell>

Argomenti:

• shell — Tipo di shell: zsh, bash o fish

Esempi:

# Zsh (aggiungere a ~/.zshrc)
source <(iconchanger completions zsh)

# Bash (aggiungere a ~/.bashrc)
source <(iconchanger completions bash)

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