제외 목록은 핫 리로드됩니다. 파일 편집 및 제외된 앱의 실행/종료는 screenpipe를 재시작하지 않고도 엔진의 기존 500ms 탭 재빌드 루프에서 감지됩니다. 테스트 시 `SCREENPIPE_AUDIO_EXCLUSIONS_PATH`로 파일 경로를 재정의할 수 있습니다. 참고: 이를 위해서는 시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 녹음에서 "시스템 오디오 녹음 전용" TCC 권한이 필요합니다.

### AI 기반 검색
접근성 우선 화면 텍스트, OCR 대체 텍스트, 오디오 전사본을 대상으로 한 자연어 검색. 앱 이름, 창 제목, 브라우저 URL, 날짜 범위로 필터링. 내부적으로 전체 텍스트 키워드 검색(SQLite FTS5) 사용. 텍스트 결과와 함께 스크린샷 및 오디오 클립을 반환합니다.

### 타임라인 보기
전체 화면 기록의 시각적 타임라인. DVR처럼 하루를 스크롤하세요. 아무 순간이나 클릭하면 전체 스크린샷과 추출된 텍스트를 볼 수 있습니다. 원하는 기간의 오디오를 재생할 수 있습니다.

### 플러그인 시스템 (Pipes)
Pipes는 마크다운 파일로 정의된 예약 AI 에이전트입니다. 각 pipe는 프롬프트와 일정이 포함된 `pipe.md`입니다. screenpipe는 화면 데이터를 쿼리하고, API를 호출하고, 파일을 작성하고, 작업을 수행하는 AI 코딩 에이전트(pi 또는 claude-code 등)를 실행합니다. 기본 제공 pipes는 다음과 같습니다:
- **meeting-summary**: 방금 끝난 회의를 요약하고 메모를 회의 기록에 다시 패치합니다
- **day-recap**: 오늘의 성과, 주요 순간, 완료하지 못한 작업
- **standup-update**: 수행한 작업, 다음 계획, 차단 요인
- **time-breakdown**: 앱, 프로젝트, 카테고리별 시간 사용 내역
- **ai-prompt-journal**: AI 도구에 보낸 모든 프롬프트를 캡처하여 Obsidian 또는 로컬 마크다운에 저장
- **video-export**: 최근 화면 활동의 비디오 생성

개발자는 `~/.screenpipe/pipes/`에 마크다운 파일을 작성하여 pipes를 만들 수 있습니다.

#### Pipe 데이터 권한
각 pipe는 관리자가 AI 에이전트가 접근할 수 있는 데이터를 OS 수준에서 결정적으로 제어할 수 있는 YAML frontmatter 필드를 지원합니다:
- **앱 및 창 필터링**: `allow-apps`, `deny-apps`, `deny-windows` (glob 패턴)
- **콘텐츠 유형 제어**: `ocr`, `audio`, `input`, `accessibility`로 제한
- **시간 및 요일 제한**: 예: `time-range: 09:00-18:00`, `days: Mon,Tue,Wed,Thu,Fri`
- **엔드포인트 게이팅**: `allow-raw-sql: false`, `allow-frames: false`

세 계층에서 적용됩니다 — 스킬 게이팅(AI가 거부된 엔드포인트를 학습하지 못함), 에이전트 차단(실행 전 차단), 서버 미들웨어(pipe별 암호화 토큰). 프롬프트 기반이 아닌 결정적 방식입니다.

### MCP 서버 (Model Context Protocol)
screenpipe는 MCP 서버로 실행되어 AI 어시스턴트가 화면 기록을 쿼리할 수 있게 합니다:
- Claude Desktop, Cursor, VS Code(Cline, Continue) 및 모든 MCP 호환 클라이언트와 작동
- AI 어시스턴트는 화면 기록을 검색하고, 최근 컨텍스트를 얻고, 회의 전사본에 접근할 수 있습니다
- 제로 구성: `claude mcp add screenpipe -- npx -y screenpipe-mcp@latest`

### 개발자 API
localhost(기본 포트 3030)에서 실행되는 전체 REST API. 화면 콘텐츠, 오디오, 프레임 검색용 엔드포인트. 기본 SQLite 데이터베이스에 대한 원시 SQL 접근. JavaScript/TypeScript SDK 제공.

## 개인정보 보호 및 보안

- **기본적으로 100% 로컬**: 모든 데이터는 로컬 SQLite 데이터베이스의 기기에 저장됩니다. 외부 서버로 전송되는 항목 없음.
- **소스 공개**: 완전히 감사 가능한 코드베이스; 개인적, 비상업적 사용 허용.
- **로컬 AI 지원**: Ollama 또는 모든 로컬 모델 사용 가능 — 클라우드로 전송되는 데이터 없음.
- **계정 불필요**: 핵심 앱은 가입 없이 작동합니다.
- **데이터 소유권**: 언제든지 내보내기, 삭제 또는 백업 가능.
- **선택적 암호화 동기화**: 기기 간 종단 간 암호화 동기화(제로 지식 암호화).
- **AI 데이터 권한**: Pipe별 YAML 기반 접근 제어 — 프롬프트 기반이 아닌 OS 수준의 결정적 적용. 세 가지 적용 계층이 AI 에이전트의 무단 데이터 접근을 방지합니다.

## screenpipe와 대안 비교

