docs
plugins (pipes)

plugins (pipes)

screenpipe is built for extensibility through plugins that interact with captured screen and audio data. whether you need to tag activities, generate summaries, or send data to third-party services, plugins let you build powerful workflows.

plugins run within screenpipe's sandboxed environment. written in typescript/javascript and nextjs.

why build pipes? 🚀

regardless of progress in AI architecture, it's as good as the given context. screenpipe is the bridge between dull hallunicating AI and super intelligent agents.

for developers

  • zero infrastructure: 100% local by default, no servers or complex setups, access to your auth tokens (unlike cloud agents)
  • typescript + rust + bun: blazing fast environment, highly optimized pipeline, 4 AI models, running on $200 laptops, best local STT in the market
  • full context: rich OCR, desktop scrapping, keyboard/mouse, and audio transcription APIs
  • open source: no BS, no tricks, MIT license
  • monetization ready: Stripe integration to monetize your pipes
  • no lock-in: use our store for distribution, then drive traffic into your exported standalone app

killer features

  • ai flexibility: OpenAI, local LLMs (ollama), Anthropic, Gemini, etc.
  • rich APIs:
    • pipe.queryScreenpipe for context
    • pipe.settings for app settings
    • experimental pipe.streamTranscriptions for audio transcription streaming (make sure to enable it in settings)
    • experimental pipe.streamVision for OCR/Accessibility/Frames/browser URL streaming
    • experimental pipe.input for keyboard/mouse control
  • sandboxed & cross-platform: safe execution on all OS
  • real-time: process screen & audio as it happens
  • cron jobs: schedule your pipes to run at specific times, same API as Vercel
  • nextjs: build desktop native apps with NextJS - no native hell

quick start

we recommend using bun, install (opens in a new tab) or make sure it's up to date.

The fastest way to create a new pipe is using our CLI:

bunx --bun @screenpipe/dev@latest pipe create

follow installation instructions & test your pipe locally

bun dev

developer CLI

for developers wanting to publish pipes to the store, we provide a dedicated CLI tool:

developer account

prerequisite: connect your Stripe account in settings/account to obtain your developer API key.

available commands:

# authenticate with your API key
bunx --bun @screenpipe/dev@latest login 
 
# create a new pipe
bunx --bun @screenpipe/dev@latest pipe register --name my-pipe [--paid --price 9.99] # MAKE SURE TO SET THE PRICE IF YOU WANT TO SELL IT - IRREVERSIBLE
# you'll receive payouts to your stripe account on a daily basis
 
# publish your pipe to the store
bunx --bun @screenpipe/dev@latest pipe publish --name my-pipe
# our team will review your pipe and publish it to the store
# if approved, your pipe will be available in the store to everyone
 
# list all versions of your pipe
bunx --bun @screenpipe/dev@latest pipe list-versions --name my-pipe
 
# add predefined components to your pipe (shadcn style)
bunx --bun @screenpipe/dev@latest components add
# select components from the interactive menu:
# - use-health: health monitoring hooks
# - use-settings: settings management
# - route-settings: settings page routing
# - use-sql-autocomplete: SQL query assistance
# - sql-autocomplete-input: SQL input component
# - use-search-history: search history management
# - use-ai-provider: AI integration hooks
 
# end current session
bunx --bun @screenpipe/dev@latest logout

you can deploy your pipe to your screenpipe app through the UI or using screenpipe pipe install <path> and screenpipe pipe enable <id/folder of your pipe>.

when you're ready to deploy, send a PR to the screenpipe repo (opens in a new tab) to add your pipe to the store.

PS: monetization requires a stripe account and US bank account, we recommend wise (opens in a new tab) for international users.

(louis) i am french and i don't have a personal US bank account, so i use wise.

available pipes

pipedescriptionlink
obsidian logsautomate your second brain by logging activities to obsidianlink (opens in a new tab)
memories gallerygoogle-photo like gallery of your screen recordings with AI insightslink (opens in a new tab)
data tableexplore your data in a powerful table view with filtering and sortinglink (opens in a new tab)
searchsearch through your screen recordings and audio transcripts with AIlink (opens in a new tab)
rewindvisualize your day with AI-powered timeline of activitieslink (opens in a new tab)
speaker identificationautomatically identify and label different speakers using AIlink (opens in a new tab)
meeting assistantorganize and summarize meetings with AI - get transcripts and insightslink (opens in a new tab)
linkedin ai agentautomate business development on linkedinlink (opens in a new tab)

to install a pipe from the store, just add the url of the folder in the UI and click install.

LLM links

paste these links into your Cursor chat for context: