FaNotes

One calm workspace for typed notes, handwriting, worksheets and mathematics.

Eine ruhige Arbeitsfläche für getippte Notizen, Handschrift, Arbeitsblätter und Mathematik.

Website · Web app · Downloads · English

Deutsch

FaNotes verbindet eine echte Markdown-Wissensbasis mit einer papierartigen Schreibfläche. Tastatur, Grafiktablett, Bilder, PDFs und Formeln leben in derselben Notizansicht. Deine Notizen bleiben offene Dateien in einem frei wählbaren Vault; die Handschrifterkennung arbeitet lokal und kann mit deinen eigenen GlyphenWerk-Beispielen personalisiert werden.

Was FaNotes besonders macht

• Eine gemeinsame Seite: Tippen, zeichnen und handschriftlich schreiben, ohne zwischen Editor und Vorschau zu wechseln.
• Offene Markdown-Dateien: Ordner, Wikilinks, Aufgabenlisten, Tabellen, Code, Mathematik und einklappbare Bereiche.
• Handschrift und Mathematik: Lokale Zeilen- und Glyphenerkennung für Text, Gleichungen, Brüche, Wurzeln, Indizes, Summen und Integrale.
• GlyphenWerk integriert: Eigene Zeichen erfassen, ZIP-Trainingsdaten importieren, Erkennung testen und Korrekturen direkt weiterlernen.
• Arbeitsblätter: PDF- und Bildseiten in neue oder bestehende Notizen importieren und mit Tastatur oder Stift ausfüllen.
• AI nach Wahl: LM Studio, Ollama, OpenAI, Gemini, Anthropic und OpenCode mit kombinierbaren Aktionen.
• Für jeden Lebensbereich: Profile und Vorlagen für Schule, Universität, Privatleben und Arbeit.
• Desktop, Web und Tablet: Linux, Windows, eine installierbare Web-App und ein nativer Android-Tablet-Client mit gemeinsamer Vault-Struktur und Sync.
• Anpassbar: Themes, Schriften, Papier, Pinsel, Farben, Abstände, Ressourcenlimits und eigenes CSS.
• Privat by design: Vault und persönliches Handschrifttraining bleiben lokal; ein abgesichertes Server-Backup ist optional.

Downloads und Update-Kanäle

Kanal	Zweck	Veröffentlichungen
Stable	Gebündelte, vollständig geprüfte Alltagsversion	2 bis höchstens 4 pro Monat
Beta	Früher Zugriff auf einzelne neue Funktionen und Korrekturen	nach Bedarf, als GitHub-Prerelease markiert

Der Kanal lässt sich unter Einstellungen → Updates → Update-Kanal ändern. Stable-Nutzer erhalten keine Vorabversionen. Beta-Nutzer erhalten neue Betas und wechseln automatisch auf einen neueren Stable-Stand, sobald dieser verfügbar ist. Ein Wechsel zurück zu Stable führt niemals zu einem erzwungenen Downgrade.

Ab der Kalender-Versionierung tragen Releases Namen wie 2026.7.1 und Betas Namen wie 2026.7.2-beta.1. Alle Update-Manifeste sind Ed25519-signiert; Pakete und differentielle Updates werden zusätzlich per SHA-256 geprüft.

Die aktuelle Version findest du unter GitHub Releases. Die Produktseite bietet zusätzlich direkte Downloads und Installationshinweise für Linux und Windows.

Lokal entwickeln

Voraussetzungen: Node.js 22+, npm, Linux oder Windows. Für Desktop-Pakete werden die plattformspezifischen Electron-Abhängigkeiten benötigt.

# GlyphenWerk
npm install
npm run dev

# FaNotes Desktop/Web
cd fanotes
npm install
npm run dev          # Electron + Vite
npm run dev:web      # Browser-Ausgabe

Wichtige Prüfungen:

cd fanotes
npm run typecheck
npm run check:updater
npm run check:i18n
npm run check:connected-recognition

Repository-Aufbau

src/                  GlyphenWerk-Oberfläche und gemeinsame Erkennungsengine
fanotes/       FaNotes React-/Electron-/Web-App, Tests und Packaging
fanotes-site/         Produktwebsite, Update-API, AI-Proxy und Backup-Dienst
android/              Nativer Android-Tablet-Client (Kotlin, Jetpack Compose)
deliverables/         kleine, veröffentlichbare Begleitdateien

Android-Tablet

Der Client unter android/ ist eine native Schreibfläche für Tablets (S-Pen: Druck, Neigung, Radierer; die Hand blättert). Notizen bleiben .md plus .famd und synchronisieren mit dem bestehenden Konto. Bauen und der Formatvertrag stehen in android/README.md und android/ARCHITECTURE.md.