| 기능 | screenpipe | Rewind / Limitless | Microsoft Recall | Granola |
|---------|-----------|-------------------|-----------------|---------|
| 소스 공개 | ✅ 완전 감사 가능 | ❌ | ❌ | ❌ |
| 플랫폼 | macOS, Windows, Linux | macOS, Windows | Windows 전용 | macOS 전용 |
| 데이터 저장 | 100% 로컬 | 클라우드 필수 | 로컬(Windows) | 클라우드 |
| 다중 모니터 | ✅ 모든 모니터 | ❌ 활성 창만 | ✅ | ❌ 회의 전용 |
| 오디오 전사 | ✅ 로컬 Whisper | ✅ | ❌ | ✅ 클라우드 |
| 개발자 API | ✅ 전체 REST API + SDK | 제한적 | ❌ | ❌ |
| 플러그인 시스템 | ✅ Pipes(AI 에이전트) | ❌ | ❌ | ❌ |
| AI 모델 선택 | 모든 모델(로컬 또는 클라우드) | 독점 | Microsoft AI | 독점 |
| 팀 배포 | ✅ 중앙 구성, AI 권한 | ❌ | ❌ | ❌ |
| 가격 | 소스 공개 · 앱 월 $25부터 | 구독 | Windows에 번들 | 구독 |

## 가격

소스는 개인적, 비상업적 용도로 공개됩니다([LICENSE.md](https://github.com/screenpipe/screenpipe/blob/main/LICENSE.md) 참조). 서명된 데스크톱 앱은 구독을 사용합니다:

- **Standard**: 월 $25. 기기에서 모두 처리되는 로컬 우선 캡처, 검색 및 타임라인.
- **Pro**: 좌석당 월 $50. Standard의 모든 기능에 클라우드 동기화, 클라우드 AI 및 통합 기능 추가. 팀은 5석 이상을 셀프 서비스로 구매.
- **Enterprise**: 좌석당 월 $150. 관리형 배포, 중앙 구성, 공유 pipes, pipe별 AI 데이터 권한, 관리자 대시보드, SSO/SAML, MDM 준비(Intune / SCCM). 영업 주도. [screenpi.pe/team](https://screenpi.pe/team) 참조.

기존 평생 라이선스는 유효하며, 새로운 평생 구매는 더 이상 판매되지 않습니다.

## 통합

- **AI 코딩 어시스턴트**: Cursor, Claude Code, Cline, Continue, OpenCode, Gemini CLI
- **AI 채팅 어시스턴트**: ChatGPT(MCP 경유), Claude Desktop(MCP 경유), 모든 MCP 호환 클라이언트
- **메모 작성**: Obsidian, Notion
- **로컬 AI**: Ollama, 모든 OpenAI 호환 모델 서버
- **자동화**: 사용자 정의 pipes(마크다운 파일로 된 예약 AI 에이전트)

## 팀 및 엔터프라이즈

screenpipe Teams를 통해 조직은 AI가 접근할 수 있는 항목을 완전히 제어하면서 팀 전체에 AI 에이전트를 배포할 수 있습니다. [screenpi.pe/team](https://screenpi.pe/team) 참조.

- **중앙 구성 관리**: 관리자 대시보드에서 모든 기기에 캡처 설정(앱 필터, 일정, URL 규칙)을 푸시.
- **공유 pipes**: AI 워크플로우(자동 스탠드업, 회의-티켓 변환, 시간 추적)를 팀 전체에 배포.
- **Pipe별 AI 데이터 권한**: YAML frontmatter가 각 pipe가 접근할 수 있는 항목(앱, 창, 콘텐츠 유형, 시간 범위, 엔드포인트)을 제어. 세 계층(스킬 게이팅, 에이전트 차단, pipe별 암호화 토큰이 있는 서버 미들웨어)을 통해 OS 수준에서 결정적으로 적용.
- **개인정보 경계**: 관리자는 캡처되는 항목과 AI가 접근하는 항목을 제어. 실제 데이터는 절대 볼 수 없음 — 모든 것이 각 직원의 기기에 유지.
- **재정의 규칙**: 직원은 더 엄격한 필터(예: 개인 이메일도 차단)를 추가할 수 있지만 관리자가 설정한 규칙을 약화시킬 수는 없음.
- **MDM 준비**: Intune, SCCM, Robopack 또는 모든 MDM 솔루션을 통해 배포.
- **엔터프라이즈**: SSO/SAML, 감사 로그, SLA, SOC 2 / HIPAA 규정 준수 준비.

## 기술 아키텍처

1. **이벤트 기반 캡처**: OS 이벤트(앱 전환, 클릭, 입력 일시 중지, 스크롤, 클립보드)를 수신. 의미 있는 이벤트 발생 시 동일한 타임스탬프로 스크린샷 + 접근성 트리를 함께 캡처. 접근성 데이터를 사용할 수 없을 때 OCR로 대체. 아무 일도 없을 때 유휴 대체 캡처가 주기적으로 실행.
2. **오디오 처리**: 음성-텍스트 변환용 Whisper(로컬) 또는 Deepgram(클라우드). 화자 식별 및 분리.
3. **저장**: FTS5 전체 텍스트 검색이 포함된 로컬 SQLite. 스크린샷은 디스크에 JPEG로 저장(연속 녹화 시 약 2GB 대비 8시간당 약 300MB).
4. **API 계층**: localhost:3030의 REST API. 검색, 프레임, 오디오, 요소, 상태, pipe 관리.
5. **플러그인 계층**: Pipes — 마크다운 파일로 된 예약 AI 에이전트. 에이전트가 screenpipe API에 접근하여 프롬프트를 실행.
6. **UI 계층**: Tauri(Rust + TypeScript)로 구축된 데스크톱 앱.

## API 예시

화면 콘텐츠 검색:```
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(),
});