Guía de uso

🚀 Inicio rápido

1. Inicia Version Tracker. Al primer lanzamiento, un asistente de configuración te guía: autorización de Acceso total al disco (necesario para escanear tus aplicaciones) y, opcionalmente, la instalación de los gestores de paquetes que quieras seguir. Todo puede cambiarse después en los Ajustes.
2. Disfruta de la prueba gratuita. Una prueba de 7 días de la versión completa se inicia automáticamente, sin tarjeta de crédito. Al terminar, la app vuelve a la versión gratuita (el escaneo sigue siempre disponible).
3. Espera al primer escaneo. Según el número de apps instaladas y fuentes activas, el escaneo inicial dura entre 10 y 60 segundos.
4. Consulta la pestaña « Todas ». Aquí se concentran todas las actualizaciones disponibles.
5. Haz clic en « Actualizar todo » para lanzar todas las actualizaciones a la vez, o usa los botones individuales.

Instalar con Homebrew

Version Tracker está disponible desde su propio tap de Homebrew.

brew tap version-tracker/tap
brew install --cask version-tracker/tap/version-tracker

¿Ya instalaste Version Tracker a mano? Añade --force para que Homebrew se haga cargo de la copia que ya tienes:

brew install --cask --force version-tracker/tap/version-tracker

Version Tracker se mantiene actualizado por sí mismo, así que brew upgrade no entrará en conflicto con el actualizador propio de la app.

🗃️ Fuentes admitidas

Version Tracker detecta actualizaciones para:

Ajustes → Fuentes enumera las 51 fuentes, cada una con dos interruptores:

• Activa: la fuente se escanea. Desactivarla oculta sus elementos y acorta el análisis.
• Agrupada: la fuente participa en Actualizar todo, Procesar todo y Descargar todo. Desactívala para mantener una fuente visible y escaneada, pero fuera de los botones grandes. Sus filas siguen actualizándose una a una.

Agrupada aparece en gris mientras Activa esté desactivada: una fuente que no se escanea no tiene nada que aportar a un lote.

Nota: Adobe Camera Raw es un plugin y no una app, pero se enumera y se actualiza junto con los demás productos de Creative Cloud.

🖥️ La interfaz

La pantalla principal se divide en tres columnas, con una barra de herramientas encima:

Barra lateral izquierda

La navegación se organiza en secciones plegables, que puedes reordenar arrastrando. El contador junto a cada categoría indica cuántos elementos contiene, y su color indica cuáles son (consulta qué significan los colores de los contadores).

• RESUMEN: Panel (vista general, actividad reciente, última instantánea) e Instantáneas
• ACTUALIZACIONES: Todas (todas las actualizaciones en una sola lista), Aplicaciones, Paquetes, Homebrew, Actualizaciones del Sistema, Apple Developer Tools, Pospuestas (ver posponer una actualización)…
• Después, secciones por dominio (APLICACIONES, SISTEMA, IA, JavaScript, Python, Rust, editores…): solo aparecen las que corresponden a lo realmente instalado en tu Mac.

Barra de herramientas

• Escanear: relanza un escaneo completo (el botón también permite cancelar un escaneo en curso)
• Ajustes y Feedback: acceso directo a las preferencias y al formulario de comentarios
• Dos botones para mostrar/ocultar la barra lateral y el panel de Detalles

Zona central

La lista de elementos de la categoría seleccionada, con un campo de búsqueda. Cada fila muestra:

• El icono y el nombre de la app o del paquete
• La versión actual y la versión disponible
• Un botón de acción contextual (Actualizar, Descargar, Abrir, Mostrar en Finder…)

La búsqueda abarca por igual apps y paquetes, incluidos gems, crates, paquetes de yarn y herramientas de uv. Escribir filtra al instante, por grande que sea tu inventario. Elegir un resultado abre la categoría correcta, selecciona la fila y la desplaza hasta la vista; una app cuya única fila es su cask de Homebrew aterriza en esa fila.

Las columnas recuerdan cada anchura que fijes, incluida la del nombre, y cada tabla ajusta sus columnas al espacio disponible cuando cambias el tamaño de la ventana.

