Руководство по установке

NumiSync Wizard доступен для Windows, macOS и Linux. Выберите вашу платформу ниже для получения инструкций по установке.

Системные требования

Все платформы

Windows

macOS

Linux

Установка на Windows

Вариант 1: Microsoft Store (скоро)

NumiSync Wizard отправлен на рассмотрение в Microsoft Store и ожидает сертификации. После одобрения вы сможете установить его прямо из Store с автоматическими обновлениями и без предупреждений SmartScreen.

Вариант 2: Прямая загрузка

Шаг 1: Скачайте NumiSync Wizard

  1. Перейдите на страницу релизов
  2. Скачайте последний установщик:
    • 64-bit системы: NumiSync-Wizard-Setup-1.0.0-x64.exe
    • 32-bit системы: NumiSync-Wizard-Setup-1.0.0-ia32.exe

Не знаете, какую версию выбрать? Большинство современных систем Windows — 64-bit. Чтобы проверить:

Шаг 2: Запустите установщик

  1. Дважды щёлкните загруженный установщик
  2. Windows может показать предупреждение SmartScreen (неподписанный установщик)
    • Нажмите «Подробнее» → «Всё равно запустить»
  3. Примите лицензионное соглашение (EULA)
  4. Выберите папку установки (по умолчанию: C:\Program Files\NumiSync Wizard)
  5. Нажмите Установить
  6. Дождитесь завершения установки
  7. Нажмите Готово для запуска NumiSync Wizard

Шаг 3: Первый запуск

При первом запуске NumiSync Wizard:

Установка на macOS

Важно: NumiSync Wizard не подписан сертификатом разработчика Apple. macOS заблокирует его по умолчанию. Следуйте этим шагам для установки:

Шаг 1: Скачайте NumiSync Wizard

  1. Перейдите на страницу релизов
  2. Скачайте последний DMG:
    • Универсальный DMG: NumiSync-Wizard-1.0.0-universal.dmg (работает как на Intel, так и на Apple Silicon)
    • Только для Intel: NumiSync-Wizard-1.0.0-x64.dmg
    • Apple Silicon: NumiSync-Wizard-1.0.0-arm64.dmg

Большинству пользователей следует скачать Universal DMG.

Шаг 2: Установите приложение

  1. Откройте DMG, дважды щёлкнув по нему
  2. Перетащите NumiSync Wizard в папку Applications
  3. Извлеките DMG (правая кнопка → Извлечь)

Шаг 3: Обход Gatekeeper (обязательно)

Поскольку приложение не подписано, macOS заблокирует его. Используйте Метод 1 (самый простой):

Метод 1: Открытие через правую кнопку мыши (рекомендуется)

  1. Перейдите в папку Applications в Finder
  2. Щёлкните правой кнопкой (или удерживая Control) на NumiSync Wizard
  3. Выберите «Открыть» из меню
  4. Нажмите «Открыть» в диалоге безопасности
  5. Приложение запустится — все последующие запуски работают обычно (просто дважды щёлкните)

Метод 2: Переопределение в «Системных настройках»

  1. Попробуйте открыть приложение обычным способом (оно будет заблокировано)
  2. Перейдите в Системные настройки → Безопасность и конфиденциальность → Основные
  3. Нажмите «Всё равно открыть» рядом с сообщением о заблокированном приложении
  4. Нажмите «Открыть» в диалоге подтверждения

Метод 3: Переопределение через Terminal (для опытных пользователей)

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

Подробные инструкции по устранению неполадок смотрите в Руководстве по установке на macOS.

Шаг 4: Первый запуск

При первом запуске NumiSync Wizard:

Установка на Linux

NumiSync Wizard доступен в трёх форматах для Linux. Выберите подходящий для вашего дистрибутива:

Вариант 1: AppImage (Универсальный — рекомендуется)

Подходит для: Всех дистрибутивов

  1. Скачайте NumiSync-Wizard-1.0.0.AppImage со страницы релизов
  2. Сделайте файл исполняемым: 
    chmod +x NumiSync-Wizard-1.0.0.AppImage
  3. Запустите: 
    ./NumiSync-Wizard-1.0.0.AppImage

Дополнительно: Интегрируйте с вашей рабочей средой с помощью AppImageLauncher

Вариант 2: Debian/Ubuntu (.deb)

Подходит для: Debian, Ubuntu, Linux Mint, Pop!_OS

# Скачать .deb файл
wget https://github.com/inguy24/numismat-enrichment/releases/latest/download/NumiSync-Wizard-1.0.0-amd64.deb

# Установить
sudo dpkg -i NumiSync-Wizard-1.0.0-amd64.deb

# Установить зависимости при необходимости
sudo apt-get install -f

Запустите из меню приложений или выполните:

