Referencia de comandos

Descripcion general

iconchanger <command> [options]

Comandos

`status`

Muestra el estado actual de la configuracion.

iconchanger status

Muestra:

Cantidad de alias de aplicaciones configurados
Cantidad de iconos en cache
Estado del script auxiliar

`list`

Lista todos los alias y los iconos en cache.

iconchanger list

Muestra una tabla con todos los alias configurados y todas las entradas de iconos en cache.

`set-icon`

Establece un icono personalizado para una aplicacion.

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

Argumentos:

app-path — Ruta a la aplicacion (por ejemplo, /Applications/Safari.app)
image-path — Ruta a la imagen del icono (PNG, JPEG, ICNS, etc.)

Ejemplos:

# Establecer un icono personalizado para Safari
iconchanger set-icon /Applications/Safari.app ~/icons/safari.png

# Las rutas relativas tambien funcionan
iconchanger set-icon /Applications/Slack.app ./slack-icon.icns

`remove-icon`

Elimina un icono personalizado y restaura el original.

iconchanger remove-icon <app-path>

Ejemplo:

iconchanger remove-icon /Applications/Safari.app

`restore`

Restaura todos los iconos personalizados en cache. Util despues de una actualizacion del sistema o cuando las aplicaciones restablecen sus iconos.

iconchanger restore [options]

Opciones:

--dry-run — Vista previa de lo que se restauraria sin realizar cambios
--verbose — Muestra salida detallada para cada icono
--force — Restaura incluso si el icono parece no haber cambiado

Ejemplos:

# Restaurar todos los iconos en cache
iconchanger restore

# Vista previa de lo que ocurriria
iconchanger restore --dry-run --verbose

# Forzar la restauracion de todo
iconchanger restore --force

`export`

Exporta los alias y la configuracion de iconos en cache a un archivo JSON.

iconchanger export <output-path>

Ejemplo:

iconchanger export ~/Desktop/my-icons.json

`import`

Importa un archivo de configuracion.

iconchanger import <input-path>

La importacion solo agrega elementos nuevos — nunca reemplaza ni elimina entradas existentes.

Ejemplo:

iconchanger import ~/Desktop/my-icons.json

`validate`

Valida un archivo de configuracion antes de importarlo.

iconchanger validate <file-path>

Verifica la estructura JSON, los campos requeridos y la integridad de los datos sin realizar cambios.

Ejemplo:

iconchanger validate ~/Desktop/my-icons.json

`escape-jail`

Escapa de la jaula squircle de macOS Tahoe reaplicando los iconos incluidos en las aplicaciones como iconos personalizados. Los iconos personalizados eludan la imposicion de squircle, preservando la forma original del icono.

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

Argumentos:

app-path — (Opcional) Ruta a un paquete .app especifico. Si se omite, procesa todas las aplicaciones en /Applications.

Opciones:

--dry-run — Vista previa de lo que se haria sin realizar cambios
--verbose — Muestra salida detallada

Ejemplos:

# Escapar de la jaula para todas las aplicaciones en /Applications
iconchanger escape-jail

# Vista previa de lo que ocurriria
iconchanger escape-jail --dry-run --verbose

# Escapar de la jaula para una aplicacion especifica
iconchanger escape-jail /Applications/Safari.app

::: warning Los iconos personalizados no admiten los modos Clear, Tinted ni Dark de macOS Tahoe. Permanecen como mapas de bits estaticos. :::

`completions`

Genera scripts de autocompletado para el shell.

iconchanger completions <shell>

Argumentos:

shell — Tipo de shell: zsh, bash o fish

Ejemplos:

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

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

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