getting started
install now
screenpipe offers multiple installation methods. for most users, we recommend:
- downloading the desktop app (opens in a new tab)
- or using our quick install CLI:
curl -fsSL get.screenpi.pe/cli | sh
screenpipe
then query the data using our JavaScript SDK:
import { pipe } from "@screenpipe/js";
async function queryScreenpipe() {
// get content from last 5 minutes
const fiveMinutesAgo = new Date(Date.now() - 5 * 60 * 1000).toISOString();
const results = await pipe.queryScreenpipe({
startTime: fiveMinutesAgo,
limit: 10,
contentType: "all", // can be "ocr", "audio", or "all"
});
if (!results) {
console.log("no results found or error occurred");
return;
}
console.log(`found ${results.pagination.total} items`);
// process each result
for (const item of results.data) {
if (item.type === "OCR") {
console.log(`OCR: ${JSON.stringify(item.content)}`);
} else if (item.type === "Audio") {
console.log(`transcript: ${JSON.stringify(item.content)}`);
}
}
}
queryScreenpipe().catch(console.error);
now download the desktop app (opens in a new tab) and use pipes (plugins) to add more features!
connect to AI providers
screenpipe can connect to various AI providers to process your data. here's how to set up popular local AI providers:
- install ollama from ollama.ai (opens in a new tab) and run your preferred model
# start ollama with your preferred model
ollama run phi4:14b-q4_K_M
- then configure screenpipe to use ollama in your settings with model phi4:14b-q4_K_M
that's it! screenpipe will now use ollama for AI like search, rewind, and more. you can change the model in settings.
verify your ai provider using any pipe in the store!
for developers
if you're interested in building from source or contributing to screenpipe, please check our contributing guide (opens in a new tab).
for businesses
some of our customers use screenpipe in the following ways:
- have existing screen recording software and want enterprise screen search engine
- want to integrate team's scale meeting transcriptions
- want to extract knowledge from enterprise-scale screens
- running the CLI on their customer's computer
- running the app on their customer's computer
- embedding the library or CLI in their own software
- running the CLI in the cloud and forward the video/audio through SSH
- using our Microsoft Remote Desktop / SSH integration
book a call to discuss your business needs (opens in a new tab)