85 lines
2.9 KiB
Markdown
85 lines
2.9 KiB
Markdown
# Notarius
|
|
|
|
Lokale Aufnahme, Transkription (mit Sprechererkennung) und KI-gestützte
|
|
Zusammenfassung von Gesprächen. Läuft als Tray-Anwendung unter KDE/Plasma.
|
|
|
|
## Vorausgesetzte System-Abhängigkeiten
|
|
|
|
- `ffmpeg` / `ffprobe`
|
|
- `pactl` (PipeWire/PulseAudio-Kompatibilitätsschicht)
|
|
- Eine CUDA-fähige GPU + funktionierende whisperx/torch-CUDA-Umgebung
|
|
- Qt-Multimedia-Backend (z.B. `gstreamer1-plugin-libav` für MP3-Wiedergabe)
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
./install.sh
|
|
```
|
|
|
|
Legt eine virtuelle Umgebung unter `.venv/` an, installiert Notarius darin und
|
|
richtet einen Eintrag im Anwendungsmenü ein (`~/.local/share/applications/notarius.desktop`,
|
|
Exec zeigt auf `.venv/bin/python`). Danach ist Notarius wie jede andere
|
|
Anwendung über das Plasma-Menü startbar. Zum Entfernen: `./uninstall.sh`
|
|
(fragt vor dem Löschen der venv nach; Aufnahmen und Konfiguration bleiben
|
|
in jedem Fall erhalten).
|
|
|
|
Manuell statt über das Skript:
|
|
|
|
```bash
|
|
python -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -e .
|
|
notarius-install-launcher # optional: Menü-Eintrag einrichten
|
|
```
|
|
|
|
`whisperx` bringt schwere GPU-Abhängigkeiten (torch, torchaudio) mit und wird
|
|
nur beim tatsächlichen Transkribieren als eigener Subprozess importiert - die
|
|
GUI selbst benötigt es nicht zum Starten.
|
|
|
|
Ein Flatpak-Paket wurde bewusst nicht erstellt: die whisperx/CUDA-Abhängigkeiten
|
|
ließen sich nur mit einem sehr großen, host-spezifischen Sandbox-Runtime
|
|
abbilden, und System-Audio-Mitschnitt (pactl) sowie Autostart bräuchten ohnehin
|
|
erweiterte Portale/Permissions - für ein Einzelplatz-Tool auf einer bekannten
|
|
Maschine steht der Aufwand in keinem Verhältnis zum Sandboxing-Nutzen.
|
|
|
|
## Start
|
|
|
|
```bash
|
|
notarius
|
|
# oder:
|
|
python -m notarius
|
|
```
|
|
|
|
Nach `./install.sh` reicht auch ein Klick auf den Menü-Eintrag. Es öffnet sich
|
|
kein Fenster, sondern ein Icon im System-Tray. Rechts-/Linksklick öffnet das
|
|
Menü (Start Rec / Stop Rec, Open, Quit).
|
|
|
|
## Tastenkurzbefehl für Start Rec / Stop Rec
|
|
|
|
`notarius-rec` steuert eine Aufnahme unabhängig davon, ob die Notarius-GUI
|
|
gerade läuft (Lock-Datei-basiert, analog zu `reference/call-recorder.sh`):
|
|
|
|
```bash
|
|
notarius-rec toggle # oder: start / stop
|
|
```
|
|
|
|
In KDE: Systemeinstellungen -> Kurzbefehle -> Eigene Kurzbefehle -> Neu ->
|
|
Befehl/URL. Als Befehl den vollen Pfad zur venv eintragen, z.B.:
|
|
|
|
```
|
|
/home/timbfrank/n3m3t0n/Hobby/programming/notarius/.venv/bin/notarius-rec toggle
|
|
```
|
|
|
|
Läuft die GUI parallel (z.B. über Autostart), erkennt sie den Zustandswechsel
|
|
innerhalb von ca. 1 Sekunde und aktualisiert Tray-Icon und Recordings-Liste
|
|
automatisch - der Kurzbefehl funktioniert aber auch komplett ohne laufende GUI.
|
|
|
|
## Konfiguration & Secrets
|
|
|
|
- Programmkonfiguration: `~/.config/notarius/config.json`
|
|
- Log-Datei: `~/.config/notarius/notarius.log`
|
|
- Aufnahmen und Begleitdateien: `~/Notarius/`
|
|
- Anthropic-API-Key und HuggingFace-Token (für die Diarization-Pipeline)
|
|
liegen ausschließlich im System-Keyring (Tab „Settings“), nicht in
|
|
Konfigurationsdateien oder im Quellcode.
|