Guía de Instalación

NumiSync Wizard está disponible para Windows, macOS y Linux. Elige tu plataforma a continuación para ver las instrucciones de instalación.

Requisitos del Sistema

Todas las plataformas

Windows

macOS

Linux

Instalación en Windows

Opción 1: Microsoft Store (Próximamente)

NumiSync Wizard ha sido enviado a Microsoft Store y está pendiente de certificación. Una vez aprobado, podrás instalarlo directamente desde la Tienda con actualizaciones automáticas y sin advertencias de SmartScreen.

Opción 2: Descarga Directa

Paso 1: Descargar NumiSync Wizard

  1. Visita la página de lanzamientos
  2. Descarga el instalador más reciente:
    • Sistemas de 64 bits: NumiSync-Wizard-Setup-1.0.0-x64.exe
    • Sistemas de 32 bits: NumiSync-Wizard-Setup-1.0.0-ia32.exe

¿No sabes qué versión elegir? La mayoría de los sistemas Windows modernos son de 64 bits. Para comprobarlo:

Paso 2: Ejecutar el Instalador

  1. Haz doble clic en el instalador descargado
  2. Windows puede mostrar una advertencia de SmartScreen (instalador sin firmar)
    • Haz clic en “Más información” → “Ejecutar de todas formas”
  3. Acepta el Contrato de Licencia para el Usuario Final (EULA)
  4. Elige el directorio de instalación (predeterminado: C:\Program Files\NumiSync Wizard)
  5. Haz clic en Instalar
  6. Espera a que se complete la instalación
  7. Haz clic en Finalizar para lanzar NumiSync Wizard

Paso 3: Primer Inicio

En el primer inicio, NumiSync Wizard:

Instalación en macOS

Importante: NumiSync Wizard no está firmado con un certificado de Apple Developer. macOS lo bloqueará por defecto. Sigue estos pasos para instalarlo:

Paso 1: Descargar NumiSync Wizard

  1. Visita la página de lanzamientos
  2. Descarga el último DMG:
    • DMG Universal: NumiSync-Wizard-1.0.0-universal.dmg (funciona tanto en Intel como en Apple Silicon)
    • Específico para Intel: NumiSync-Wizard-1.0.0-x64.dmg
    • Apple Silicon: NumiSync-Wizard-1.0.0-arm64.dmg

La mayoría de los usuarios deben descargar el DMG Universal.

Paso 2: Instalar la App

  1. Abre el DMG haciendo doble clic
  2. Arrastra NumiSync Wizard a tu carpeta de Aplicaciones
  3. Expulsa el DMG (clic derecho → Expulsar)

Paso 3: Omitir Gatekeeper (Obligatorio)

Como la app no está firmada, macOS la bloqueará. Usa el Método 1 (el más sencillo):

Método 1: Abrir con clic derecho (Recomendado)

  1. Ve a la carpeta Aplicaciones en el Finder
  2. Haz clic derecho (o Control+clic) sobre NumiSync Wizard
  3. Selecciona “Abrir” en el menú
  4. Haz clic en “Abrir” en el diálogo de seguridad
  5. La app se iniciará — los lanzamientos futuros funcionarán con normalidad (solo haz doble clic)

Método 2: Preferencias del Sistema

  1. Intenta abrir la app normalmente (será bloqueada)
  2. Ve a Preferencias del Sistema → Seguridad y privacidad → General
  3. Haz clic en “Abrir de todas formas” junto al mensaje de la app bloqueada
  4. Haz clic en “Abrir” en el diálogo de confirmación

Método 3: Terminal (Avanzado)

cd /Applications
xattr -d com.apple.quarantine "NumiSync Wizard.app"

Para una solución de problemas detallada, consulta la Guía de Instalación en macOS.

Paso 4: Primer Inicio

En el primer inicio, NumiSync Wizard:

Instalación en Linux

NumiSync Wizard está disponible en tres formatos para Linux. Elige según tu distribución:

Opción 1: AppImage (Universal - Recomendado)

Ideal para: Todas las distribuciones

  1. Descarga NumiSync-Wizard-1.0.0.AppImage desde Lanzamientos
  2. Hazlo ejecutable: 
    chmod +x NumiSync-Wizard-1.0.0.AppImage
  3. Ejecútalo: 
    ./NumiSync-Wizard-1.0.0.AppImage

Opcional: Intégralo con tu entorno de escritorio usando AppImageLauncher

Opción 2: Debian/Ubuntu (.deb)

Ideal para: Debian, Ubuntu, Linux Mint, Pop!_OS

# Descarga el archivo .deb
wget https://github.com/inguy24/numismat-enrichment/releases/latest/download/NumiSync-Wizard-1.0.0-amd64.deb

# Instala
sudo dpkg -i NumiSync-Wizard-1.0.0-amd64.deb

# Instala dependencias si es necesario
sudo apt-get install -f

Lánzalo desde el menú de aplicaciones o ejecuta:

numisync-wizard

Opción 3: Fedora/RHEL (.rpm)

Ideal para: Fedora, RHEL, CentOS, Rocky Linux

