Referencja poleceń

Przegląd

iconchanger <polecenie> [opcje]

Polecenia

status

Wyświetl aktualny status konfiguracji.

iconchanger status

Wyświetla:

• Liczbę skonfigurowanych aliasów aplikacji
• Liczbę zapisanych ikon
• Status skryptu pomocniczego

---

list

Wyświetl listę wszystkich aliasów i zapisanych ikon.

iconchanger list

Pokazuje tabelę wszystkich skonfigurowanych aliasów i wszystkich wpisów zapisanych ikon.

---

set-icon

Ustaw niestandardową ikonę dla aplikacji.

iconchanger set-icon <ścieżka-aplikacji> <ścieżka-obrazu>

Argumenty:

• ścieżka-aplikacji — Ścieżka do aplikacji (np. /Applications/Safari.app)
• ścieżka-obrazu — Ścieżka do pliku ikony (PNG, JPEG, ICNS itp.)

Przykłady:

# Ustaw niestandardową ikonę Safari
iconchanger set-icon /Applications/Safari.app ~/icons/safari.png

# Ścieżki względne również działają
iconchanger set-icon /Applications/Slack.app ./slack-icon.icns

---

remove-icon

Usuń niestandardową ikonę i przywróć oryginalną.

iconchanger remove-icon <ścieżka-aplikacji>

Przykład:

iconchanger remove-icon /Applications/Safari.app

---

restore

Przywróć wszystkie zapisane niestandardowe ikony. Przydatne po aktualizacji systemu lub gdy aplikacje resetują swoje ikony.

iconchanger restore [opcje]

Opcje:

• --dry-run — Podgląd tego, co zostałoby przywrócone, bez wprowadzania zmian
• --verbose — Pokaż szczegółowe dane wyjściowe dla każdej ikony
• --force — Przywróć nawet jeśli ikona wydaje się niezmieniona

Przykłady:

# Przywróć wszystkie zapisane ikony
iconchanger restore

# Podgląd tego, co się stanie
iconchanger restore --dry-run --verbose

# Wymuś przywrócenie wszystkiego
iconchanger restore --force

---

export

Eksportuj aliasy i konfigurację zapisanych ikon do pliku JSON.

iconchanger export <ścieżka-wyjściowa>

Przykład:

iconchanger export ~/Desktop/my-icons.json

---

import

Importuj plik konfiguracyjny.

iconchanger import <ścieżka-wejściowa>

Import jedynie dodaje nowe elementy — nigdy nie zastępuje ani nie usuwa istniejących wpisów.

Przykład:

iconchanger import ~/Desktop/my-icons.json

---

validate

Zwaliduj plik konfiguracyjny przed importem.

iconchanger validate <ścieżka-pliku>

Sprawdza strukturę JSON, wymagane pola i integralność danych bez wprowadzania zmian.

Przykład:

iconchanger validate ~/Desktop/my-icons.json

---

escape-jail

Ucieknij z więzienia squircle macOS Tahoe, ponownie stosując wbudowane ikony jako ikony niestandardowe. Ikony niestandardowe omijają wymuszanie squircle, zachowując oryginalny kształt ikony.

iconchanger escape-jail [ścieżka-aplikacji] [opcje]

Argumenty:

• ścieżka-aplikacji — (Opcjonalnie) Ścieżka do konkretnego pakietu .app. Jeśli pominięta, przetwarza wszystkie aplikacje w /Applications.

Opcje:

• --dry-run — Podgląd tego, co zostałoby zrobione, bez wprowadzania zmian
• --verbose — Pokaż szczegółowe dane wyjściowe

Przykłady:

# Ucieknij z więzienia dla wszystkich aplikacji w /Applications
iconchanger escape-jail

# Podgląd tego, co się stanie
iconchanger escape-jail --dry-run --verbose

# Ucieknij z więzienia dla konkretnej aplikacji
iconchanger escape-jail /Applications/Safari.app

WARNING

Ikony niestandardowe nie obsługują trybów ikon Clear, Tinted ani Dark w macOS Tahoe. Pozostają jako statyczne bitmapy.

---

completions

Generuj skrypty uzupełniania powłoki dla uzupełniania tabulatorem.

iconchanger completions <powłoka>

Argumenty:

• powłoka — Typ powłoki: zsh, bash lub fish

Przykłady:

# Zsh (dodaj do ~/.zshrc)
source <(iconchanger completions zsh)

# Bash (dodaj do ~/.bashrc)
source <(iconchanger completions bash)

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