fn_registry/bash/functions/browser/restore_chrome_bookmarks.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
restore_chrome_bookmarks	function	bash	browser	1.0.0	impure	restore_chrome_bookmarks --backup-dir <ts-dir> [--user-data-dir <dir>] [--profile <name>]... [--dry-run]	Restaura archivos Bookmarks de Chrome/Chromium desde un directorio de backup generado por backup_chrome_bookmarks hacia los perfiles destino en user-data-dir. Copia byte a byte con cp -p para preservar el checksum MD5 interno del archivo. Nunca parsea ni reserializa el JSON. Requiere que Chromium esté cerrado antes de ejecutar.	navegator chromium bookmarks restore browser scraping profile				false	error_go_core		false			bash/functions/browser/restore_chrome_bookmarks.sh	name desc --backup-dir Directorio de backup con timestamp generado por backup_chrome_bookmarks. Debe contener subdirectorios <profile>/Bookmarks. OBLIGATORIO. name desc --user-data-dir Ruta raíz del user-data-dir de Chrome/Chromium destino. Default: ~/.config/chromium name desc --profile Nombre del perfil a restaurar (repetible, ej. Default, Profile 1). Si no se pasa ninguno se restauran TODOS los perfiles presentes en el backup-dir. name desc --dry-run Muestra qué archivos se copiarían y cuáles Bookmarks.bak se borrarían, sin tocar nada en disco.	JSON en stdout: {"restored": [{"profile": "Default", "dst": "<path>", "bytes": N}, ...]}. Exit 0 en éxito o dry-run. Errores a stderr con exit != 0.

Ejemplo

# PASO 1 — cerrar Chromium (OBLIGATORIO en modo real)
pkill -TERM chromium

# PASO 2 — restaurar todos los perfiles desde el backup más reciente
source $HOME/fn_registry/bash/functions/browser/restore_chrome_bookmarks.sh
restore_chrome_bookmarks \
    --user-data-dir "$HOME/.config/chromium" \
    --backup-dir "$HOME/backups/chromium_bookmarks/2026-06-04T15:30:00"

# Restaurar solo un perfil concreto
restore_chrome_bookmarks \
    --backup-dir "$HOME/backups/chromium_bookmarks/2026-06-04T15:30:00" \
    --profile Default

# Restaurar dos perfiles específicos
restore_chrome_bookmarks \
    --backup-dir "$HOME/backups/chromium_bookmarks/2026-06-04T15:30:00" \
    --profile Default \
    --profile "Profile 1"

# Previsualizar sin tocar nada (no necesita Chromium cerrado)
restore_chrome_bookmarks \
    --backup-dir "$HOME/backups/chromium_bookmarks/2026-06-04T15:30:00" \
    --dry-run

# Salida esperada:
# {"restored":[{"profile":"Default","dst":"/home/enmanuel/.config/chromium/Default/Bookmarks","bytes":12453}]}

También ejecutable directamente con fn run:

cd $HOME/fn_registry
./fn run restore_chrome_bookmarks_bash_browser -- \
    --backup-dir "$HOME/backups/chromium_bookmarks/2026-06-04T15:30:00" \
    --dry-run

Cuando usarla

Úsala después de una sesión de scraping o automatización que haya alterado los bookmarks, o para recuperar bookmarks tras formatear/recrear un perfil de Chromium. Combínala con backup_chrome_bookmarks (que genera el --backup-dir con la estructura esperada) para tener un ciclo completo de backup/restore. También útil para propagar bookmarks de un perfil o PC a otro.

Gotchas

• Chromium DEBE estar cerrado antes de ejecutar en modo real. Chromium mantiene los bookmarks en memoria y los reescribe al archivo Bookmarks al cerrar; si restauras con Chromium abierto, el proceso sobreescribirá tu restauración al cerrarse. La función lo comprueba con pgrep -x chromium y aborta con exit 2 si hay procesos vivos. En --dry-run este check se omite.
• Copia verbatim — nunca reserializar el JSON. El archivo Bookmarks contiene un campo checksum con el MD5 del propio contenido JSON (calculado por Chromium internamente). Si se parsea y reserializa el JSON (aunque sea equivalente), el checksum queda inválido y Chromium descarta silenciosamente el archivo y regenera uno vacío. Esta función usa cp -p para garantizar que los bytes son idénticos al original.
• En Chromium 148 los bookmarks NO están bajo super_mac de Secure Preferences. No es necesario tocar Preferences ni Secure Preferences al restaurar bookmarks (a diferencia de extensiones). La función solo opera sobre el archivo Bookmarks.
• Bookmarks.bak residual se borra. Chromium crea Bookmarks.bak como copia de seguridad interna. Si existe antes de la restauración, esta función lo borra para que Chromium no lo use como fallback en lugar del archivo recién restaurado.
• El directorio destino del perfil se crea si no existe. Si el perfil aún no tiene directorio en user-data-dir, se crea con mkdir -p. Chromium lo inicializará correctamente la primera vez que arranque con ese perfil.
• Opera por perfil. Si no pasas --profile, restaura todos los perfiles presentes en el backup. Pasa --profile explícito para restaurar selectivamente y evitar sobreescribir perfiles sin querer.

Exit codes

Código	Significado
0	Éxito o dry-run completado
1	Argumento inválido, backup-dir/user-data-dir no encontrado, o perfil no presente en backup
2	Chromium está corriendo (solo en modo real)