La lista di esclusioni si ricarica a caldo: le modifiche al file e l'avvio/uscita delle app escluse vengono rilevate dal ciclo di tap-rebuild esistente di 500 ms del motore, senza riavviare screenpipe. Per i test, sovrascrivi il percorso del file con `SCREENPIPE_AUDIO_EXCLUSIONS_PATH`. Nota: questo richiede il permesso TCC "Registrazione audio di sistema" in Impostazioni di Sistema → Privacy e Sicurezza → Registrazione schermo e audio di sistema.

### Ricerca basata su intelligenza artificiale
Ricerca in linguaggio naturale nel testo dello schermo con priorità all'accessibilità, nel testo OCR di fallback e nelle trascrizioni audio. Filtra per nome dell'app, titolo della finestra, URL del browser e intervallo di date. Ricerca full-text per parole chiave (SQLite FTS5) sotto il cofano. Restituisce screenshot e clip audio insieme ai risultati testuali.

### Vista timeline
Timeline visiva dell'intera cronologia dello schermo. Scorri la tua giornata come un DVR. Clicca su qualsiasi momento per vedere lo screenshot completo e il testo estratto. Riproduci l'audio da qualsiasi periodo di tempo.

### Sistema di plugin (Pipes)
I Pipes sono agenti AI pianificati definiti come file markdown. Ogni pipe è un `pipe.md` con un prompt e una pianificazione: screenpipe esegue un agente di codifica AI (come pi o claude-code) che interroga i tuoi dati dello schermo, chiama API, scrive file e compie azioni. I pipe integrati includono:
- **meeting-summary**: Riassume la riunione appena terminata e applica la nota al record della riunione
- **day-recap**: I risultati di oggi, i momenti chiave e il lavoro incompiuto
- **standup-update**: Cosa hai fatto, cosa c'è dopo ed eventuali blocchi
- **time-breakdown**: Dove è andato il tuo tempo, per app, progetto e categoria
- **ai-prompt-journal**: Cattura ogni prompt che invii agli strumenti AI, salvato in Obsidian o in markdown locale
- **video-export**: Crea un video della tua recente attività sullo schermo

Gli sviluppatori possono creare pipe scrivendo un file markdown in `~/.screenpipe/pipes/`.

#### Permessi dati dei pipe
Ogni pipe supporta campi frontmatter YAML che offrono agli amministratori un controllo deterministico a livello di sistema operativo su quali dati gli agenti AI possono accedere:
- **Filtro app e finestre**: `allow-apps`, `deny-apps`, `deny-windows` (pattern glob)
- **Controllo del tipo di contenuto**: limita a `ocr`, `audio`, `input` o `accessibility`
- **Restrizioni di orario e giorni**: ad es. `time-range: 09:00-18:00`, `days: Mon,Tue,Wed,Thu,Fri`
- **Gating degli endpoint**: `allow-raw-sql: false`, `allow-frames: false`

