MineralShelf

MineralShelf — Support

MineralShelf is built and supported by one person, and I'm always happy to help you get the most out of the app. The information below covers some of the basics of how MineralShelf works, but if you have questions about any of its features, please don't hesitate to reach out.

I'm also always looking for ways to make MineralShelf better. Whether you've spotted a bug, have an idea for a future feature, or have any other feedback or concerns, I'd love to hear from you. Every message is read by me personally, and I'll do my best to get back to you as soon as possible.

Email: support@mineralshelf.ca


When you write

If something isn't working as expected, a feature appears to be broken, or you've spotted a bug, please let me know. To help me understand what's happening and investigate the issue, please include the following four things in your email:

Please don't send a backup file unless I ask for one. If a backup is needed to investigate an issue, I'll delete it as soon as the problem has been resolved. See the Privacy Policy for details.


The questions that come up most

Where is my collection stored?

On your iPhone or iPad. There is no account and no server, so the only other copies are the backups you make (next question). That is also why the app works with no signal at the bottom of a quarry, and why I cannot see anything you have collected.

Then what happens if I lose my iPhone or iPad?

Two things can bring a collection back, and it is worth knowing both. Neither happens unless you have set it up, and I hold no copy of anything.

iCloud Backup includes MineralShelf, because the collection is stored in the app's own folder. Restore a new device from that backup and the collection comes back with it. Check it is on: Settings app › your name › iCloud › iCloud Backup.

Settings › Export Backup writes a .mineralshelf file — everything, optionally including photos — that you can keep in iCloud Drive, on a computer, or anywhere else. Do this from time to time. Settings shows when you last did, with a warning mark beside it once that is more than 30 days ago.

How do I move to a new iPhone or iPad?

Restore the new device from an iCloud or computer backup and the collection is already there. If you would rather move it by hand: Settings › Export Backup on the old one, save the file somewhere both can reach, then Settings › Import Backup on the new one.

I have an iPhone and an iPad. Is it one collection?

No. Each keeps its own, because there is no account and nothing is synced. To have the same collection on both, export a backup from one and import it on the other: importing can merge it with what is already there, or replace it. MineralShelf Pro is bought once. On the other device, Restore Purchases in Settings unlocks it under the same Apple Account.

The app won't open, or says my collection couldn't be opened

MineralShelf has not deleted anything: it does not remove your data by itself.

The screen you are looking at offers to restore from the copy of your records the app keeps for itself — it writes one on any day you open it — and tells you what is in it and when it was made. That copy holds no photographs, but your photographs are left where they are. Restoring puts the database that would not open aside rather than throwing it away, so trying it costs you nothing.

If that screen does not appear, restart the device first, then write to me and include what the screen says.

What does MineralShelf Pro include?

Unlimited specimens and expeditions, and the Market tools: market encounters, Quick Sell, Scan to Sell, sale records, show reports and the spreadsheet export. It is a one-time purchase, not a subscription.

The Market tools are for collectors who also sell some of their pieces at shows, and want a simple way to keep track of what they sold. They are not made for running a business: they take no payments and keep no books.

The free app holds 10 specimens and 2 expeditions, and includes the wishlist, labels, QR codes, posters, the Collector Score, and backup and export.

I have a code for Pro

Settings › Redeem a Code opens Apple's own sheet. Type or paste the code there and Pro unlocks as soon as Apple accepts it. If Apple says a code is not valid, it has usually expired or been used already — tell me which code and I will look into it.

Can I bring in a collection I already keep in a spreadsheet?

Yes. Export the spreadsheet as CSV from Excel, Numbers or Google Sheets, then Settings › Import from Spreadsheet. MineralShelf guesses what each column is, lets you correct the guesses, and shows every row it could not read before anything is added. It adds specimens; it never changes or removes ones you already have, and it keeps a safety copy of your collection first.

I already bought Pro and it isn't showing

Settings › Restore Purchases, with the same Apple Account you bought it with. If it still doesn't appear, tell me which Apple Account region you are in and roughly when you bought it.

Can I get a refund?

Refunds are handled by Apple, not by me — I never see your payment details and cannot reverse a charge. Ask at reportaproblem.apple.com.

Can I get my data out?

Yes, and without asking. Settings › Export Backup produces a plain ZIP file: open it on a computer and the photos are simply there in a folder, with the records beside them as JSON. Settings › Export to Spreadsheet writes your specimens, expeditions and wishlist as a real Excel workbook, or your specimens alone as a CSV file, without photos either way. Market encounters export in the same two ways.

How do I delete everything?

Settings › Erase Everything, at the bottom. It removes every specimen, expedition, wish, market encounter, sale and photo, along with the safety copies the app keeps for itself, and sets catalogue numbers back to #0001. It does not touch backup files you have already exported. Deleting the app also removes everything it stored.

How do the printed labels work?

A label with a QR code holds a link to that specimen. Scan it on your own iPhone or iPad, with the MineralShelf scanner or the Camera app, and the specimen's page opens. The link is tied to an identifier created once and kept through edits, exports and restores, so a label printed today still works after you move your collection to a new device.

The code holds nothing but that identifier — no name, no price, no locality — and on a device that does not hold your collection it opens nothing. The words printed beside it are the details you chose in the label maker, so a label says exactly what you can read on it. Choose QR only for one that says nothing.

Which devices does it run on?

Any iPhone running iOS 18 or later, and any iPad running iPadOS 18 or later.

An Android version is planned, with no date attached. It is an intention, not a promise, and nothing here should be bought on the strength of it.


Things it deliberately doesn't do

Worth knowing before you write to ask: