# 🧠 MindSift ### *Der Kopf frei in drei Sekunden.* [![Self-Hosted](https://img.shields.io/badge/100%25-Self--Hosted-2563eb?style=flat-square)](#) [![Docker](https://img.shields.io/badge/Deployment-Single%20Container-2496ed?style=flat-square&logo=docker&logoColor=white)](#-schnellstart) [![Markdown](https://img.shields.io/badge/Datenhoheit-Pure%20Markdown%20%26%20Outliner-18181b?style=flat-square)](#) [![License](https://img.shields.io/badge/Lizenz-MIT-22c55e?style=flat-square)](LICENSE) **MindSift** ist deine zentrale, kompromisslos schnelle Schaltstelle fĂŒr spontane Gedanken, strukturierte Aufgaben, hierarchische Outliner-Notizen und gemeinsame Echtzeit-Listen — ablenkungsfrei gestaltet, lokal als Standard-Markdown gespeichert und zu 100 % unter deiner eigenen Kontrolle. [Philosophie](#-die-philosophie) ‱ [Funktionen](#-was-mindsift-auszeichnet) ‱ [Schnellstart](#-schnellstart) ‱ [FĂŒr wen?](#-fĂŒr-wen-ist-mindsift-gemacht) ---
## 💡 Die Philosophie: *Erst raus aus dem Kopf – spĂ€ter sortieren* Klassische ProduktivitĂ€ts- und Notiz-Apps scheitern im Alltag oft an derselben HĂŒrde: **Sie verlangen Struktur im falschen Moment.** Wenn dir mitten im GesprĂ€ch, unterwegs oder kurz vor Feierabend ein wichtiger Gedanke kommt, willst du keinen Ordner auswĂ€hlen, keine Datenbank-Eigenschaften pflegen und kein Formular ausfĂŒllen. Du willst den Gedanken in drei Sekunden loswerden – und sicher sein, dass er nicht verloren geht. **MindSift trennt das Erfassen radikal vom Organisieren:** 1. **Sofort abladen (Quick Dump):** Oben in der Eingabeleiste tippen, `Enter` drĂŒcken, fertig. Dein Kopf ist wieder frei. Alternativ kannst du einen Eintrag schon beim Schreiben direkt einer Aufgabenliste, Einkaufsliste oder Notiz zuweisen. 2. **Spielerisch sichten (Triage):** Wenn du spĂ€ter Ruhe hast, sichtest du deinen Gedanken-Stapel Karte fĂŒr Karte per Tastatur oder Swipe. Nach links verwerfen, auf „SpĂ€ter“ schieben oder mit einem Tastendruck in eine Aufgabe, ein Dokument oder einen Listeneintrag verwandeln. 3. **Strukturiert vertiefen:** Aus spontanen Notizen werden hierarchische Outliner-Dokumente, vernetzte NotizbĂ€ume, Kanban-Boards oder geteilte Listen fĂŒr Familie und Team. --- ## ✹ Was MindSift auszeichnet ### ⚡ Quick-Dump & Triage-Deck (Das 3-Sekunden-Prinzip) * **Blitz-Erfassung:** Die Schnelleingabeleiste sitzt prominent ganz oben im Header – jederzeit erreichbar per Klick oder Tastendruck (`C` oder `/`). * **Entscheiden mit 1 Taste:** Im Triage-Deck steht immer genau ein Gedanke im Fokus: * `H` oder `←`: Wegwerfen / Erledigt * `L` oder `→`: Sofort zur Aufgabe machen * `T`: Termin-Aufgabe mit FĂ€lligkeitsdatum * `D`: In Workspace-Notiz umwandeln * `Leertaste`: SpĂ€ter (ans Ende des Stapels schieben) ### 📝 Workspace: Der hierarchische Logseq-Outliner * **Jeder Gedanke ein Bullet-Point:** Schreibe Notizen als flexible, hierarchische Gliederung: * `Enter`: Neuer Bullet-Point auf derselben Ebene * `Tab` / `Shift + Tab`: Unterordnen (einrĂŒcken) und ausrĂŒcken * `Shift + Enter`: Weicher Zeilenumbruch innerhalb desselben Blocks * **Zoom-in Hoisting:** Klicke auf den Bullet-Punkt (`‱`), um tief in einen Ast hineinzuzoomen (Fokus-Modus). Über die dezenten Breadcrumbs oben springst du jederzeit wieder zurĂŒck. * **Slash-Befehle (`/`):** Tippe einfach `/` fĂŒr `/todo`, `/h1`, `/h2`, `/h3`, `/code`, `/table`, `/callout` oder `/progress`. * **Datei-Explorer mit Drag & Drop:** Verschiebe Dokumente mit der Maus direkt per Drag & Drop in Ordner oder zurĂŒck ins Hauptverzeichnis. * **Angepinnte Favoriten:** Hefte wichtige Notizen mit einem Klick an – sie erscheinen prominent ganz oben im Explorer. * **100 % Standard-Markdown auf der Festplatte:** Alle Notizen werden unter `/data/workspace//...` als echte `.md`-Dateien gespeichert (mit 2-Leerzeichen-EinrĂŒckung). VollstĂ€ndig kompatibel mit Obsidian, Logseq oder einfachen Text-Editoren – kein Vendor-Lock-in! ### 📋 Globale To-Dos: Das automatische Aufgaben-Rollup * **Alles auf einen Blick:** MindSift durchsucht all deine Notizen und sammelt sĂ€mtliche Checkboxen (`- [ ]`) in einem zentralen Rollup-Dashboard. * **Ordner-Drilldown:** Isoliere einzelne Projekt-Ordner mit einem Klick. * **Echtzeit-2-Wege-Sync:** Hakst du eine Aufgabe im Rollup ab, wird sie im selben Augenblick direkt in der physischen `.md`-Datei auf deiner Festplatte als `- [x]` aktualisiert! ### ✅ Aufgabenlisten & Kanban-Board * **Mehrere Listen:** Trenne Berufliches, Privates, Homelab oder Team-Projekte sauber in eigenen Listen. * **Liste oder Kanban:** Wechsle mit einem Klick zwischen kompakter Listenansicht und dem **3-Spalten-Kanban-Board** (*Zu erledigen*, *In Arbeit*, *Erledigt*). * **Teilen & Avatar-Stack:** Teile Aufgabenlisten mit Spaces und Teams. Der integrierte Avatar-Stack zeigt mit kleinen Initialen-Bubbles und Tooltips sofort, wer Zugriff hat. ### 🛒 Geteilte Echtzeit-Listen (Einkauf & Checklisten) * **Gemeinsam abhaken:** Ob Wocheneinkauf oder Urlaubs-Packliste – teile Listen in Echtzeit ĂŒber WebSocket. * **Live-Synchronisation:** Wird ein Artikel im Laden abgehakt, verschwindet er sofort bei allen anderen Teilnehmern. ### 🏱 Organisationen, Teams & Administration * **GefĂŒhrte Ersteinrichtung:** Beim allerersten Start fĂŒhrt dich MindSift automatisch durch die Einrichtung deines Administrator-Kontos. * **3-Stufen-Rollensystem:** Server-Admin, Team-Admin und regulĂ€res Mitglied. * **Einladungscodes & Registrierungs-Schalter:** Schalte die öffentliche Registrierung bequem per Schiebeschalter ab und lade neue Mitglieder gezielt per Einladungscode ein. * **Server-Isolation:** Bestimme zentral, ob Nutzer strikt privat fĂŒr sich arbeiten, sich nur innerhalb ihrer Teams sehen oder serverweit kooperieren. ### 🔔 Multi-Channel-Alarme * **PĂŒnktlich erinnert:** Automatische Benachrichtigung vor FĂ€lligkeit wahlweise per **E-Mail (SMTP)**, **Discord-Webhook** oder **eigenem Webhook-Endpunkt**. * **Eigene API-SchlĂŒssel:** Sende System-Alarme, Server-Logs oder Skripte per einfachem `curl`-Befehl direkt in deine Inbox. ### 🎹 Single-File CSS Theming & Hilfe * **1 Datei = 1 Theme:** VollstĂ€ndiges Design-System gesteuert ĂŒber genau eine CSS-Datei (`dark`, `light`, `high-contrast`, `soft`). * **Integrierte Hilfeseite:** Ein Klick auf das Profil-MenĂŒ oder den Hilfe-Button öffnet eine strukturierte Dokumentation inklusive Tastatur-Cheat-Sheet. --- ## 🚀 Schnellstart MindSift lĂ€uft als leichtgewichtiger, einzelner Container und bringt Webserver, API, Datenbank und Frontend direkt mit. ### Option 1: Der 1-Zeiler (Empfohlen) FĂŒhre diesen Befehl im Terminal deines Servers aus. Er erstellt das Verzeichnis, lĂ€dt die Konfiguration, erzeugt ein sicheres JWT-Geheimnis und startet den Container: ```bash curl -fsSL https://git.dsit.me/sandrodach/MindSift/raw/branch/dev/install.sh | bash ``` --- ### Option 2: Schneller Start mit zwei `curl`-Befehlen Falls du die Dateien direkt ohne Skript herunterladen möchtest: ```bash mkdir -p mindsift && cd mindsift curl -fsSL https://git.dsit.me/sandrodach/MindSift/raw/branch/dev/docker-compose.yml -o docker-compose.yml curl -fsSL https://git.dsit.me/sandrodach/MindSift/raw/branch/dev/.env.example -o .env docker compose up -d ``` --- ### Option 3: Manuelle `docker-compose.yml` Erstelle eine Datei namens `docker-compose.yml`: ```yaml services: mindsift: image: git.dsit.me/sandrodach/mindsift:dev container_name: mindsift restart: unless-stopped ports: - "8080:8080" volumes: - ./data:/data environment: - PORT=8080 - DATA_DIR=/data - JWT_SECRET=hier-ein-langes-sicheres-zufalls-geheimnis-eintragen - ALLOW_REGISTRATION=false # Optional: Mailserver fĂŒr E-Mail-Alarme (auch im Admin-UI einstellbar) - SMTP_HOST= - SMTP_PORT=587 - SMTP_USER= - SMTP_PASS= - SMTP_FROM= - SMTP_TLS=true ``` Starte den Container: ```bash docker compose up -d ``` --- ### 🌐 Ersteinrichtung aufrufen Öffne deinen Browser unter **`http://localhost:8080`** (bzw. die IP deines Servers). MindSift erkennt den Erststart automatisch und fĂŒhrt dich durch den Einrichtungs-Assistenten zum Erstellen des Administrator-Kontos. --- ## đŸ‘„ FĂŒr wen ist MindSift gemacht? * **FĂŒr Macher & Wissensarbeiter**, die tagsĂŒber dutzende Gedanken, Links und Aufgaben festhalten mĂŒssen, ohne aus dem Arbeitsfluss gerissen zu werden. * **FĂŒr Outliner-Fans**, die die FlexibilitĂ€t von Logseq schĂ€tzen, aber ihre Notizen in einer klaren Ordnerstruktur auf dem eigenen Server haben wollen. * **FĂŒr Familien & WGs**, die gemeinsame Einkaufs- und Packlisten ohne Werbe-Apps und fremde Clouds synchronisieren möchten. * **FĂŒr Homelab- & Self-Hosting-Begeisterte**, die volle Datenhoheit, saubere Markdown-Dateien und automatisierte Webhooks auf eigener Hardware schĂ€tzen. --- ## 🔒 Deine Daten gehören dir * **100 % Self-Hosted:** Keine fremden Cloud-Dienste, keine Telemetrie, kein Tracking. * **Kein Vendor-Lock-in:** Alle Notizen liegen als lesbare `.md`-Dateien im Ordner `./data/workspace`. Backups können jederzeit als JSON exportiert werden. --- ## 📄 Lizenz Veröffentlicht unter der **MIT-Lizenz** – siehe [LICENSE](LICENSE).
Gebaut fĂŒr maximale Klarheit, Geschwindigkeit und digitale SouverĂ€nitĂ€t.