Cada lista indica cuándo se hizo, también las listas de paquetes, Adoptables e Ignoradas. Una lista vacía explica por qué lo está en lugar de no mostrar nada.

Barra lateral derecha (Detalles)

Detalles del elemento seleccionado, repartidos en cuatro pestañas: descripción, versiones, notas de la versión, fuente, ruta en disco y las comprobaciones de seguridad.

• Los botones Actualizar y Descargar también están aquí, no solo en la fila. Una descarga muestra su barra de progreso y después pasa a Mostrar en el Finder.
• Copiar informe pone en el portapapeles, de un clic, todo lo que las cuatro pestañas saben del elemento.
• Más acciones → Informar de una detección errónea abre un formulario ya rellenado con lo que Version Tracker ha visto: solo tienes que decir qué falla.
• El panel vuelve a abrirse en la pestaña que usaste, y durante un lote pasa directamente de una app a la siguiente en lugar de quedarse en blanco entre ambas.
• Sus botones aparecen en gris mientras se ejecuta un análisis, un lote o una descarga, igual que ya ocurría con las filas.

Nota: el ancho de la ventana se recuerda entre sesiones. El tamaño mínimo está diseñado para mostrar cómodamente las tres columnas.

🔄 Actualizar aplicaciones

Actualización individual

Haz clic en el botón verde « Actualizar » de una fila (requiere una licencia activa o la prueba, ver Licencia y prueba). Según la fuente:

• Mac App Store: usa CommerceKit (actualización silenciosa en segundo plano)
• Homebrew Cask/Formula: lanza brew upgrade (con autenticación de administrador si es necesario, ver más abajo). Si brew rechaza la actualización in situ, Version Tracker aplica automáticamente la reinstalación forzada que brew recomienda.
• Sparkle: descarga el DMG/ZIP, desmonta el antiguo e instala el nuevo
• GitHub: descarga e instala el binario más reciente
• Descarga directa: el botón naranja « Descargar » guarda el archivo en tu carpeta de descargas; después se convierte en « Mostrar en Finder » para terminar la instalación manualmente. « Descargar todo » lanza la descarga en lote.

Copia de seguridad automática: con el helper privilegiado activado, la versión anterior de la app se guarda antes de cada actualización. Si algo va mal, restaurarla desde Ajustes → Copias de seguridad (período de conservación y número de copias ajustables).

Actualización en lote

El botón « Actualizar todo » lanza, tras una confirmación que recapitula el número de actualizaciones, todas las actualizaciones automatizables en secuencia. Puedes salir de la vista: la operación continúa en segundo plano y al final se muestra un resumen (incluidas las actualizaciones aplazadas).

También puedes seleccionar varias filas y actualizar solo esa selección, desde el menú.

Un lote solo toma las fuentes cuyo interruptor Agrupada esté activado (ver Fuentes compatibles). Cuatro reglas deciden qué más queda fuera:

• Las apps en ejecución y las actualizaciones mayores quedan excluidas por el filtro de seguridad (Ajustes → Actualizaciones). Puedes actualizarlas una a una.
• Las actualizaciones que exigen un macOS más reciente que el tuyo quedan excluidas, y la fila indica la versión requerida.
• Una actualización sin ninguna firma se anuncia con un aviso antes de instalar nada. Una actualización cuya firma no supera la verificación queda bloqueada, sin excepción.
• En un Mac Intel, las fórmulas de Homebrew que podrían compilarse desde el código fuente quedan fuera de un lote global, y el informe dice cuáles y por qué. Actualízalas individualmente si quieres seguir: Version Tracker concede entonces hasta ocho horas por fórmula y puedes cancelar en cualquier momento.

Si una fila falla cuando su archivo ya estaba descargado, la descarga se te entrega en lugar de tirarse: la fila ofrece Mostrar en el Finder.

Posponer una actualización

Una actualización que no quieres ahora mismo puede posponerse en lugar de ignorarse. Haz clic derecho en la fila, elige Posponer y luego la duración: 1 día, 3 días, 1 semana, 2 semanas, 1 mes o Indefinidamente.

La fila pasa a la categoría Pospuestas de la barra lateral, que reúne todas las apps, paquetes y extensiones cuya actualización se ha saltado o pospuesto. Sale de las listas de actualizaciones y de los contadores, así que deja de insistir, pero nunca se pierde: Dejar de posponer la devuelve al instante.

