Megu — a desktop deck manager for Japanese vocabulary

Megu keeps one library of Japanese words on your own machine, files them into decks, and remembers which lesson each word came from. It is a Windows desktop app (Tauri + React), so the library is plain CSV in a folder next to the executable — nothing is uploaded anywhere.

The phone app lives in its own repository: KatrinSummer/Megu_phone — katrinsummer.github.io/Megu_phone. This desktop app is where the words are edited; the phone app is where they are reviewed with sound.

What it is for

Every lesson brings a new batch of words. Typing them into a flashcard app one by one is the boring part, and doing it twice creates duplicates. So:

• Import a lesson file (a TSV of the new words) and Megu shows, row by row, which words are new, which it already has, and which deck each one belongs in. Existing words gain the new lesson date instead of a duplicate card.
• Lesson history. Every card remembers every lesson it appeared in, and the table can be filtered down to one lesson.
• A 50-word review deck. "Last" is a list that points at cards living in the normal decks — a word can sit in Essential and in Last at once. Adding a 51st word marks the oldest one for replacement.
• Export a deck as AlgoApp XML (imports with no column mapping) or as plain CSV.

Run it

Download Megu.exe from Releases and double-click it. It writes its library into a library/ folder beside itself.

Build it yourself

Needs Node 20+ and the Tauri prerequisites (Rust and the WebView2 runtime, which Windows 11 already has).

npm install
npm run dev          # the app in a browser, on the sample deck, nothing is saved
npm run tauri dev    # the real desktop app
npm run tauri build  # builds Megu.exe under src-tauri/target/release
npm test             # the checks: export format, import rules, both UIs

The sample deck

The repository ships a 50-word sample library so the app has something to show — these are not anyone's real cards.

• sample-library/ — 50 words across Jpns Essential, Jpns Useful and the Last review deck, with three lesson dates.
• sample-lesson.tsv — a 12-word lesson to import: 8 new words and 4 the library already has, so the import screen has both cases to show.

To try the desktop app on it, copy sample-library/*.csv into the library/ folder next to Megu.exe. npm run dev already loads it.

Lesson files are tab-separated with the header:

Front	English	Kanji	Reading	Deck	Last

Deck names the deck the word should land in, Last is 1 if it should also join the 50-word review list.

Layout

src/            the interface (React + Mantine)
src/data/       the library, import rules and export formats
src-tauri/      the desktop shell, and the only code that touches disk
scripts/        the checks
docs/           screenshots

README_FIRST.txt is the user-facing guide, PROJECT_SPEC.txt the full description of how everything behaves.