Applicato su tre livelli: gating delle competenze (l'AI non apprende mai gli endpoint negati), intercettazione dell'agente (bloccato prima dell'esecuzione) e middleware del server (token crittografici per pipe). Non basato su prompt. Deterministico.

### Server MCP (Model Context Protocol)
screenpipe funziona come server MCP, consentendo agli assistenti AI di interrogare la cronologia dello schermo:
- Funziona con Claude Desktop, Cursor, VS Code (Cline, Continue) e qualsiasi client compatibile con MCP
- Gli assistenti AI possono cercare nella cronologia dello schermo, ottenere contesto recente e accedere alle trascrizioni delle riunioni
- Zero configurazione: `claude mcp add screenpipe -- npx -y screenpipe-mcp@latest`

### API per sviluppatori
API REST completa su localhost (porta predefinita 3030). Endpoint per la ricerca di contenuto dello schermo, audio e frame. Accesso SQL grezzo al database SQLite sottostante. SDK JavaScript/TypeScript disponibile.

## Privacy e sicurezza

- **100% locale per impostazione predefinita**: Tutti i dati sono memorizzati sul tuo dispositivo in un database SQLite locale. Nulla viene inviato a server esterni.
- **Sorgente disponibile**: codebase completamente verificabile; uso personale e non commerciale consentito.
- **Supporto AI locale**: Usa Ollama o qualsiasi modello locale: nessun dato viene inviato a nessun cloud.
- **Nessun account richiesto**: L'applicazione principale funziona senza alcuna registrazione.
- **I tuoi dati ti appartengono**: Esporta, elimina o esegui il backup in qualsiasi momento.
- **Sincronizzazione crittografata opzionale**: Sincronizzazione crittografata end-to-end tra dispositivi (crittografia zero-knowledge).
- **Permessi dati AI**: Controllo accessi basato su YAML per pipe: applicazione deterministica a livello di sistema operativo, non basata su prompt. Tre livelli di applicazione impediscono agli agenti AI di accedere a dati non autorizzati.

## Come screenpipe si confronta con le alternative

| Funzionalità | screenpipe | Rewind / Limitless | Microsoft Recall | Granola |
|---------|-----------|-------------------|-----------------|---------|
| Sorgente disponibile | ✅ completamente verificabile | ❌ | ❌ | ❌ |
| Piattaforme | macOS, Windows, Linux | macOS, Windows | Solo Windows | Solo macOS |
| Archiviazione dati | 100% locale | Cloud richiesto | Locale (Windows) | Cloud |
| Multi-monitor | ✅ Tutti i monitor | ❌ Solo finestra attiva | ✅ | ❌ Solo riunioni |
| Trascrizione audio | ✅ Whisper locale | ✅ | ❌ | ✅ Cloud |
| API per sviluppatori | ✅ API REST completa + SDK | Limitata | ❌ | ❌ |
| Sistema di plugin | ✅ Pipes (agenti AI) | ❌ | ❌ | ❌ |
| Scelta del modello AI | Qualsiasi (locale o cloud) | Proprietario | AI Microsoft | Proprietario |
| Distribuzione team | ✅ Config centrale, permessi AI | ❌ | ❌ | ❌ |
| Prezzi | Sorgente disponibile · app da $25/mese | Abbonamento | Incluso con Windows | Abbonamento |

## Prezzi

La sorgente è disponibile per uso personale e non commerciale (vedi [LICENSE.md](https://github.com/screenpipe/screenpipe/blob/main/LICENSE.md)). L'app desktop firmata utilizza un abbonamento:

- **Standard**: $25/mese. Acquisizione, ricerca e timeline local-first, tutto sul tuo dispositivo.
- **Pro**: $50/postazione/mese. Tutto incluso in Standard più sincronizzazione cloud, AI cloud e integrazioni. I team acquistano 5+ postazioni in autonomia.
- **Enterprise**: $150/postazione/mese. Distribuzione gestita, config centrale, pipe condivisi, permessi dati AI per pipe, dashboard amministrativa, SSO/SAML, pronto per MDM (Intune / SCCM). Guidato dalle vendite. Vedi [screenpi.pe/team](https://screenpi.pe/team).

Le licenze lifetime esistenti restano valide; i nuovi acquisti lifetime non sono più venduti.

## Integrazioni

- **Assistenti di codifica AI**: Cursor, Claude Code, Cline, Continue, OpenCode, Gemini CLI
- **Assistenti chat AI**: ChatGPT (tramite MCP), Claude Desktop (tramite MCP), qualsiasi client compatibile con MCP
- **Appunti**: Obsidian, Notion
- **AI locale**: Ollama, qualsiasi server di modelli compatibile con OpenAI
- **Automazione**: Pipe personalizzati (agenti AI pianificati come file markdown)

## Team e aziende

screenpipe Teams consente alle organizzazioni di distribuire agenti AI in tutto il team con pieno controllo su ciò a cui l'AI può accedere. Vedi [screenpi.pe/team](https://screenpi.pe/team).

- **Gestione config centrale**: Invia le impostazioni di acquisizione (filtri app, pianificazioni, regole URL) a ogni dispositivo da una dashboard amministrativa.
- **Pipe condivisi**: Distribuisci flussi di lavoro AI (standup automatici, riunioni-in-ticket, tracciamento del tempo) a livello di team.
- **Permessi dati AI per pipe**: Il frontmatter YAML controlla a cosa può accedere ogni pipe: app, finestre, tipi di contenuto, intervalli di tempo, endpoint. Applicato in modo deterministico a livello di sistema operativo tramite tre livelli (gating delle competenze, intercettazione dell'agente, middleware del server con token crittografici per pipe).
- **Confine di privacy**: Gli amministratori controllano cosa viene acquisito e a cosa accede l'AI. Non vedono mai i dati reali: tutto resta sul dispositivo di ogni dipendente.
- **Regole di override**: I dipendenti possono aggiungere filtri più severi (ad es. bloccare anche la posta personale) ma non possono indebolire le regole impostate dall'amministratore.
- **Pronto per MDM**: Distribuisci tramite Intune, SCCM, Robopack o qualsiasi soluzione MDM.
- **Enterprise**: SSO/SAML, log di audit, SLA, pronto per conformità SOC 2 / HIPAA.

## Architettura tecnica

1. **Acquisizione guidata da eventi**: Ascolta gli eventi del sistema operativo (cambio app, clic, pausa di digitazione, scorrimento, clipboard). Quando accade qualcosa di significativo, acquisisce uno screenshot + albero di accessibilità con lo stesso timestamp. Ripiega sull'OCR quando i dati di accessibilità non sono disponibili. Il fallback di inattività acquisisce periodicamente quando non accade nulla.
2. **Elaborazione audio**: Whisper (locale) o Deepgram (cloud) per la sintesi vocale. Identificazione del parlante e diarizzazione.
3. **Archiviazione**: SQLite locale con ricerca full-text FTS5. Gli screenshot vengono salvati come JPEG su disco (~300 MB/8 ore contro ~2 GB con registrazione continua).
4. **Livello API**: API REST su localhost:3030. Ricerca, frame, audio, elementi, salute, gestione pipe.
5. **Livello plugin**: Pipes: agenti AI pianificati come file markdown. L'agente esegue prompt con accesso all'API di screenpipe.
6. **Livello UI**: App desktop creata con Tauri (Rust + TypeScript).

## Esempi API

Cerca contenuto dello schermo:```
GET http://localhost:3030/search?q=meeting+notes&content_type=all&limit=10

JavaScript SDK:```javascript
import { pipe } from "@screenpipe/js";

const results = await pipe.queryScreenpipe({
  q: "project deadline",
  contentType: "all",
  limit: 20,
  startTime: new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString(),
});