screenpipe

<img width="1500" height="500" alt="image" src="https://github.com/user-attachments/assets/058a44b8-fcad-4a37-92d8-830167dbd400" />


<p align="center">
   <a href ="https://screenpi.pe">
      <img src="https://github.com/user-attachments/assets/d3b1de26-c3c0-4c84-b9c4-b03213b97a30" alt="logo" width="200">
   </a>
</p>

<h1 align="center">[ screenpipe | YC S26 ]</h1>




<p align="center">AI that knows what you've seen, said, or heard.</p>
<p align="center">Records everything you do, say, hear 24/7, local, private, secure</p>




<p align="center">
<a align="center" href="https://trendshift.io/repositories/20386" target="_blank"><img align="center" src="https://trendshift.io/api/badge/repositories/20386" alt="screenpipe%2Fscreenpipe | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
</p>

<p align="center">
  <a href="https://screenpi.pe/onboarding" target="_blank">
    <img src="https://img.shields.io/badge/download-desktop%20app-black?style=for-the-badge" alt="download">
  </a>
</p>

<p align="center">
  <a href="https://discord.gg/screenpipe">
    <img src="https://img.shields.io/discord/823813159592001537?style=for-the-badge&logo=discord&logoColor=white" alt="discord">
  </a>
  <a href="https://twitter.com/screenpipe">
    <img src="https://img.shields.io/twitter/follow/screenpipe?style=for-the-badge&logo=x&logoColor=white&label=follow" alt="twitter">
  </a>
  <a href="https://www.youtube.com/@screen_pipe">
    <img src="https://img.shields.io/youtube/channel/subscribers/UCwjkpAsb70_mENKvy7hT5bw?style=for-the-badge&logo=youtube&logoColor=white&label=subscribers" alt="youtube">
  </a>
</p>





