obsidian-plugin/blackajiro_Resonance
1
0
Fork 0
mirror of https://github.com/blackajiro/Resonance.git synced 2026-07-22 06:51:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
1 commit 1 branch 5 tags 2.1 MiB
TypeScript 92%
CSS 7.5%
JavaScript 0.5%
Find a file
Michael Gorini b4862b8aad init
2025-08-29 11:00:21 +02:00
scripts init 2025-08-29 11:00:21 +02:00
.gitignore init 2025-08-29 11:00:21 +02:00
DependencyChecker.ts init 2025-08-29 11:00:21 +02:00
DeviceScanner.ts init 2025-08-29 11:00:21 +02:00
HelpModal.ts init 2025-08-29 11:00:21 +02:00
main.ts init 2025-08-29 11:00:21 +02:00
manifest.json init 2025-08-29 11:00:21 +02:00
package-lock.json init 2025-08-29 11:00:21 +02:00
package.json init 2025-08-29 11:00:21 +02:00
README.md init 2025-08-29 11:00:21 +02:00
RecordingModal.ts init 2025-08-29 11:00:21 +02:00
settings.ts init 2025-08-29 11:00:21 +02:00
SetupWizard.ts init 2025-08-29 11:00:21 +02:00
styles.css init 2025-08-29 11:00:21 +02:00
tsconfig.json init 2025-08-29 11:00:21 +02:00
vite.config.ts init 2025-08-29 11:00:21 +02:00

README.md

Resonance (Obsidian Plugin)

Registra riunioni, trascrive localmente con whisper.cpp, riassume con Google Gemini e crea automaticamente una nota in Obsidian.

Perché Vite

Vite è un bundler moderno che compila TypeScript in JavaScript in modo rapido e con DX eccellente.

  • Build velocissima (watch in ms) → feedback immediato durante lo sviluppo.
  • Configurazione semplice: produce dist/main.js in formato CommonJS richiesto da Obsidian.
  • Mappa sorgenti (.map) utile per il debug.

Script:

npm run dev    # build in watch (rigenera dist/main.js ad ogni modifica)
npm run build  # build una tantum per rilasciare (copia anche manifest.json e styles.css in dist/)

Requisiti

  • Obsidian Desktop ≥ 1.5
  • Node.js ≥ 18 (per build)
  • FFmpeg installato localmente (per la registrazione audio)
  • whisper.cpp compilato localmente (per la trascrizione)
  • Chiave API Google Gemini (per il riassunto)

Installazione sviluppo

npm install
npm run build

Troverai gli artefatti in dist/:

  • dist/manifest.json
  • dist/main.js
  • dist/styles.css

Installazione nel Vault

Copia l'intera cartella dist/ dentro <Vault>/.obsidian/plugins/resonance/ (o copia i 3 file elencati sopra mantenendo i nomi). Riavvia/ricarica Obsidian e abilita il plugin.

UX avanzate incluse

  • Scansione dispositivi FFmpeg (Windows/macOS): pulsante "Scansiona dispositivi audio" nelle impostazioni.
  • Dropdown per scegliere rapidamente microfono e (opzionalmente) audio di sistema.
  • Test rapido FFmpeg (3 secondi) per verificare il dispositivo.
  • Pulsante "Annulla" durante Trascrizione/Riassunto.
  • Scelta del modello Gemini.

Configurazione

Impostazioni → Resonance: API Key/model, FFmpeg + backend e device, whisper main e modello .bin, cartella note.

Build e ship

  • Sviluppo: npm run dev e symlink/copia dist/ nel vault
  • Rilascio: npm run build, zippa il contenuto di dist/

Troubleshooting

  • "Configurazione incompleta" → imposta API Key, FFmpeg/whisper/model.
  • Audio mancante → backend/device; usa scansione e test 3s.
  • Trascrizione vuota → controlla .mp3 e modello .bin.
  • Errore Gemini → API Key e modello.