Pospuestas no es Ignoradas. Ignoradas reúne los elementos con los que Version Tracker no puede hacer nada. Pospuestas es tu propia decisión, con una fecha asociada, y la fila vuelve sola cuando se agota el plazo.

Descarga manual (« Descargar »)

Algunas apps no tienen un mecanismo automático pero exponen una URL de descarga directa (PKG, DMG, ZIP). Para estas:

• Aparece el botón naranja « Descargar »
• El archivo se descarga en tu carpeta de descargas (por defecto ~/Downloads, personalizable en los Ajustes)
• Una vez descargado, el botón pasa a « Mostrar en el Finder » para finalizar la instalación a mano

El botón « Descargar todo » inicia las descargas en lote para todas las apps elegibles.

En caso de error (HTTP 403, archivo no encontrado, etc.), el botón cambia a « Abrir »: Version Tracker abre la app instalada para que gestione ella misma su actualización.

📸 Instantáneas

La vista Instantáneas (sección RESUMEN) fotografía el estado completo del software de tu Mac: aplicaciones, paquetes, herramientas, versiones instaladas y actualizaciones conocidas.

• Crear instantánea (⇧+⌘+N): captura el inventario actual. Después puedes renombrarla o fijarla.
• Comparar: selecciona dos instantáneas para ver todo lo que cambió entre ambas (elementos instalados, eliminados o actualizados), con filtros por tipo de cambio.
• Exportar…: exporta una instantánea o una comparación en JSON, CSV o Markdown. Dos perfiles de privacidad: Completo (conserva rutas y nombre de la máquina, para uso local) o Compartible (rutas absolutas, nombre de usuario y de máquina enmascarados).

Casos de uso típicos: documentar un Mac antes de una migración o reinstalación, saber qué cambió realmente una sesión de actualizaciones, o compartir un inventario limpio.

Instantáneas automáticas

Dos opciones en Ajustes → Actualizaciones:

• Instantáneas automáticas antes/después de « Actualizar todo »: crea una instantánea del inventario antes y después de cada actualización en lote, para comparar y documentar los cambios.
• Instantánea tras cada análisis programado: al final de cada escaneo automático, crea una instantánea, solo si algo cambió desde la última.

📋 La barra de menús

Version Tracker ofrece un icono en la barra de menús con el número de actualizaciones pendientes. El icono se anima mientras hay un escaneo o una actualización en curso.

El panel

Un clic en el icono abre un panel con las actualizaciones disponibles (tu versión → nueva versión), con:

• Acciones por fila: Actualizar, Descargar o Abrir según la fuente
• Los botones Escanear, Actualizar todo y Descargar todo
• Un pie con la fecha del último escaneo y el número de elementos seguidos
• Un chevrón en la cabecera para plegar o desplegar la lista (« Ocultar la lista » / « Mostrar la lista »): plegado, el panel se reduce a su cabecera y su pie

Autónomo, incluso con la app cerrada

• Abrir al iniciar sesión (Ajustes → General): lanza solo el icono de la barra de menús al iniciar sesión, sin abrir la ventana principal.
• Las actualizaciones lanzadas desde el panel se ejecutan en un proceso en segundo plano, sin abrir la ventana principal ni el icono del Dock.
• Con el Escaneo en segundo plano (Ajustes → Automatización), los escaneos programados, por intervalo o a hora fija diaria, siguen ejecutándose aunque la app esté cerrada: la insignia y las notificaciones se mantienen al día.

⚙️ Ajustes

Los Ajustes se organizan en paneles:

Carpetas analizadas

Por defecto Version Tracker busca donde macOS coloca las aplicaciones. Ajustes → Fuentes → Carpetas analizadas permite cambiarlo:

• Carpetas que analizar además: añade una carpeta, un segundo disco por ejemplo, para que tus apps de ahí también se encuentren.
• Carpetas que dejar de lado: Version Tracker no mirará dentro.

Si la misma carpeta está en ambas listas, dejarla de lado gana. Quitar una carpeta de una lista la saca de la lista y no toca nada de lo que contiene.

