docs: improve NoteSpaceLLM discoverability

Lukas Geiger · Lukas Geiger · commit 115f6cc63a04 · 2026-05-28T12:19:03.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,7 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 - Portierungsplan für Windows Store, Web/PWA, Android, iOS, macOS und Linux
 - Geplantes Austauschformat `notespacellm-workspace-v1.json` für Desktop-zu-Companion-Workflows
 - Erster Web/PWA-Companion unter `web_companion/` mit lokalem Workspace-Import, read-only Bericht-/Dokumentansicht und Export für Review-Notizen
+- README-Screenshot und SEO-Metadaten für den Web/PWA-Companion
 - Remote-Ollama-Anbindung: Konfigurierbare Server-URL pro Projekt
 - API-Key-Authentifizierung für Ollama-Proxies (Bearer Token)
 - GUI: URL- und API-Key-Felder im LLM-Einstellungsdialog
diff --git a/README.md b/README.md
@@ -4,6 +4,46 @@
 
 # NoteSpaceLLM
 
+**Local NotebookLM alternative for private document analysis, RAG-assisted research, and multi-format report generation.**
+
+NoteSpaceLLM is an offline-first PySide6 desktop app for working with PDFs,
+Word files, Markdown, mail exports, notes, and research folders. It keeps
+project data local by default, supports local or remote Ollama, OpenAI,
+Anthropic and Claude Code workflows, and exports analysis results to Markdown,
+PDF, DOCX, HTML and TXT. A lightweight Web/PWA Companion is now available for
+reviewing exported workspaces on Android, iOS and browser devices without
+uploading documents to a server.
+
+**Best-fit searches:** NotebookLM alternative, local RAG document analysis,
+private document chat, PySide6 research tool, offline AI report generator,
+local-first document workflow.
+
+## English quick start
+
+```bash
+git clone https://github.com/file-bricks/NoteSpaceLLM.git
+cd NoteSpaceLLM
+pip install -r requirements.txt
+python main.py
+```
+
+Run the test and compile smoke checks with:
+
+```bash
+python -m unittest discover -s tests -v
+python -m compileall -q main.py manage_translations.py translator.py src
+cd web_companion
+node --test tests/library.test.mjs
+```
+
+## Screenshots
+
+![NoteSpaceLLM desktop main window](README/screenshots/main.png)
+
+![NoteSpaceLLM Web/PWA Companion](README/screenshots/web-companion.png)
+
+## Deutsch
+
 Ein lokaler, datenschutzfreundlicher Ersatz für Google NotebookLM zur Dokumentenanalyse und Berichterstellung.
 
 ## Features
@@ -21,7 +61,7 @@ Ein lokaler, datenschutzfreundlicher Ersatz für Google NotebookLM zur Dokumente
 - **Umlaut-sichere Oberfläche**: Deutsche UI-Texte verwenden echte Umlaute; der Übersetzungs-Scan vermeidet englische False Positives
 - **Profile**: Wiederverwendbare Ausgabeformat-Kombinationen
 
-## Screenshot
+## Desktop-Screenshot
 
 ![NoteSpaceLLM Hauptfenster](README/screenshots/main.png)
 
diff --git a/README/screenshots/web-companion.png b/README/screenshots/web-companion.png
diff --git a/web_companion/index.html b/web_companion/index.html
@@ -3,8 +3,12 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>NoteSpaceLLM Companion</title>
-  <meta name="description" content="Lokaler Web/PWA-Companion für exportierte NoteSpaceLLM-Workspaces.">
+  <title>NoteSpaceLLM Web/PWA Companion</title>
+  <meta name="description" content="Lokaler Web/PWA-Companion für exportierte NoteSpaceLLM-Workspaces: mobile Review-Notizen, Berichtsvorschau und Dokumentmetadaten ohne Server-Upload.">
+  <meta name="keywords" content="NoteSpaceLLM, NotebookLM Alternative, local RAG, document analysis, privacy-first AI, PWA, document review">
+  <meta property="og:title" content="NoteSpaceLLM Web/PWA Companion">
+  <meta property="og:description" content="Read-only browser companion for exported NoteSpaceLLM workspaces with local review notes and no server upload.">
+  <meta property="og:type" content="website">
   <meta name="theme-color" content="#0c4a6e">
   <link rel="manifest" href="./manifest.webmanifest">
   <link rel="stylesheet" href="./app.css">
diff --git a/web_companion/manifest.webmanifest b/web_companion/manifest.webmanifest
@@ -6,5 +6,5 @@
   "background_color": "#f4efe6",
   "theme_color": "#0c4a6e",
   "lang": "de",
-  "description": "Lokaler Web/PWA-Companion für exportierte NoteSpaceLLM-Workspaces."
+  "description": "Lokaler Web/PWA-Companion für exportierte NoteSpaceLLM-Workspaces mit Review-Notizen ohne Server-Upload."
 }

Original file line number	Diff line number	Diff line change
`@@ -6,5 +6,5 @@`
`6`	`6`	`"background_color": "#f4efe6",`
`7`	`7`	`"theme_color": "#0c4a6e",`
`8`	`8`	`"lang": "de",`
`9`		`- "description": "Lokaler Web/PWA-Companion für exportierte NoteSpaceLLM-Workspaces."`
	`9`	`+ "description": "Lokaler Web/PWA-Companion für exportierte NoteSpaceLLM-Workspaces mit Review-Notizen ohne Server-Upload."`
`10`	`10`	`}`