Guía de uso
Version Tracker rastrea todas tus aplicaciones macOS y sus actualizaciones desde una sola interfaz. Escanea automáticamente tus fuentes de software (Mac App Store, Homebrew, Sparkle, GitHub, descargas directas, gestores de paquetes, herramientas de IA…) y te indica lo que está al día, lo que no, y qué hacer para actualizarlo. Esta guía corresponde a Version Tracker 1.2.
🚀 Inicio rápido
- 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.
- 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).
- Espera al primer escaneo. Según el número de apps instaladas y fuentes activas, el escaneo inicial dura entre 10 y 60 segundos.
- Consulta la pestaña « Todas ». Aquí se concentran todas las actualizaciones disponibles.
- Haz clic en « Actualizar todo » para lanzar todas las actualizaciones a la vez, o usa los botones individuales.
🗃️ Fuentes admitidas
Version Tracker detecta actualizaciones para:
| Fuente | Descripción |
|---|---|
| Actualizaciones macOS | Actualizaciones del sistema Apple |
| macOS Security | Seguimiento de los parches de seguridad de macOS (feed SOFA) |
| Mac App Store | Todas las apps instaladas vía App Store oficial |
| Homebrew Casks | Aplicaciones GUI instaladas vía Homebrew |
| Homebrew Formulas | Herramientas CLI Homebrew |
| Sparkle | Apps con el framework Sparkle |
| Electron | Apps creadas con Electron, actualizadas vía Squirrel |
| Tauri | Apps creadas con Tauri, mediante su actualizador integrado |
| GitHub Releases | Apps distribuidas vía GitHub Releases |
| Descarga directa | Apps con instalador en sitio oficial |
| Mac App Store « Discover » | Apps detectadas fuera del App Store pero disponibles en él |
| Apps adoptables | Apps detectadas fuera de Homebrew pero disponibles como cask |
| Microsoft (MAU) | Word, Excel, PowerPoint, Outlook, OneNote, Edge vía Microsoft AutoUpdate |
| Apps de Google actualizadas vía Keystone (Chrome, Drive…) | |
| Adobe Creative Cloud | Apps Creative Cloud a través del actualizador de Adobe |
| Apple Tools | Xcode, Command Line Tools, Rosetta |
| Xcode (xcodes) | Versiones de Xcode gestionadas por el CLI xcodes, canales estable y beta |
| Plugins JetBrains | Plugins de usuario de los IDE JetBrains y Android Studio (Marketplace) |
| Android SDK | Plataformas y herramientas del Android SDK instaladas |
| Qt | Componentes del Qt Maintenance Tool |
| Docker / Podman | Imágenes de contenedores y sus nuevas versiones |
| Ollama | Modelos de IA locales gestionados por Ollama |
| IA y agentes | Skills, plugins y marketplaces de herramientas de IA (Claude Code, Codex, Gemini…) |
| Gestores de paquetes | npm, yarn, pnpm, pip, pipx, uv, gem, cargo, rustup, conda, go, bun, deno, mise, MacPorts, Nix, Flutter, Composer, SDKMAN, TeX Live, gcloud… |
| Extensiones de editores | Extensiones de VS Code, VS Code Insiders, VSCodium, Cursor, Windsurf |
Cada fuente puede activarse o desactivarse en los Ajustes.
🖥️ 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 el número de actualizaciones disponibles.
- 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…
- 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…)
Barra lateral derecha (Detalles)
Detalles del elemento seleccionado: descripción, versiones, notas de la versión, fuente, ruta en disco.
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).
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.
⚙️ Ajustes
Los Ajustes se organizan en paneles:
| Panel | Contenido |
|---|---|
| General | Inicio, idioma, barra de menús (« Abrir al iniciar sesión »), comportamiento al cerrar la ventana, permisos del sistema y Helper privilegiado |
| Apariencia | Tema (Sistema / Claro / Oscuro) y personalización visual |
| Notificaciones | Alertas de actualización e insignias; permiso de notificaciones de macOS |
| Fuentes | Activar o desactivar cada fuente escaneada. Desactivar una fuente oculta sus apps y acelera los escaneos |
| Automatización | Planificación del análisis automático — por intervalo o a hora fija diaria (con la app abierta o cerrada) —, escaneo al iniciar, Escaneo en segundo plano y gestión de la caché |
| Actualizaciones | Reglas de actualización (incluida « Ocultar actualizaciones incompatibles con este macOS »), instantáneas automáticas, opciones de Homebrew (incluida « Limpiar la caché de Homebrew ») y carpeta de descargas manuales (recordada mediante un marcador seguro) |
| Copias de seguridad | Copias de apps creadas por el helper antes de cada actualización: restaurar, eliminar y ajustar la retención (período en días, copias conservadas por app) |
| Avanzado | Diagnósticos y herramientas de depuración |
| Licencia | Activar o desactivar tu clave de licencia, ver tu plan |
| Acerca de | Versión, actualizaciones del propio Version Tracker (búsqueda y descarga automáticas, canal beta) y compromisos de privacidad |
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:
- Helper privilegiado (recomendado) — un pequeño daemon firmado, activado una sola vez desde Ajustes → General → Helper privilegiado → Activar.
- 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 (Solo, Family o Pro) — 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.
🖱️ Atajos de teclado
| Atajo | Acción |
|---|---|
| ⌘+, | Abrir Ajustes |
| ⌘+W | Cerrar la ventana principal (la app sigue en segundo plano) |
| ⌘+Q | Salir de Version Tracker |
| ⇧+⌘+N | Crear una instantánea (en la vista Instantáneas) |
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)
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.appdesde/Applicationsa 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.plistPara 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.VersionTrackerPor ú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)
| Herramienta | Desinstalación |
|---|---|
| mas (Mac App Store CLI) | brew uninstall mas |
| Node.js (npm) | Comprobar dependencias: brew uses --installed node, luego brew uninstall node |
| Python (pip) | Localizar la fórmula exacta: brew list --formula | grep python, luego brew uninstall python@3.13 (ajuste la versión) |
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>.
| Herramienta | Desinstalación |
|---|---|
| MacPorts | sudo port -fp uninstall installed, luego seguir la guía oficial: https://guide.macports.org/chunked/installing.macports.uninstalling.html |
| Nix | Procedimiento de varios pasos (demonio launchd, volumen /nix, usuarios _nixbld) — seguir el capítulo «Uninstalling» del manual oficial de Nix |
| mise | mise implode (elimina mise y todos sus datos) |
| Rust (rustup) | rustup self uninstall |
| Go | sudo rm -rf /usr/local/go /etc/paths.d/go (paquete oficial) |
| Flutter | Eliminar la carpeta del SDK (p. ej. rm -rf ~/development/flutter) y quitar la línea PATH de ~/.zshrc |
| Docker Desktop | En Docker Desktop: Troubleshoot → Uninstall, luego arrastrar Docker.app a la Papelera |
| Ollama | Salir de la app (icono de la barra de menús), arrastrar Ollama.app a la Papelera y luego rm -rf ~/.ollama (elimina también los modelos descargados) |
| Miniconda | conda init --reverse --all, luego rm -rf ~/miniconda3 |
| MacTeX / TeX Live | Seguir la guía oficial: https://www.tug.org/mactex/uninstalling.html (en particular /usr/local/texlive/<año>) |
| Composer | rm /usr/local/bin/composer (o donde esté su composer.phar) |
| SDKMAN! | rm -rf ~/.sdkman, luego quitar las líneas SDKMAN de ~/.zshrc |
| Ruby (RubyGems) | Si se instaló vía Homebrew: brew uninstall ruby. El Ruby del sistema de Apple no se puede eliminar |
| Yarn | npm rm -g yarn, o corepack disable si se activó mediante Corepack |
| pnpm | rm -rf ~/Library/pnpm, luego quitar las líneas PNPM_HOME de ~/.zshrc (si fue vía npm: npm rm -g pnpm) |
| pipx | Opcional: pipx uninstall-all, luego python3 -m pip uninstall pipx y rm -rf ~/.local/pipx |
| Bun | rm -rf ~/.bun, luego quitar las líneas bun de ~/.zshrc |
| Deno | rm -rf ~/.deno, luego quitar la línea PATH de ~/.zshrc |
| GitHub CLI (gh) | brew uninstall gh (o sudo port uninstall gh vía MacPorts) |
| uv | uv cache clean && rm -rf "$(uv python dir)" "$(uv tool dir)", luego rm ~/.local/bin/uv ~/.local/bin/uvx |
| VS Code / Insiders / VSCodium / Cursor / Windsurf | Arrastrar la aplicación a la Papelera; quedan datos residuales en ~/Library/Application Support/<app> y ~/.vscode (o equivalente) |
Verificación
Para cada herramienta desinstalada: command -v <herramienta> no debe mostrar nada (abra antes una ventana nueva de Terminal).
❓ Preguntas frecuentes
¿Por qué el botón « Actualizar » está gris o pide una licencia?
La versión gratuita ofrece el escaneo y el inventario completos, pero instalar actualizaciones con un clic requiere una licencia activa (o la prueba gratuita de 7 días). Activa tu clave en Ajustes → Licencia. Ver Licencia y prueba.
¿Por qué algunas apps no se detectan?
Verifica que la fuente correspondiente esté activada en los Ajustes y que la app esté instalada en /Applications.
¿Por qué el contador de una fuente está vacío tras una actualización?
Es normal. Los contadores reflejan las actualizaciones disponibles. Tras actualizar, la app desaparece de la vista. Usa el botón Escanear para forzar una nueva comprobación.
El icono de la barra de menús sigue visible tras salir de la app
Es el compañero de la barra de menús, un agente separado que sigue vigilando tus actualizaciones aunque la app principal esté cerrada. Para desactivarlo, desmarca « Abrir al iniciar sesión » en Ajustes → General, o elige Salir de Version Tracker en el menú del icono.
¿Version Tracker hace tracking o recopila datos?
No. Ninguna telemetría, ningún inventario transmitido. Las solicitudes de red se limitan a la validación de licencia y a la consulta de las fuentes de software. Tu inventario de software se queda en tu Mac. Ver nuestra Política de privacidad.
📩 Contacto
Para reportar un bug, sugerir una mejora o compartir comentarios: contact@version-tracker.app — o usa el botón Feedback directamente en la app.