Descripciones emergentes

Apunta a un botón o a un ajuste y una frase explica lo que hace, tanto en la ventana como en el panel de la barra de menús.

Las descripciones emergentes están desactivadas por defecto en la versión 1.3. Actívalas en Ajustes → Apariencia → Descripciones emergentes. El interruptor rige toda la app, no una pantalla de cada dos.

Ocultar el icono de la barra de menús

Ajustes → General → Ocultar el icono de la barra de menús retira el icono por completo, esté la ventana abierta o cerrada. Cerrar la ventana simplemente la oculta, y la vuelves a abrir desde el Dock o con ⌘+Tab.

Cierre de la ventana

• Cerrar la ventana principal (⌘+W o el botón rojo) oculta la ventana: la app sigue activa en segundo plano.
• La opción « Cerrar la ventana conserva solo la barra de menús » (Ajustes → General) cierra la app principal y mantiene únicamente el icono de la barra de menús.
• ⌘+Q cierra realmente la aplicación (una alerta avisa si hay una actualización en curso).

🔐 Autenticación administrador

Algunas actualizaciones requieren privilegios de administrador. Version Tracker ofrece dos mecanismos:

1. Helper privilegiado (recomendado): un pequeño daemon firmado, activado una sola vez desde Ajustes → General → Helper privilegiado → Activar.
2. Autenticación puntual: sin el helper, un diálogo del sistema pide tu contraseña de administrador en cada operación.

Lo que aporta el helper:

• No más contraseña en cada actualización
• Instalación atómica (la app nunca queda reemplazada a medias)
• Verificación de firma y Team ID en el lado root
• Copia de seguridad automática de la versión anterior antes de cada actualización

¿El helper no responde? Tras una actualización de la app, usa el botón « Reparar » del panel Helper privilegiado: vuelve a registrar el daemon sin pedir tu contraseña de nuevo.

🔑 Licencia y prueba

Version Tracker sigue un modelo freemium:

• Versión gratuita: el escaneo y el inventario completos siguen siempre disponibles. Ves todo lo que está obsoleto, en todas las fuentes.
• Licencia (Mono, Solo o Family): desbloquea la instalación de actualizaciones con un clic, las actualizaciones en lote y las actualizaciones desde la barra de menús. Ver planes y precios.
• Prueba gratuita de 7 días: se inicia automáticamente en el primer lanzamiento, sin tarjeta de crédito. Al terminar, la app vuelve automáticamente a la versión gratuita.

Activar una licencia: abre Ajustes → Licencia y pega la clave recibida por correo tras la compra. Puedes desactivar la licencia en un Mac para liberar un puesto y activarla en otro.

Un puesto pertenece a una cuenta de usuario, no a un Mac. Tu clave se guarda en tu llavero de inicio de sesión, que macOS mantiene separado para cada cuenta. Una segunda cuenta en el mismo Mac empieza sin licencia y consume su propio puesto cuando la activas ahí. Cuenta un puesto por cada cuenta de usuario que vaya a usar Version Tracker.

¿Perdiste tu clave de licencia o necesitas una factura? Abre My Orders e inicia sesión con tu correo de compra. Sin contraseña, solo un enlace mágico. Allí encontrarás cada pedido, tu clave de licencia y los archivos de descarga. Para gestionar tu suscripción (método de pago, datos de IVA, cambios de plan), usa en cambio el portal de suscripción.

🖱️ Atajos de teclado

Para relanzar un escaneo completo, usa el botón Escanear de la barra de herramientas o el botón Escanear del panel de la barra de menús.

🌍 Idiomas

Version Tracker está disponible en:

• 🇪🇸 Español
• 🇬🇧 Inglés
• 🇫🇷 Francés
• 🇩🇪 Alemán
• 🇵🇹 Portugués (Portugal)
• 🇮🇹 Italiano
• 🇳🇱 Neerlandés

El idioma sigue automáticamente los ajustes del sistema macOS y puede cambiarse en Ajustes → General → Idioma.

🗑️ Desinstalar Version Tracker

Arrastrar la app a la Papelera basta en la gran mayoría de los casos. Aquí tienes el procedimiento completo si quieres no dejar ningún rastro.

Método sencillo (recomendado)

