Help
The Oma Archive is a private recipe book. You search recipes by ingredient, keep your own collection, and choose whether other signed-in people can see it.
Finding a recipe
Type an ingredient and press Find recipes. Add another, and the list keeps only recipes that contain every ingredient. Bourbon and bourbon are the same word. Lime is found inside “fresh squeezed lime juice,” and it is not found inside ginger or limoncello.
The name you get back is the heading of the recipe, not the file name. Open a result to read it, star it, or download the original file.
Browse lists every recipe by that title, A to Z. A shelf limits the list to one category. A word limits it to titles that contain that word, or, if you ask, to the ingredients as well.
The shelves are the same for everyone: Mains, Drinks, Vegetables & Sides, Desserts & Baked Sweets, Sauces, Dips & Dressings, Breads, Soups & Stews, and Charts, Hints & Tips. A shelf you have nothing on stays out of the way. Unsorted holds recipes The Oma Archive couldn't place, and appears only when it has some.
Your recipes and the shared library
Recipes you upload belong to your account. They are private until you turn on Share my recipes with everyone on Preferences.
That control is a switch. On, your recipes join the library every signed-in person can search. Off, they are removed from that shared library at once. They are not deleted. You can still search them, and you can turn sharing back on later.
Adding recipes
On Upload, add a Word file, PDF, text file, spreadsheet, a photo of a card, or a zip of many of those. The Oma Archive picks a shelf for each recipe from its text. You can change it any time. Add one file with a clear shelf and you land on the recipe, with the Shelf menu right there. Add several, or a zip, or anything The Oma Archive couldn't place, and you get a list titled Check the shelves, with a shelf menu on every row that saves as soon as you pick. Recent uploads, at the foot of Search and Browse, lists your uploads again. A spreadsheet of several drinks is split into one recipe each. A photograph or a scanned PDF is read so the ingredients can be searched (hard handwriting is covered further down). The original file is kept either way.
Two-sided cards. If a card has writing on the back, photograph both sides and name the back like the front with _b added, for example card12.jpg and card12_b.jpg. Upload them together, in the same upload or the same folder of a zip. They save as one recipe with the front first and the back after it. Both must be JPEG photos (.jpg or .jpeg). A back with no front in the upload saves on its own.
On Preferences, AI-assisted OCR lets photos and scanned pages that are hard to read be sent to Google to read hard handwriting. The text that comes back is a transcript, not a rewrite. Turn it off and no page is sent, unless you say yes to Try better reading on a recipe. Each account decides this for its own recipes.
When a recipe's text came out poor, its page shows Try better reading to its owner. It sends only the pages of that one file to Google and keeps the original. If that switch is off, the button asks first, and saying yes turns it on. The new text replaces the old only when it is longer, and never over text you edited yourself. Only the account that owns a recipe can press it; an admin looking at your library cannot.
Deleting and starting over
Deleting a recipe moves it to Recently deleted, linked at the bottom of Search and Browse. It leaves search, browse, and library downloads at once, for you and for anyone you share with. It stays in Recently deleted for 30 days. Restore it there and it comes back exactly as it was, on the same shelf with the same name and file. If you already have a recipe with that name on that shelf, you are told, and both are kept.
After 30 days, or sooner if you choose Delete now or Empty now, the recipe is deleted for good, along with its stars. Its original file is deleted too, unless another recipe still uses it.
To start over with a cleaned-up collection, use Clear my entire library on Preferences. Every recipe you uploaded moves to Recently deleted, where one button restores them all for 30 days. Sharing is turned off. Your account stays. You can download your library first, and you type CLEAR to confirm so it can't happen by accident.
The library is backed up every night, with a second copy kept elsewhere. A deleted recipe can stay in those backups for a while after it is deleted for good.
How your data is kept
- Invitation only. An admin creates each account. There is no public sign-up, and a recipe page is not open to someone who is not signed in.
- Passwords are hashed. The app stores a salted scrypt hash. It does not keep the password itself. An assigned password asks you to set your own.
- The sign-in cookie is locked down. It is HttpOnly, so a page script cannot read it, and SameSite, so another site cannot send it. On https://theomaarchive.com, the cookie is marked Secure and the browser sends it only over an encrypted connection.
- Changes require a session token. Forms that save, upload, or delete include a token tied to your sign-in, so another site cannot submit them for you.
- Repeated wrong passwords pause sign-in. Too many failures from the same network or username wait a few minutes before another try.
- Private means hidden. Until you share, other people cannot open a recipe, download its file, or include it in their library download. The download contains only recipes you are allowed to see: yours, plus any that other people are currently sharing. Recipes in Recently deleted are left out.
- Admins can help. An admin can open your library as you see it to help you, and every time they do, it is logged.
- Files are kept by The Oma Archive, not in the browser. The one exception is the Google reading described under Adding recipes: if its switch is on for your account, a photo or scanned page that is hard to read can be sent to Google. Sharing does not email anyone and does not publish the library on the open web.
You reach this book at https://theomaarchive.com. That is only the address. The book itself is The Oma Archive.
What's new
- November 21, 2026. Upload no longer asks you to pick a shelf. The Oma Archive picks one for each recipe from its text, and shows a Check the shelves list after a bigger upload, so you can fix any that look wrong. Zip folder names no longer decide shelves. Recent uploads, at the foot of Search and Browse, brings the list back.
- November 21, 2026. Three shelves have new names: the main-dish shelf is now Mains, the vegetable shelf is now Vegetables & Sides, and the condiments shelf is now Sauces, Dips & Dressings. Every recipe stayed where it was. Change a recipe's shelf with the Shelf menu on its page.
- November 11, 2026. On Search, the cursor stays in the ingredient box after you press Enter, so you can type the next one straight away. On a phone you may still need to tap the box.
- November 11, 2026. Recipes you upload keep the name of your file, on the recipe page, in search results, and when you download the original. Uploads that showed a name like tmp11o9mw_q.docx now show their real names.
- November 10, 2026. A Getting Started page appears when you sign in, with a short tour of the book. Check Do not show this again when you no longer need it.
- November 10, 2026. The password boxes on Sign in and Account have an eye button. Tap it to see what you typed, and tap again to hide it.
- November 10, 2026. If a sign-in page has been left open too long, or you come back to it on your phone, signing in no longer shows an error. The page refreshes and asks you to sign in again.
- November 9, 2026. Search by one ingredient or several. Choose Every ingredient to narrow the list, or Any ingredient to widen it, and pick a shelf to search just that category.
- November 9, 2026. Browse every recipe by title, A to Z, and narrow it by shelf or by a word in the title or the ingredients.
- November 9, 2026. Fix a recipe's name on its page if the heading came out wrong, and star the ones you like.
- November 9, 2026. The Share my recipes with everyone switch on Preferences lets you share your collection, or make it private again, at any time.
- November 9, 2026. Upload photos of recipe cards and scanned PDFs. The text is read automatically so the ingredients can be searched.
- November 9, 2026. Download one recipe's original file, or a zip of every recipe you can see plus a spreadsheet index.