tokyo-notes

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 53 Open GitHub ↗

Tokyo Notes is a beautiful markdown note-taking desktop application.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Tokyo Notes</h1>

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.

## Installation

<details>
<summary>macOS</summary>

Download the latest build from the [releases page](https://github.com/tanay1337/tokyo-notes/releases).

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](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac) the first time you run it.

</details>

<details>
<summary>Arch Linux</summary>

```bash
yay -S tokyo-notes-git
```

</details>

## Screenshots

**Editing Notes**

![Editing Notes](https://imglink.cc/cdn/o4fhsJKX3c.png)

</td>
<td width="50%">

**Dashboard**

![Dashboard](https://imglink.cc/cdn/6qB-Mik3E5.png)

</td>
</tr>
<tr>
<td width="50%">

**Knowledge Graph**

![Knowledge Graph](https://imglink.cc/cdn/RFk4ISjHU3.png)

</td>
<td width="50%">

**Diagram Editor**

![Diagram Editor](https://imglink.cc/cdn/Vm5ewhzaQZ.png)

</td>
</tr>
</table>

## 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.
- **Telegram Bot**: Forward messages, photos, and PDFs from Telegram directly into any note via a configurable bot. Supports owner-only filtering.
- **And Much More**: Themes, Archive System, Full-Text Search, Sakura Animations.

## 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](LICENSE)

tokyo-notes

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README