About
NumismatistHelper is an open-source collection management tool built specifically for numismatists — hobbyists and collectors of coins, banknotes (dollar bills), and coin sets. Developed with Java/Kotlin and backed by a self-hosted MySQL database, the application provides a structured and efficient way to catalog every item in a physical currency collection. Users can add individual coins, banknotes, and complete coin sets to their collection, attaching up to two images per item (front/obverse and back/reverse) for visual reference. Collections are displayed in a spreadsheet-style table view similar to Microsoft Excel, making it easy to browse and sort large inventories. Data can also be exported to CSV format for use in other tools or for backup purposes. The project is licensed under GPL-3.0 and available on GitHub, making it fully open source and community-extensible. It ships as a cross-platform JAR file, a Windows executable (.exe), and includes Linux support, so collectors on multiple operating systems can use it. A companion NumismatistAPI layer is also included in the repository for developers who wish to extend or integrate the functionality. NumismatistHelper is ideal for hobbyist coin collectors who want a self-hosted, privacy-focused solution to track their collection without relying on cloud services or subscription fees. It suits enthusiasts who are comfortable setting up a MySQL database and running a desktop application.
Key Features
- Coins, Banknotes & Sets: Add and categorize coins, paper banknotes, and complete coin sets as distinct item types in a single unified collection.
- Image Attachments: Attach up to two images per item (obverse and reverse) for detailed visual documentation of each piece.
- Table View & CSV Export: Browse the full collection in a spreadsheet-style table and export any view to a CSV file for external use or backup.
- Self-Hosted MySQL Database: All data is stored in a locally hosted MySQL database, giving users full control and privacy over their collection data.
- Cross-Platform Support: Available as a Windows .exe, a cross-platform .jar, and with Linux support, making it accessible on major desktop operating systems.
Use Cases
- A coin collector cataloging their entire coin collection with front and back images, organized by country, denomination, and year.
- A numismatist tracking the value and condition of banknotes in their paper currency collection.
- A hobbyist documenting complete mint coin sets received as gifts or purchased at auction.
- A collector exporting their inventory to CSV to share with insurance providers or for personal financial records.
- A developer extending the NumismatistAPI to build a custom front-end or integrate collection data with other applications.
Pros
- Completely Free & Open Source: Licensed under GPL-3.0, the tool is free to use, modify, and distribute with no subscription or licensing costs.
- Self-Hosted & Privacy-Focused: Data stays on the user's own machine or server via a local MySQL database — no cloud dependency or data sharing.
- Extensible via API: Includes a NumismatistAPI layer that developers can use to extend or integrate the functionality with other tools.
Cons
- Requires MySQL Setup: Users must install and configure a MySQL database server before using the app, which may be a barrier for non-technical collectors.
- No Mobile or Web Interface: The application is desktop-only with no accompanying mobile app or browser-based interface for on-the-go access.
- Limited Community & Support: As a small open-source project with 3 stars and no open issues/PRs, community support and ongoing development activity may be limited.
Frequently Asked Questions
What types of collectibles does NumismatistHelper support?
NumismatistHelper supports three types of collectibles: individual coins, banknotes (dollar bills/paper currency), and coin sets.
Is NumismatistHelper free to use?
Yes, NumismatistHelper is completely free and open-source under the GPL-3.0 license. You can download, use, and modify it at no cost.
What database does NumismatistHelper use?
NumismatistHelper uses a self-hosted MySQL database to store all collection data, giving users full control over their data.
Can I export my collection data?
Yes, the application allows you to export your collection tables to CSV format, which can be opened in spreadsheet applications like Microsoft Excel or Google Sheets.
What operating systems are supported?
NumismatistHelper supports Windows (via a .exe file), Linux, and any platform that runs Java (via the .jar file).