# Descarga el archivo .rpm
wget https://github.com/inguy24/numismat-enrichment/releases/latest/download/NumiSync-Wizard-1.0.0.x86_64.rpm

# Instala
sudo rpm -i NumiSync-Wizard-1.0.0.x86_64.rpm

# O con dnf (recomendado)
sudo dnf install NumiSync-Wizard-1.0.0.x86_64.rpm

Lánzalo desde el menú de aplicaciones o ejecuta:

numisync-wizard

Primer Inicio (Linux)

En el primer inicio, NumiSync Wizard:

Configuración Inicial

Nota: Estos pasos son iguales en todas las plataformas (Windows, macOS, Linux)

1. Añadir Tu Clave de API de Numista

  1. Haz clic en Settings (icono de engranaje) o pulsa Ctrl+,
  2. Ve a la pestaña API Settings
  3. Introduce tu clave de API de Numista
  4. Haz clic en Save

Cómo obtener una clave de API:

  1. Ve a numista.com y crea una cuenta gratuita
  2. Inicia sesión → Perfil → Acceso a API
  3. Solicita una clave de API (aprobación instantánea para uso personal)
  4. Copia la clave y pégala en NumiSync Wizard

2. Abrir Tu Colección

  1. Haz clic en File → Open Collection (el atajo de teclado varía según la plataforma)
    • Windows/Linux: Ctrl+O
    • macOS: Cmd+O
  2. Navega hasta tu archivo .db de OpenNumismat
  3. Selecciona el archivo y haz clic en Open
  4. Tus monedas se cargarán en la ventana principal

3. Configurar los Ajustes de Datos (Opcional)

  1. Ve a Settings → Data Settings
  2. Elige qué datos sincronizar:
    • Basic - Datos del catálogo a nivel de tipo (tirada, composición, gobernante, diseñador)
    • Issue - Datos específicos de la emisión (año, marca de ceca, variantes de tipo)
    • Pricing - Precios de mercado actuales (grados UNC, XF, VF, F)
  3. Configura el mapeo de campos si es necesario (solo para usuarios avanzados)

Verificar la Instalación

Probar la Funcionalidad Básica

  1. Selecciona algunas monedas de tu colección
  2. Haz clic en el botón Search & Enrich
  3. NumiSync debería buscar en Numista y encontrar coincidencias
  4. Revisa las coincidencias en la interfaz de comparación de campos
  5. Acepta una coincidencia para verificar que las actualizaciones de datos funcionan

Si ves coincidencias y puedes actualizar los datos de las monedas, ¡la instalación fue exitosa!

Solución de Problemas

Problemas en Windows

El instalador no se ejecuta:

La aplicación no inicia:

Problemas en macOS

“NumiSync Wizard está dañado y no se puede abrir”:

“No hay opción de Abrir en el diálogo de seguridad”:

La app se cierra inmediatamente:

Consulta la Guía de Instalación en macOS para una solución de problemas detallada.

Problemas en Linux

AppImage no se ejecuta:

La instalación del .deb falla:

La instalación del .rpm falla:

Librerías faltantes:

# Ubuntu/Debian
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils

# Fedora/RHEL
sudo dnf install gtk3 libnotify nss libXScrnSaver libXtst xdg-utils

Todas las plataformas

No se puede abrir la colección:

La clave de API no funciona:

Problemas con el directorio de caché:

Desinstalación

Windows

  1. Ve a Configuración → Aplicaciones → Aplicaciones y características
  2. Busca “NumiSync Wizard”
  3. Haz clic en Desinstalar
  4. Sigue las instrucciones del desinstalador

Limpieza manual (opcional):

macOS

  1. Cierra la aplicación
  2. Elimina NumiSync Wizard.app de la carpeta Aplicaciones
  3. Limpieza opcional: 
    rm -rf ~/Library/Application\ Support/numisync-wizard-cache
rm -rf ~/Library/Preferences/com.numisync.wizard.plist

Linux

AppImage: Simplemente elimina el archivo .AppImage

Debian/Ubuntu (.deb):

sudo apt-get remove numisync-wizard

Fedora/RHEL (.rpm):

sudo rpm -e numisync-wizard
# O con dnf
sudo dnf remove numisync-wizard

Limpieza manual (todos los Linux):

rm -rf ~/.config/numisync-wizard-cache
rm -rf ~/.config/numisync-wizard

Actualizar a una Nueva Versión

NumiSync Wizard comprobará si hay actualizaciones al iniciarse (si está habilitado en Settings).

Actualización Automática (Cuando Esté Disponible)

  1. Haz clic en la notificación “Update Available”
  2. La descarga comenzará automáticamente
  3. La instalación procederá cuando se complete la descarga
  4. La aplicación se reiniciará con la nueva versión

Actualización Manual

  1. Descarga el último instalador desde Lanzamientos
  2. Ejecuta el instalador
  3. Detectará y actualizará automáticamente la instalación existente
  4. Tu configuración y caché se conservarán

Próximos Pasos

¿Necesitas ayuda?

← Volver al inicio Siguiente: Inicio Rápido →