Quick Start Guide
Get up and running with NumiSync Wizard in 5 minutes. This guide walks you through the basic workflow of enriching your coin collection.
Platform Note: This guide works for Windows, macOS, and Linux. Keyboard shortcuts are shown for all platforms where they differ.
Prerequisites
Before starting, make sure you have:
- NumiSync Wizard installed (Installation Guide)
- OpenNumismat collection (.db file with some coins)
- Numista API key (free from numista.com)
Step 1: Launch and Configure
Open NumiSync Wizard
- Launch NumiSync Wizard:
- Windows: Start Menu or Desktop shortcut
- macOS: Applications folder or Launchpad
- Linux: Applications menu or run
numisync-wizard(if installed via .deb/.rpm)
- First launch will create a cache directory automatically
Add Your API Key
- Click Settings (gear icon) or press:
- Windows/Linux:
Ctrl+, - macOS:
Cmd+,
- Windows/Linux:
- Go to API Settings tab
- Paste your Numista API key
- Click Save
Don’t have an API key? Get one free at numista.com → Profile → API Access
Step 2: Open Your Collection
- Click File → Open Collection or press:
- Windows/Linux:
Ctrl+O - macOS:
Cmd+O
- Windows/Linux:
- Navigate to your OpenNumismat
.dbfile - Click Open
- Your coins will load in the main window
Tip: NumiSync remembers recent collections. Use File → Recent Collections for quick access.
Step 3: Search for Matches
Select Coins to Enrich
You can enrich coins one at a time or in batches:
- Single coin: Click on a coin row to select it
- Multiple coins: Hold modifier key and click multiple rows
- Windows/Linux:
Ctrl+Click - macOS:
Cmd+Click
- Windows/Linux:
- Range: Click first coin, hold
Shift, click last coin - All coins: Select all
- Windows/Linux:
Ctrl+A - macOS:
Cmd+A
- Windows/Linux:
Start Search
- Click the Search & Enrich button (or press
F2) - NumiSync will search Numista for each selected coin
- Progress indicator shows current status
What happens:
- Searches using denomination, country, year, mint mark
- Handles variations (e.g., “Cent” vs “Cents”, “USA” vs “United States”)
- Supports non-Gregorian calendars (Meiji years, Hijri years, etc.)
- Uses cached results when available (faster!)
Step 4: Review Matches
Understanding Match Results
After searching, each coin shows one of three statuses:
- Match Found - Numista catalog entry found
- Multiple Matches - Several possibilities (manual selection needed)
- No Match - No catalog entry found (try manual search)
View Field Comparison
- Click on a coin with a match
- The Field Comparison Panel shows:
- Left column: Your existing data
- Right column: Numista catalog data
- Differences highlighted in color
- Review what will change
Step 5: Accept or Refine Matches
Accept All Changes
If the match looks good:
- Click Accept Match button (or press
Enter) - All Numista data updates your coin immediately
- Coin marked as enriched
Cherry-Pick Fields
To update only specific fields:
- In the Field Comparison Panel, uncheck fields you don’t want to update
- Click Accept Match
- Only checked fields will be updated
Choose a Different Issue
Many coins have multiple issues (years, mint marks, types):
- Click Choose Issue button
- Issue Picker Dialog shows all variants
- Select the correct issue for your coin
- Field comparison updates with that issue’s data
- Click Accept Match
Manual Search
If no match found automatically:
- Click Manual Search button or press:
- Windows/Linux:
Ctrl+F - macOS:
Cmd+F
- Windows/Linux:
- Modify search parameters (denomination, year, country)
- Click Search
- Browse results and select the correct entry
- Click Accept Match
Step 6: Download Images (Optional)
Automatic Image Download
If Data Settings → Images is enabled:
- Images download automatically when you accept a match
- Obverse, reverse, and edge images (if available)
- Stored in OpenNumismat’s image directory
Manual Image Download
- Select an enriched coin
- Click Download Images button
- Choose which images to download (obverse, reverse, edge)
- Click Download
Tip: Use Image Comparison to preview before accepting
Common Workflows
Workflow 1: Enrich a New Collection
- Open collection with many unenriched coins
- Select all coins (
Ctrl+A) - Click Search & Enrich (or press
F2) - Review matches one by one
- Accept matches as you go
- Use manual search for coins with no match
Time savings: 2-3 minutes per coin → 10-15 seconds per coin
Workflow 2: Update Pricing Only
- Go to Settings → Data Settings
- Uncheck Basic and Issue (leave Pricing checked)
- Select coins to update
- Click Search & Enrich
- Accept matches (only pricing updates)
Pro Tip: Get a Supporter License to use Fast Pricing Mode - updates all matched coins instantly!
Workflow 3: Fix Incorrect Matches
- Select a coin with incorrect data
- Click Manual Search
- Find the correct catalog entry
- Accept the match
- Old data is overwritten
Tip: Use Field Comparison to verify before accepting
Tips for Best Results
Search Tips
Best Practices:
- Start with coins that have complete information (year, country, denomination)
- Use standard denomination abbreviations (“1 Cent” not “1c”)
- Let NumiSync normalize denominations automatically
Avoid:
- Searching coins with missing critical fields (country, denomination)
- Manually editing search queries unless necessary
- Assuming first match is correct - always verify!
Data Quality
Best Practices:
- Review Field Comparison before accepting
- Use Issue Picker when multiple variants exist
- Verify images match your physical coin
Avoid:
- Blindly accepting all matches
- Overwriting good data with incomplete catalog data
- Forgetting to back up your collection first!
Performance
Best Practices:
- Enable caching (Settings → General → Cache)
- Work in batches of 10-20 coins
- Use Fast Pricing Mode for large updates (Supporter License)
Avoid:
- Searching 1000+ coins at once (respects rate limits, but slow)
- Disabling caching (wastes API calls)
- Searching the same coin repeatedly (use cache)
Keyboard Shortcuts
Windows/Linux:
Ctrl+O- Open collectionF2- Search & Enrich selected coinsCtrl+F- Manual searchEnter- Accept matchEscape- Cancel/Close dialogCtrl+A- Select all coinsCtrl+,- Open settingsF1- Open help
macOS:
Cmd+O- Open collectionF2- Search & Enrich selected coinsCmd+F- Manual searchEnter- Accept matchEscape- Cancel/Close dialogCmd+A- Select all coinsCmd+,- Open settingsF1- Open help
What’s Next?
Explore Premium Features
Get a Supporter License ($10) to unlock:
- Fast Pricing Mode - Batch update pricing for all matched coins
- Auto-Propagate - Apply type data to matching coins automatically
- No nag prompts!
Advanced Features
- Field Mapping - Customize how Numista data maps to your fields
- Batch Operations - Process hundreds of coins efficiently
- Multi-Machine Support - Share cache across devices
- Custom Cache Location - Store cache on network drive
Learn More
- User Manual - Complete feature documentation
- FAQ - Common questions answered
- Video Tutorials - Coming soon!
Need Help?
Common Issues
Q: Why didn’t my coin match?
- A: Country or denomination might need normalization. Try manual search with variations.
Q: Why are some fields not updating?
- A: Check Data Settings - some data categories might be disabled.
Q: Can I undo an accepted match?
- A: Not automatically. Restore from a backup or manually revert the data.
Q: How do I update pricing without changing other fields?
- A: Settings → Data Settings → Uncheck Basic and Issue, leave Pricing checked.
Q: What happens if I search a coin twice?
- A: NumiSync uses cached results (instant) unless you click “Refresh from API”.
Get Support
- Issues: Report on GitHub
- Discussions: Ask the community
- Documentation: Full docs