A lightweight, high-performance, and offline-first CLI tool designed specifically for lapidaries,
gem cutters, and mineral enthusiasts worldwide.

This program is free for everyone. It was created with a specific focus on the global lapidary community.
Many talented cutters operate in Asian countries or developing regions where high-end hardware,
stable internet, and modern software environments aren't always available.

To ensure maximum accessibility, this tool is:

-Written in DOS/Batch: Requires zero installation. No Python, no Java,
 no complex environments. If you have a PC, it runs.

-Offline First: The entire mineral database is stored locally.
  Internet is only required if you choose to use the optional Web Resources.

-Ultra-Lightweight: It takes up virtually no disk space and can run on even the oldest machines.

-Smart Search: Features an "Auto-Open" function. If your search (e.g., "Hac")
 matches only one mineral (e.g., Hackmanite), it opens the data sheet immediately.

-Mineral Database: Currently includes 250 minerals, with plans for continuous expansion.

-Integrated Web Dashboard: A categorized hub for Prospection (maps), Faceting (designs),
  Market Prices, and Technical Education.

-Technical Specifics: Each entry follows a rigorous template including chemical formulas,
  hardness, refractive index, and cutting suggestions.

Each mineral in the database provides detailed technical specifications
essential for identifying and working with the stone:

-Chemical & Physical: Name, Formula, Crystal System, Hardness, and Specific Gravity.

-Optical Properties: Refractive Index, Birefringence, Optical, and Refraction type.

-Workability: Cleavage, Fracture, and suggested Cuts (Cabochon vs. Faceted).

-Geology: Primary Sources and known Phenomena or Treatments.

You can download the version 1.0 here:

Download GemstoneDB v1.0

Note: The .exe version is a standalone file with the database already embedded.

For .EXE users: Simply download and run the executable.

For .BAT (Source) users:

1. Download the repository.

2. Important: Ensure the data folder is in the same directory as the .bat file.

3. Run GEMSTONE_DATABASE.bat.

We are committed to growing this tool for the global community. Our future goals include:

[ ] Expansion to 500+ mineral files.

[ ] Integrated Hydrostatic Scale Calculator for Specific Gravity.

[ ] Carat-to-Gram and Weight estimation converters.

[ ] ASCII visualization of Crystal Symmetry systems.

v1.0 (Current): Launch with a database list of 250 minerals. Includes Smart Search (Auto-Open logic),
expanded Web Dashboard (Instrumentation & Software), and improved input normalization for spaces and hyphens.

We welcome contributions from the community!

Option 1 (Technical): Fork the repository and submit a Pull Request. Use the provided template.txt to ensure your new entries match our format.

Option 2 (Email): Send mineral data or specific requests to: [email protected]

Created for the global lapidary community. Keep cutting!