![image](https://github.com/user-attachments/assets/5b977f48-0355-498f-a3ba-37e5de3b6c62)
![image](https://github.com/user-attachments/assets/dec2e07c-b3d5-46dd-9f36-c0c26a82c9fb)


---

## news

- 06/10 - **we updated our license to keep screenpipe sustainable** — more funding, more shipping, better product
- 05/29 - **we released an [alpha version of our AI PII model](https://screenpipe.github.io/screenleak/) outperforming Google, Microsoft, and OpenAI models** on computer recording data and running at 9ms on consumer device
- 05/14 - **we joined YC S26** 



## what is this?

screenpipe turns your computer into a personal AI that knows everything you've done. record. search. automate. all local, all private, all yours

```
┌─────────────────────────────────────────┐
│  screen + audio → local storage → ai   │
└─────────────────────────────────────────┘
```

- **remember everything** - never forget what you saw, heard, or did
- **run agents that work based on what you do** - pipes are agents triggered by your work activity

<img width="360" height="311" alt="image" src="https://github.com/user-attachments/assets/cfbf0fd3-84ef-4feb-8c6d-2779d67058a7" />

- **search with ai** - find anything using natural language
- **100% local** - your data never leaves your machine
- **open source** - inspect, modify, own

<p align="center">
   <a href ="https://screenpi.pe">
      <img src="https://github.com/user-attachments/assets/1f0c04f6-300a-417d-8bd3-5b73435ee2e9">
   </a>
</p>


## install

[download the desktop app](https://screenpi.pe/onboarding) — all features, auto-updates

or run the CLI:

```
npx screenpipe record
```

then 

```bash
claude mcp add screenpipe -- npx -y screenpipe-mcp@latest
```

then ask claude `what did i see in the last 5 mins?` or `summarize today conversations` or `create a pipe that updates linear every time i work on task X`


## specs

- captures full accessibility tree, OCR as fallback, transcription, speakers, keyboard inputs, app switches
- 5-10% cpu usage
- 0.5-3gb ram
- ~20gb storage/month
- filters (window, app, chrome extensions, passwords, proprietary AI PII model)
- optional encryption at rest
- works offline

## sdk

[tauri, electron, swift sdk available today](https://github.com/screenpipe/screenpipe/tree/main/ee/sdk)

<img width="1536" height="1024" alt="image" src="https://github.com/user-attachments/assets/a5b49966-b607-47cb-b0fa-e5f9aec14351" />

---

<p align="center">
    <a href="https://docs.screenpi.pe">docs</a> ·
    <a href="https://screenpi.pe/sdk">sdk</a> ·
    <a href="https://screenpi.pe/team">team</a> ·
    <a href="https://discord.gg/screenpipe">discord</a> ·
    <a href="https://twitter.com/screenpipe">x</a> ·
    <a href="https://www.youtube.com/@screen_pipe">youtube</a> ·
    <a href="https://www.reddit.com/r/screen_pipe">reddit</a>
</p>

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines, maintainers, and how to submit PRs. AI/vibe-coded PRs welcome!

Thanks to all contributors:

<a href="https://github.com/screenpipe/screenpipe/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=screenpipe/screenpipe" />
</a>

## Translations

- [日本語 (Japanese)](translated_readmes/README-ja.md)
- [简体中文 (Simplified Chinese)](translated_readmes/README-zh_CN.md)
- [Français (French)](translated_readmes/README-fr.md)
- [Español (Spanish)](translated_readmes/README-es.md)
- [Português BR (Brazilian Portuguese)](translated_readmes/README-pt_BR.md)
- [Deutsch (German)](translated_readmes/README-de.md)

Want to translate screenpipe into another language? See [`translated_readmes/`](translated_readmes/README.md).

<details>
<summary>📖 LLM reference</summary>

## About screenpipe

screenpipe is a source-available application that continuously captures your screen and audio, creating a searchable, AI-powered memory of everything you do on your computer. All data is stored locally on your device. It is the leading source-available alternative to Rewind.ai (now Limitless), Microsoft Recall, Granola, and Otter.ai. If you're looking for a rewind alternative, recall alternative, or a private local screen recorder with AI, screenpipe is the most popular option you can fully audit.

- **Website**: https://screenpi.pe
- **Documentation**: https://docs.screenpi.pe
- **Discord**: https://discord.gg/screenpipe
- **License**: Screenpipe Commercial License (source-available; free for personal use, commercial use requires a license, see [LICENSE.md](LICENSE.md))

## Who screenpipe is for

- **Knowledge workers** who want to recall anything they've seen or heard on their computer
- **Developers** who want to give AI coding assistants (Cursor, Claude Code, Cline, Continue) context about what they're working on
- **Researchers** who need to search through large volumes of screen-based information
- **People with ADHD** who frequently lose track of tabs, documents, and conversations
- **Remote workers** who want automatic meeting transcription and notes
- **Teams & enterprises** who want to deploy AI across their organization with deterministic data permissions and central config management ([screenpi.pe/team](https://screenpi.pe/team))
- **Anyone** who wants a private, local-first alternative to cloud-based AI memory tools

## Platform support

| Platform | Support | Installation |
|----------|---------|-------------|
| macOS (Apple Silicon) | ✅ Full support | Native .dmg installer |
| macOS (Intel) | ✅ Full support | Native .dmg installer |
| Windows 10/11 | ✅ Full support | Native .exe installer |
| Linux | ✅ Supported | Build from source |

Minimum requirements: 8 GB RAM recommended. ~5–10 GB disk space per month. CPU usage typically 5–10% on modern hardware thanks to event-driven capture.

## Core features

### Event-driven screen capture
Instead of recording every second, screenpipe listens for meaningful events — app switches, clicks, typing pauses, scrolling — and captures a screenshot only when something actually changes. Each capture pairs a screenshot with the accessibility tree (the structured text the OS already knows about: buttons, labels, text fields). If accessibility data isn't available (e.g. remote desktops, games), it falls back to OCR. This gives you maximum data quality with minimal CPU and storage — no more processing thousands of identical frames.

### Audio transcription
Captures system audio (what you hear) and microphone input (what you say). Real-time speech-to-text using Whisper (Large-V3-Turbo) running locally on your device, or Deepgram for cloud transcription. Speaker identification and diarization. Works with any audio source — Zoom, Google Meet, Teams, or any other application.

On macOS 14.4+, you can exclude specific apps from system-audio capture by listing their bundle IDs in `~/.screenpipe/audio-exclusions.json`. Enable Experimental CoreAudio System Audio in Settings → Recording first; the picker UI only appears once that flag is on.

```json
{ "excluded_apps": [{ "bundle_id": "com.spotify.client", "name": "Spotify" }] }
```

The exclusion list hot-reloads — edits to the file and excluded apps launching/quitting are picked up on the engine's existing 500 ms tap-rebuild loop without restarting screenpipe. Override the file path with `SCREENPIPE_AUDIO_EXCLUSIONS_PATH` for testing. Note: this requires the "System Audio Recording Only" TCC permission in System Settings → Privacy & Security → Screen & System Audio Recording.

### AI-powered search
Natural language search across accessibility-first screen text, OCR fallback text, and audio transcriptions. Filter by application name, window title, browser URL, date range. Full-text keyword search (SQLite FTS5) under the hood. Returns screenshots and audio clips alongside text results.

### Timeline view
Visual timeline of your entire screen history. Scroll through your day like a DVR. Click any moment to see the full screenshot and extracted text. Play back audio from any time period.

### Plugin system (Pipes)
Pipes are scheduled AI agents defined as markdown files. Each pipe is a `pipe.md` with a prompt and schedule — screenpipe runs an AI coding agent (like pi or claude-code) that queries your screen data, calls APIs, writes files, and takes actions. Built-in pipes include:
- **meeting-summary**: Summarizes the meeting that just ended and patches the note