fn_registry/bash/functions/browser/set_chrome_profile_appearance.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, tested, tests, test_file_path, file_path, params, output

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	tested	tests	test_file_path	file_path	params	output
set_chrome_profile_appearance	function	bash	browser	1.1.0	impure	set_chrome_profile_appearance --user-data-dir <dir> --profile <dir-name> [--avatar <N|ruta.png>] [--color <#rrggbb>] [--variant <0..4>] [--dry-run]	Personaliza la apariencia visual de un perfil Chrome/Chromium existente: asigna un avatar built-in (índice 0..55) o una imagen PNG/JPG custom, y/o un color de acento (hex #rrggbb). Con --color aplica el tinte tanto al círculo del avatar en Local State (profile_highlight_color, profile_color_seed, default_avatar_fill_color) como al tema completo del navegador en el Preferences del perfil (browser.theme.user_color2, browser_color_variant, extensions.theme.system_theme), tiñendo toolbar, frame, barra de pestañas y omnibox. Requiere que Chromium esté cerrado sobre el user-data-dir. Hace backup de Local State y Preferences antes de escribir y valida el JSON resultante.	navegator chromium profile browser cdp scraping appearance avatar color				false	error_go_core		false			bash/functions/browser/set_chrome_profile_appearance.sh	name desc --user-data-dir Raíz del user-data-dir de Chrome/Chromium donde vive el perfil. El directorio y Local State deben existir. Obligatorio. name desc --profile Nombre de la carpeta del perfil dentro de user-data-dir, por ejemplo: Default, Automation, "Profile 1". El perfil debe existir previamente en info_cache de Local State. Obligatorio. name desc --avatar Índice entero 0..55 del avatar built-in de Chrome (56 avatares: animales, objetos, personas) o ruta absoluta/relativa a un archivo PNG/JPG para avatar custom. Con índice: sets avatar_icon=IDR_PROFILE_AVATAR_<N> e is_using_default_avatar=true. Con imagen: copia el archivo al perfil como 'Google Profile Picture.png' y sets is_using_default_avatar=false. Opcional; al menos uno de --avatar o --color debe darse. name desc --color Color de acento del perfil en hex #rrggbb, con o sin el '#' inicial. Se convierte a int32 con signo en formato ARGB 0xFFRRGGBB. Aplica el color en dos lugares: (1) Local State info_cache (profile_highlight_color, profile_color_seed, default_avatar_fill_color) para el círculo del avatar; (2) Preferences del perfil (browser.theme.user_color2 + browser_color_variant + extensions.theme.system_theme=0) para teñir toolbar, frame, barra de pestañas y omnibox. Opcional; al menos uno de --avatar o --color debe darse. name desc --variant Intensidad del tema de color aplicado al navegador (browser_color_variant). Entero 0..4: 0=system, 1=tonal_spot, 2=neutral, 3=vibrant (default), 4=expressive. Valores más altos dan tintes más saturados e identificables. Solo tiene efecto cuando se usa --color. Opcional. name desc --dry-run Describe las acciones que se ejecutarían (campos a modificar en Local State y Preferences, conversión de color, ruta del Preferences) sin escribir nada ni verificar si Chromium está corriendo. Emite JSON de resultado con dry_run:true.	JSON en stdout con los campos resultantes del perfil: {"profile":"<dir>","avatar_icon":"...","is_using_default_avatar":true|false,"profile_highlight_color":<int>,"profile_color_seed":<int>,"default_avatar_fill_color":<int>,"theme_applied":true|false,"variant":<int>,"preferences_path":"...","browser_theme_user_color2":<int>,"browser_theme_color_variant":<int>,"extensions_theme_system_theme":<int>,"backup":"Local State.bak.YYYYMMDD"}. En dry-run: {"profile":"...","avatar_applied":true|false,"color_applied":true|false,"theme_applied":true|false,"variant":<int>,"dry_run":true}. Mensajes de diagnóstico a stderr. Exit 0 en éxito.

Ejemplo

source $HOME/fn_registry/bash/functions/browser/set_chrome_profile_appearance.sh

# Asignar avatar #30 y tinte verde a toolbar/frame/omnibox del perfil Automation
# (verde #16a34a tiñe toda la chrome del navegador, no solo el círculo del avatar)
set_chrome_profile_appearance \
  --user-data-dir ~/.config/chromium-cdp \
  --profile Automation \
  --avatar 30 \
  --color "#16a34a"
# Salida JSON incluye: theme_applied:true, variant:3, browser_theme_user_color2:-15293622

# Color con intensidad personalizada (expressive = máxima saturación)
set_chrome_profile_appearance \
  --user-data-dir ~/.config/chromium-cdp \
  --profile Scraping \
  --color "#1f6feb" \
  --variant 4

# Solo cambiar avatar (no toca Preferences del perfil)
set_chrome_profile_appearance \
  --user-data-dir ~/.config/chromium-cdp \
  --profile "Profile 1" \
  --avatar 5

# Dry-run: ver qué se aplicaría en Local State y Preferences sin escribir
set_chrome_profile_appearance \
  --user-data-dir ~/.config/chromium-cdp \
  --profile Automation \
  --avatar 30 \
  --color "#16a34a" \
  --dry-run

Cuando usarla

Úsala para diferenciar visualmente los perfiles de un user-data-dir de automatización — un color y avatar distintos por perfil hacen inmediata la identificación en el selector de Chrome Y en la chrome del navegador (toolbar/frame visible mientras navega). Ejecútala justo después de create_chrome_profile (con --no-launch) o como paso independiente de personalización batch antes de lanzar sesiones CDP. Si solo quieres teñir el círculo del avatar (sin el tema), basta esta función; si quieres el tinte completo del navegador (lo más identificable), pasa --color.

Gotchas

• Chromium debe estar cerrado: Chrome reescribe Local State y Preferences completos desde memoria al cerrar; si se ejecuta mientras hay un proceso chromium vivo sobre el mismo user-data-dir, Chrome sobreescribirá los cambios al salir. La función detecta esto con pgrep -x chromium filtrando por cmdline y sale con exit 2 antes de modificar nada. Usa pkill -TERM chromium para cerrar y espera unos segundos.
• El tema se escribe en Preferences del perfil, distinto de Local State: los cambios de color al avatar van en <user-data-dir>/Local State (global a todos los perfiles); los cambios de tema del navegador van en <user-data-dir>/<profile_dir>/Preferences (específico de cada perfil). La función hace backup de ambos archivos por separado antes de tocarlos.
• El perfil debe existir en info_cache: esta función personaliza perfiles existentes; no los crea. Usa create_chrome_profile primero (con --no-launch basta para que aparezca en Local State) y luego set_chrome_profile_appearance.
• color es int32 con signo en ARGB: Chrome almacena el color como entero con signo de 32 bits en formato 0xAARRGGBB. Un color como #16a34a (verde) da ARGB 0xFF16A34A → signed int32 -15293622. La función hace la conversión internamente; tú pasas siempre hex #rrggbb.
• En modo oscuro del sistema el tinte sale más apagado: en temas oscuros del sistema el color se mezcla con el fondo oscuro y queda menos saturado. Para compensar, usa --variant 3 (vibrant, default) o --variant 4 (expressive); valores bajos como 1 o 2 pueden resultar casi imperceptibles en modo oscuro.
• extensions.theme.system_theme se fuerza a 0: si el perfil usaba el tema GTK del sistema (system_theme=1), el GTK puede ignorar el user_color. Esta función lo fuerza a 0 (tema propio de Chrome) para que el user_color2 tenga efecto. Si quieres devolver el perfil al tema del sistema, tendrás que resetear system_theme manualmente.
• Avatar custom (imagen) es best-effort: el campo gaia_picture_file_name y is_using_default_avatar=false se aplican correctamente en Local State y la imagen se copia al directorio del perfil. Sin embargo, Chrome puede ignorar la foto de perfil en perfiles sin sesión Google activa (Chromium sin cuenta). El camino robusto y garantizado es usar el índice built-in (--avatar 0..55): 56 avatares (animales, objetos, personas) son más que suficientes para diferenciar perfiles de automatización.
• Backup diario: se crea Local State.bak.YYYYMMDD y Preferences.bak.YYYYMMDD antes de cualquier escritura. Si ya existen los backups del día no se sobreescriben. Si el JSON resultante es inválido, se restaura automáticamente el backup correspondiente.

Exit codes

Código	Significado
0	Éxito
1	Argumento obligatorio faltante, rango inválido o archivo de imagen no encontrado
2	Lock: hay un chromium usando el mismo user-data-dir
3	El perfil no existe en info_cache de Local State
4	Error editando Local State o Preferences (JSON inválido tras escritura, restaurado backup)

Capability growth log

v1.1.0 (2026-06-06) — --color ahora aplica también el tema del navegador (toolbar/frame/omnibox) escribiendo browser.theme.user_color2 + browser_color_variant en el Preferences del perfil, no solo el color del avatar en Local State. Nuevo flag --variant (0..4, default 3 vibrant). Verificado con captura en Chromium 148.