インストールガイド

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 Developerの証明書で署名されていません。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

ほとんどのユーザーはユニバーサルDMGをダウンロードしてください。

ステップ2：アプリをインストール

  1. DMGをダブルクリックして開く
  2. NumiSync WizardをApplicationsフォルダにドラッグ
  3. DMGを取り出す（右クリック → 取り出す）

ステップ3：Gatekeeperの回避（必須）

アプリが未署名のため、macOSがブロックします。最も簡単な方法1を使用してください：

方法1：右クリックで開く（推奨）

  1. FinderでApplicationsフォルダに移動
  2. NumiSync Wizardを右クリック（またはControlキーを押しながらクリック）
  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向けに3つの形式で提供されています。お使いのディストリビューションに合わせて選択してください：

オプション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. Numista APIキーの追加

  1. Settings（歯車アイコン）をクリックするか、Ctrl+,を押す
  2. API Settingsタブに移動
  3. Numista APIキーを入力
  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. フィールド比較UIでマッチを確認
  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. 設定 → アプリ → アプリと機能に移動
  2. 「NumiSync Wizard」を検索
  3. アンインストールをクリック
  4. アンインストーラーの指示に従う

手動クリーンアップ（オプション）：

macOS

  1. アプリケーションを終了
  2. ApplicationsフォルダからNumiSync Wizard.appを削除
  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. 設定とキャッシュは保持されます

次のステップ

サポートが必要な場合

← ホームに戻る 次へ：クイックスタート →