• Abre Ajustes y desactiva General → Abrir al iniciar sesión y Automatización → Escaneo en segundo plano.
• Cierra Version Tracker y su icono de la barra de menús (clic en el icono → Salir).
• Arrastra Version Tracker.app desde /Applications a la Papelera y vacíala.

Sin prisa : incluso sin este paso, cualquier rastro restante es inerte. Nada se ejecuta, nada corre como root, nada consume recursos.

Para una eliminación completa (opcional)

Version Tracker instala tres pequeños componentes, todos aprobados por ti en la instalación : un helper privilegiado y un icono de la barra de menús (ambos dentro de la app, desaparecen con ella), y una tarea de escaneo programada (un archivo aparte). Si te has saltado el paso anterior, elimínala manualmente :

launchctl unload ~/Library/LaunchAgents/com.jpflorencio.VersionTracker.agent.plist 2>/dev/null
rm -f ~/Library/LaunchAgents/com.jpflorencio.VersionTracker.agent.plist

Para eliminar también tus copias de seguridad de apps y tus instantáneas de inventario (irreversible) :

rm -rf ~/Library/Application\ Support/Version\ Tracker
defaults delete com.jpflorencio.VersionTracker

Por último, si Version Tracker sigue apareciendo en Configuración del Sistema → General → Elementos de inicio y extensiones, elimina la entrada (desaparece por sí sola poco después).

¿Piensas reinstalar o cambiar de Mac?

• Reinstalación en el mismo Mac : no toques nada. Tu clave de licencia permanece en el llavero y se activa automáticamente.
• Cambio a otro Mac : libera antes tu puesto de activación en Ajustes → Licencia → Desactivar, antes de eliminar la app.

¿El helper privilegiado se niega a reinstalarse? En Configuración del Sistema → General → Elementos de inicio y extensiones, desactiva Version Tracker y vuelve a activarlo (el ciclo completo resincroniza el estado, activarlo solo no basta). Si el problema persiste, vacía la Papelera y reinicia.

🗑️ Desinstalar los gestores de paquetes

Antes de empezar

• Abra la aplicación Terminal (Aplicaciones → Utilidades). El archivo de configuración del shell mencionado abajo es ~/.zshrc (el predeterminado en macOS).
• Elimine solo las herramientas que usted instaló para Version Tracker. Si otro software o proyecto depende de ellas, consérvelas.
• Desinstale primero las herramientas individuales y Homebrew en último lugar: desinstalarlo elimina todos los paquetes instalados con él.
• Tras la desinstalación, Version Tracker simplemente dejará de seguir esa fuente. Puede reinstalar cualquier herramienta en cualquier momento desde el onboarding o los Ajustes.

1. Herramientas instaladas directamente por Version Tracker (vía Homebrew)

Homebrew rechazará la desinstalación si otras fórmulas dependen de él. Es una protección, no un error.

⚠️ Homebrew (al final) elimina Homebrew y todos los paquetes instalados con él:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

El script indica al final las carpetas residuales (normalmente /opt/homebrew en Apple Silicon, /usr/local/Homebrew en Intel).

2. Herramientas externas (instaladas mediante sus guías oficiales)

Si instaló alguna de estas herramientas con Homebrew en lugar del instalador oficial, use simplemente brew uninstall <fórmula>.

Verificación

Para cada herramienta desinstalada: command -v <herramienta> no debe mostrar nada (abra antes una ventana nueva de Terminal).

❓ Preguntas frecuentes

📩 Contacto

El mejor lugar para reportar un bug o pedir una función es el gestor público de incidencias en GitHub. Cada reporte es visible para todos: puedes comprobar si tu problema ya fue reportado, añadir tus propios detalles y seguir su progreso hasta que se corrija.

• Bugs y peticiones de funciones: abre una incidencia en github.com/Version-Tracker/feedback
• Licencia, facturación o consultas privadas: contact@version-tracker.app
• Comentarios rápidos: el botón Feedback directamente en la app

¿Reportas un bug? Indica tu versión de macOS, tu versión de Version Tracker y la app o fuente afectada. Como el gestor es público, nunca pegues tu clave de licencia ni datos personales en una incidencia: envíalos por correo.