cd android
./gradlew :core:test
./gradlew :app:assembleDebug

Erzeugte Builds, node_modules, private Schlüssel, lokale Vaults, Analytics und Server-Backups gehören nicht in Git. Release-Binärdateien werden vollständig und mit Prüfsummen an den jeweiligen GitHub-Release angehängt.

Datenschutz und Sicherheit

• Keine Anmeldung ist für lokale Notizen erforderlich.
• Markdown-Vault, Zeichnungen und persönliches Training werden standardmäßig nur auf dem Gerät gespeichert.
• Cloud-AI wird ausschließlich verwendet, wenn du einen Anbieter selbst konfigurierst.
• API-Schlüssel werden in der Desktop-App über den geschützten Systemspeicher abgelegt.
• Update-Manifeste, Paketgrößen, Dateinamen, Herkunft, Signatur und SHA-256 werden vor der Installation geprüft.
• Das optionale Server-Backup akzeptiert nur begrenzte FaNotes-Daten und neu validierte Medien; aktive PDF-Inhalte und unbekannte Dateitypen werden blockiert.

English

FaNotes combines an open Markdown knowledge base with a paper-like writing surface. Keyboard input, pen strokes, images, PDFs and formulas live on the same note page. Notes remain ordinary files inside a vault you control, while local handwriting recognition can be personalized with your own GlyphenWerk samples.

Highlights

• One continuous page for typing, drawing and handwriting—without separate edit and preview modes.
• Open Markdown files with folders, wiki links, tasks, tables, code, mathematics and collapsible sections.
• Local handwriting and math recognition for text, equations, fractions, roots, indices, sums and integrals.
• Integrated GlyphenWerk for capture, ZIP import, recognition tests and correction-driven personal learning.
• PDF and image worksheets that can be completed with the keyboard or a drawing tablet.
• Provider-neutral AI through LM Studio, Ollama, OpenAI, Gemini, Anthropic or OpenCode.
• Profiles for school, university, personal use and work.
• Linux, Windows, an installable web app, and a native Android tablet client with the same vault files and sync.
• Deep customization for themes, fonts, paper, brushes, colors, spacing, resource limits and custom CSS.
• Private by design: local vault and local personal training, with an optional hardened server backup.

Stable and Beta

Stable builds bundle thoroughly tested changes into two to at most four releases per month. Beta builds deliver focused changes earlier and are marked as prereleases on GitHub. Choose the channel under Settings → Updates → Update channel. Returning from Beta to Stable never forces a downgrade.

Calendar versions use names such as 2026.7.1; previews use names such as 2026.7.2-beta.1. Update manifests are signed with Ed25519, and all full or differential packages are verified with SHA-256 before installation.

Download the latest build from GitHub Releases, open the web app, or visit the product website for platform-specific installation help.

Develop locally

Requirements: Node.js 22+, npm, and Linux or Windows. Desktop packages also need the platform-specific Electron dependencies.

# GlyphenWerk
npm install
npm run dev

# FaNotes desktop and web
cd fanotes
npm install
npm run dev          # Electron + Vite
npm run dev:web      # browser build

Useful checks:

cd fanotes
npm run typecheck
npm run check:updater
npm run check:i18n
npm run check:connected-recognition

Repository layout

src/                  GlyphenWerk interface and the shared recognition engine
fanotes/              FaNotes React, Electron, and web app, tests, and packaging
fanotes-site/         Product website, update API, AI proxy, and backup service
android/              Native Android tablet client (Kotlin, Jetpack Compose)
deliverables/         Small publishable companion files

Android tablet

The client in android/ is a native writing surface for tablets (S-Pen pressure, tilt, and eraser; the hand navigates). Notes stay .md plus .famd and sync with an existing account. Build steps and the format contract are in android/README.md and android/ARCHITECTURE.md.

cd android
./gradlew :core:test
./gradlew :app:assembleDebug

Generated builds, node_modules, private keys, local vaults, analytics, and server backups do not belong in Git. Release binaries are attached in full, with checksums, to the matching GitHub release.

Privacy and security

• Local notes do not require an account.
• The Markdown vault, drawings, and personal handwriting training stay on the device unless you opt in.
• Cloud AI is used only when you configure a provider yourself.
• The desktop app stores API keys in the protected system store.
• Update manifests, package sizes, file names, origin, signature, and SHA-256 are checked before installation.
• The optional server backup accepts only bounded FaNotes data and revalidated media. Active PDF content and unknown file types are blocked.

License

FaNotes source code is available under the MIT License. Bundled models, fonts, dictionaries and third-party components retain their respective licenses; see THIRD_PARTY_NOTICES.md.