Repository navigation
Releases
Releases · cchabanois/notosaurus
Notosaurus 1.1.1
Changed
- The Android app's privacy policy says how to have your data deleted, step by step, and what is deleted or kept.
- The Android app's privacy policy says what this version does: the lesson's drawings cut out of its photos, a child's class sent with their lessons (never their first name), backups, the background notification, the QR code read by Google Play services.
Fixed
- On a narrow phone, a lesson's one page is shown beside the add buttons again, not under them.
Notosaurus 1.1.0
Added
The Android app
- 📱 Notosaurus on Android: a lesson photographed, its cards made and sent straight to AnkiDroid, no computer needed. The AI is the Notosaurus service's (no key to get), with a subscription through Google Play, by the month or the year, restored by itself on a new phone. Or, for free, the app shows the computer's page (the Anki add-on): scan its QR code.
- 🎁 A free trial without a card, once per phone: it starts with the first lesson.
- The cards in AnkiDroid are the computer's: the same note types, so a lesson sent from the phone or from the computer is the same notes, never added twice. Natural voices (Google Chirp 3 HD), pictures and figures, dictations, typed answers, reversed cards, multiple choice, texts with gaps and diagrams with their labels hidden.
- 🎤 Instructions and corrections by voice, written down as you meant them (hesitations out, "ten, no, twelve" → twelve), then read over.
- 📚 A lesson reviewed in AnkiDroid right after it is sent; Open AnkiDroid in the top bar.
- The app follows the phone's dark mode; Android's back button closes the open sheet first.
Making a lesson
- ⚡ Quick or 🎯 Careful: quick by default, 2 to 4 times faster and cheaper; careful for a rich lesson (a diagram, maths). After a quick lesson, Make again, carefully.
- The cards show as the AI writes them, the waiting card says what the AI is at, and Cancel stops it.
- ➕ A page added to a lesson days later: the AI reads only the new pages; the cards made already, and their notes in Anki, stay as they are.
- 🖍️ On a photo not sent yet, black out with a finger what the AI shouldn't see (a name, a school).
- ✨ Tidy up rewrites the instructions clear and short, nothing added; ↩ Undo brings them back.
- The lesson in progress is never lost by leaving the page: its photos and prompt are found again.
- On a computer, photos and PDFs dragged from a folder onto the page.
Notosaurus's prompts
- New: Dictation, Gap dictation, By heart (a poem, a recitation, line by line), Recognise from an example, Dates and landmarks (learned both ways), Table to learn, Definitions and properties (a theorem's name → its full statement, and its converse when the lesson gives it), Language: conjugation, Methods (steps). Automatic recognises each of these kinds of page.
- Any prompt can ask for the reverse card, the backs read aloud, slow or normal speed, no pictures, no helps.
Cards
- ✨ Correct this card (a card's ⋯): say what's wrong ("the answer is 1789", "shorter"), typed or dictated, and the AI rewrites that card alone; ↩ Undo. A card just added, still empty: Write with the AI.
⚠️ A lesson that looks wrong (a pupil's notes, a copy mistake: a wrong date, name or number) is said on its card, with the correction to take or not; never sent to Anki.
Pictures and figures
- One ✨ Image button, the cheapest first: a drawing from the lesson's own page cut out of the photo (35 right out of 36 on 11 lessons); else a free picture (Wikimedia Commons, Openverse; Pixabay in the app), with no credit to give and filtered for pupils, the best ones first; drawn by the AI only once you say yes.
- Figures drawn in Typst with the package made for each kind: geometry (marks and angles computed), graphs computed from their function, sets, diagrams, circuits, chemistry, timelines. 🔍 under a figure has the AI check it and redraw it when it's wrong.
- Each picture says where it comes from (its source, licence and page), and each figure what drew it, crediting the open-source projects behind it.
Into Anki
- ✎ Notosaurus under every answer in Anki: the card opened in Notosaurus to correct it, in the app on Android or in the page on the computer.
- 🔊 Add to Anki is quicker (the sounds made in the background beforehand) and says how far it is. A lesson not changed since its send says ✓ Up to date in Anki.
- After a send, the cards in Anki that no longer match the lesson are listed, deleted only on Delete from Anki.
Tests to prepare
- 📌 A lesson, whole or some of its cards, added to a test (a name, a date): its cards tagged in Anki, and its sheet says how to review them all (custom study, a filtered deck). On the computer, Revise now in Anki makes the filtered deck; on Android, Open in AnkiDroid. The lessons not in Anki yet are sent from the test's sheet.
Children and settings
- 🧒 Children: a card each, with a first name, a class typed freely (another country's, Prépa, university…), its decks and instructions for the AI. The AI is told the class and the instructions, never the first name. The next lesson is for the child chosen.
- 💾 Back up or move my lessons: every lesson in one file (photos, cards, pictures, sounds), with the children, the tests and your prompts, no key or password; imported on another computer or in the Android app. A lesson's cards already in Anki are found again, never added twice.
- About: Notosaurus is free software (AGPL-3.0), with the privacy policy and the libraries' licences.
For developers
notosaurus-core(incore/): the AI and card logic as a package of its own. The Notosaurus relay's API,core/relay-api-v1.json, is frozen for each released app (core/relay-api-releases/), and a test refuses a change that would break one.- The Android app in
android/, built and tested with the same page; device tests with real AnkiDroid (on Mondays, several of its versions side by side). - Notosaurus's prompts and the AI's fixed rules in files of their own:
static/prompts/<lang>/,core/notosaurus_core/rules/,core/notosaurus_core/typst_rules/. NOTOSAURUS_PICTURE_SERVICEandNOTOSAURUS_PICTURE_MODEL(.env) give the pictures' service and model by default (Docker).
Changed
- The Anki note types and their cards are named in English, the same whatever the app's language: "Notosaurus front/back (audio) v2", "Front → Back"… (they were French everywhere). On the computer, a 1.0.0 lesson's notes move to them at the next send, their review history kept.
- A card's note in Anki is found by the card itself, never by its front: a corrected front, two cards with the same front, or dictations without a sentence each keep their own note, and a package imported again after a correction updates the card instead of duplicating it. A lesson made again keeps the notes of the cards that stay the same. Lessons sent with 1.0.0 come into Anki anew, once, the next time they are sent.
- The button under the prompt says what it does: "See the instructions" for Notosaurus's own, "Save the changes" for one of yours once its text is changed (saved into it at once), "Edit instructions" otherwise.
- Once a lesson's cards are made, step 2 (the prompt) folds to one line, its prompt and speed, so the cards come first; ✏️ Change opens it. Its buttons stay in view, and a prompt changed since the cards were made says it isn't applied until they are made again. Step 3's "Prompt used for this lesson" is gone: the folded line says it.
- A picture can be on any card in Anki, no longer on a card of its own: a dictation, a reversed or typed card keeps its picture. Anki asks for a full sync once. The picture cards sent by 1.0.0 are sent again as new notes; the old ones are offered for deletion (their review history isn't kept).
- A photo is kept as taken, no longer turned upright by guess (sometimes upside down): ↻ turns it.
- Pictures where they truly help (a work of art, a person, a place, an animal), never on every card; a picture that would give the answer away goes on the back. Settings → Instructions for the AI → 🖼️ Pictures on the cards turns them off.
- Every card says its deck above its question, small (the subject and the lesson). A front that allows another right answer says what tells it apart.
- Only short answers are typed (a word or two); a definition or a sentence is said in one's own words.
- Did you know? and the helps on the back are settings (on by default), no longer switches under the prompt. The Add the reverse card switch is gone: how the cards are asked comes from the prompt, and can be changed in the correction ("one way only").
- The voices are slowed only for a language being learned and for dictations.
- The review's cards are a third shorter: their buttons on the front's line, Report and Delete behind ⋯.
- The page speaks of children, not of Anki profiles.
- The big button at the bottom is always the next action: photograph the lesson, generate the cards, or generate from the prompt alone once it says what to learn.
- Notosaurus's prompts reviewed: none imposes French or English any more, and each lesson gets a deck of its own.
- The AI only makes learning material suited to pupils; anything else is refused with a clear message. Lessons on hard topics (history, biology, health) still work.
- The pages load nothing from elsewhere (no CDN, no Google Fonts): they work offline, and no third party sees their visits.
- Gemini not answering is given up on after 45 s for the next model, instead of waiting forever.
Fixed
- In the Android app, a lesson whose cards were sent to AnkiDroid with an older Notosaurus note type updates those notes, their review history kept, instead of adding each card again and offering the old ones for deletion. AnkiDroid can't change a note's type, so they keep theirs.
- A lesson made again keeps the notes and review history of its cards in Anki when the AI writes a card's question otherwise but its answer is the same and the lesson's only one, a dictation's word for instance: they became new cards, the old ones offered for deletion.
- An Anki package (.apkg) made by 1.1.0 imports beside 1.0.0's note types, where Anki 2.1.4x refused its notes ("the note type changed").
- A card the AI corrects no longer takes another card's history ...
Notosaurus 1.0.0
The first version.
Added
From a lesson to cards
- Photos of a lesson (handwriting included, pages taken sideways straightened), a PDF (its text read exactly) or the instructions alone: a vision AI drafts the cards. Gemini, Claude, GPT, OpenRouter or a local model.
- Instructions for each kind of lesson, ⭐ "Automatic" choosing the cards from the page; your own saved instructions, or written for one lesson; standing instructions per child ("in year 8").
- Card types: questions and answers, fill in the blanks, multiple choice, true or false, vocabulary and sentences of a language, formulas, geometry with exact figures, diagrams with their labels hidden, pictures drawn by an image model, typed answers and dictations.
- Helps on the back where they help (why the answer is right, a genuine way to remember it), optional "Did you know?" facts, and 💬 an explanation of any card while reviewing.
- Review: edit, add or delete cards, fix them in plain words with the AI, generate again, undo.
- Natural audio of the backs, in the deck: it plays everywhere, even offline.
Into Anki
- An Anki add-on: Notosaurus starts with Anki, installs its components after asking (about 300 MB, once), and a setup assistant guides the first steps (the AI and its key, then the phone).
- Sent straight to Anki and synced, updated without duplicates; or an
.apkgfile. Each lesson has its own deck, under the subjects already there.
For families
- One Anki profile per child, each with their own lessons, shared or not; the lessons grouped by subject, with a search.
- Only the phones that scanned the QR code use Notosaurus; the settings open on the computer only.
- What each lesson cost, call by call.
Settings, languages, help
- Recommended models for each service, from our tests on real notebook pages, with what a lesson or a picture costs; a test for the AI and for the pictures. A free Gemini key works, with an older model.
- The app, its instructions and the add-on in English, French, Spanish, German, Italian and Portuguese (Brazil); the documentation in English and French (https://cchabanois.github.io/notosaurus/).