Tokyo Notes 🌸

Tokyo Notes is a beautiful markdown note-taking app that combines interactive diagrams, flashcards, a task dashboard, knowledge graph, encrypted private notes, and git backed version history in an offline-first desktop application.

Screenshots

Editing Notes	Dashboard
Knowledge Graph	Diagram Editor

Features

• Task Management: Dashboard with Today, Week, and All views, featuring deadline tracking and jump-to-line navigation.
• Private Notes: AES-256-GCM encrypted notes with per-file salt, Argon2id key derivation, and inactivity auto-lock.
• Knowledge Graph: Visualize and navigate connections between your notes.
• Templates: Create notes from reusable templates with auto-filled variables like {{today}}, {{now}}, {{time}}, and {{weekday}}.
• Version History: Automatic save-points, manual snapshots, and one-click restore from any previous version via Git.
• Flashcards: Extract Q/A cards from flashcard codeblocks and flip through them to review. See format below.
• Diagrams: Create, edit, and embed interactive node diagrams directly in your notes.
• Offline Dictation: Optional speech-to-text dictation powered by faster-whisper that runs fully offline.
• And Much More: Themes, Archive System, Full-Text Search, Sakura Animations.

Installation

macOS

Download the latest build from the releases page.

Two builds are available:

• Tokyo-Notes-Standard-macOS-arm64.zip: Standard build without dictation.
• Tokyo-Notes-Dictation-macOS-arm64.zip: Includes offline speech-to-text dictation (larger download).

Note: The app is not notarized, so you'll have to allow it from the System Settings the first time you run it.

Arch Linux

yay -S tokyo-notes-git

Others

Requires Python 3.12+, PyGObject, GTK4, Libadwaita, poppler, and Git.

# After installing dependencies mentioned above and from pip
git clone https://github.com/tanay1337/tokyo-notes.git
cd tokyo-notes
python3 main.py

Smart Syntax

• Slash Commands: Type / to open a command palette for inserting headings, lists, code blocks, and more.
• Deadlines: Type @ to open a date/time picker for task deadlines.
• Note Links: Type [[ to pick a note to link to.
• Lists: Press Enter on a list item to automatically continue the list. Press Enter twice to discontinue the lists.
• Task Markers: Press Enter on a task - [ ] to create a new unchecked task.

Flashcards

Here's the format to create flashcards in your notes.

```flashcard
Question
---
Answer
```

License

MIT License