numisync-wizard

Вариант 3: Fedora/RHEL (.rpm)

Подходит для: Fedora, RHEL, CentOS, Rocky Linux

# Скачать .rpm файл
wget https://github.com/inguy24/numismat-enrichment/releases/latest/download/NumiSync-Wizard-1.0.0.x86_64.rpm

# Установить
sudo rpm -i NumiSync-Wizard-1.0.0.x86_64.rpm

# Или с dnf (рекомендуется)
sudo dnf install NumiSync-Wizard-1.0.0.x86_64.rpm

Запустите из меню приложений или выполните:

numisync-wizard

Первый запуск (Linux)

При первом запуске NumiSync Wizard:

Начальная настройка

Примечание: Эти шаги одинаковы для всех платформ (Windows, macOS, Linux)

1. Добавьте ваш API-ключ Numista

  1. Нажмите Settings (значок шестерёнки) или нажмите Ctrl+,
  2. Перейдите на вкладку API Settings
  3. Введите ваш API-ключ Numista
  4. Нажмите Save

Как получить API-ключ:

  1. Зайдите на numista.com и создайте бесплатный аккаунт
  2. Войдите → Профиль → API Access
  3. Запросите API-ключ (мгновенное одобрение для личного использования)
  4. Скопируйте ключ и вставьте в NumiSync Wizard

2. Откройте вашу коллекцию

  1. Нажмите File → Open Collection (горячая клавиша зависит от платформы)
    • Windows/Linux: Ctrl+O
    • macOS: Cmd+O
  2. Перейдите к вашему файлу OpenNumismat .db
  3. Выберите файл и нажмите Open
  4. Ваши монеты загрузятся в главном окне

3. Настройте параметры данных (необязательно)

  1. Перейдите в Settings → Data Settings
  2. Выберите, какие данные синхронизировать:
    • Basic — Данные каталога на уровне типа (тираж, состав, правитель, дизайнер)
    • Issue — Данные конкретного выпуска (год, знак монетного двора, разновидности)
    • Pricing — Актуальные рыночные цены (UNC, XF, VF, F)
  3. При необходимости настройте сопоставление полей (только для опытных пользователей)

Проверка установки

Тест базовой функциональности

  1. Выберите несколько монет в коллекции
  2. Нажмите кнопку Search & Enrich
  3. NumiSync должен выполнить поиск в Numista и найти совпадения
  4. Просмотрите совпадения в интерфейсе сравнения полей
  5. Примите совпадение, чтобы проверить обновление данных

Если вы видите совпадения и можете обновлять данные монет — установка выполнена успешно!

Устранение неполадок

Проблемы на Windows

Установщик не запускается:

Приложение не запускается:

Проблемы на macOS

«NumiSync Wizard повреждён и не может быть открыт»:

«Нет варианта “Открыть” в диалоге безопасности»:

Приложение сразу завершает работу:

Смотрите Руководство по установке на macOS для подробного устранения неполадок.

Проблемы на Linux

AppImage не запускается:

Установка .deb завершается ошибкой:

Установка .rpm завершается ошибкой:

Отсутствуют библиотеки:

# 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

Все платформы

Не удаётся открыть коллекцию:

API-ключ не работает:

Проблемы с папкой кэша:

Удаление

Windows

  1. Перейдите в Settings → Приложения → Приложения и компоненты
  2. Найдите «NumiSync Wizard»
  3. Нажмите Удалить
  4. Следуйте инструкциям деинсталлятора

Ручная очистка (необязательно):

macOS

  1. Закройте приложение
  2. Удалите NumiSync Wizard.app из папки Applications
  3. Дополнительная очистка: 
    rm -rf ~/Library/Application\ Support/numisync-wizard-cache
rm -rf ~/Library/Preferences/com.numisync.wizard.plist

Linux

AppImage: Просто удалите файл .AppImage

Debian/Ubuntu (.deb):

sudo apt-get remove numisync-wizard

Fedora/RHEL (.rpm):

sudo rpm -e numisync-wizard
# Или с dnf
sudo dnf remove numisync-wizard

Ручная очистка (весь Linux):

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

Обновление до новой версии

NumiSync Wizard проверяет наличие обновлений при запуске (если включено в Settings).

Автоматическое обновление (при наличии)

  1. Нажмите уведомление «Update Available»
  2. Загрузка начнётся автоматически
  3. Установка начнётся после завершения загрузки
  4. Приложение перезапустится с новой версией

Ручное обновление

  1. Скачайте последний установщик со страницы релизов
  2. Запустите установщик
  3. Он автоматически обнаружит и обновит существующую установку
  4. Ваши настройки и кэш сохранятся

Следующие шаги

Нужна помощь?

← На главную Далее: Быстрый старт →