Borago Vision

Features

A search field over your own photos, on your own computer. Everything else is in service of that.

Each card has a short version and a fuller one. The fuller one says what is on by default, what needs a setting, and where the limits are. Everything on this page is in the current build.

Your library

Your folders, where they are

Choose one folder or many. Borago reads them in place and watches them for changes.

How it works

On the first run Borago adds your Pictures folder and its own folder, and offers to add more. It never moves, copies, renames or edits an original file. A photo that appears in a folder later is indexed, and one that is deleted leaves the index. Removing a folder from the library removes its photos from the index and leaves the files untouched.

Settings, Library

JPEG, PNG, GIF, WebP and HEIC

The formats a phone and a camera produce. HEIC through the decoder your system already has.

How it works

HEIC, which an iPhone takes, is decoded by the system's own decoder: ImageIO on macOS, and the distribution's libheif on Linux where it is installed. On Windows, and on a Linux desktop without libheif, a HEIC photo is found and dated from its metadata but not shown or searched by content. Camera RAW is not read.

HEIC: macOS, and Linux with libheif

What it records about each photo

Capture date, file date and size, pixel size, camera make and model, and GPS where the file carries it.

How it works

Each photo also gets a small set of thumbnails for the grid, a palette of its five main colours, keywords already written into the file, a description of its content for search, the name of the place its GPS position points to, and in later passes the text inside it and, once you turn on Find faces, the faces in it. All of it stays in the index on your computer.

All of it on the device

Indexing in the background

It carries on with the window closed, resumes after a crash or a reboot, and gets out of your way.

How it works

Indexing slows down on battery power and while you are using the window. Borago opens at login in the background, which is a setting you can turn off, so photos added while it was not running are indexed before you open it. Quit stops indexing with everything else. Progress, pause and resume are in the window and in the tray.

Open at login: on by default, Settings, Library

Search before it finishes

Results arrive while the index is still building, and the window says so.

How it works

The first pass only lists the files, so the grid has photos to show within moments. Content search works for each photo as soon as its second pass is done. Text in photos is read in a third pass, after every photo can already be found by content, so search is usable long before text extraction finishes.

Borago's own folder

Drop or paste an image into the window and it is saved to Borago's folder. The original stays where it was.

How it works

The folder is Borago Vision/Pictures in your home folder and is always in the library. An image from a file manager, a browser, another application or a screen grab is saved there. Only images are saved, judged by their content. An image that arrives as a web address is downloaded only after you allow it, each time or always, and the question names the site. Every other folder is read-only to Borago.

Drag a photo out

Drag a photo from the window into another application. It receives the original file.

How it works

Any tile in the grid, the carousel or the stage can be dragged out, one photo at a time. Picking photos for a memory never starts a drag, so the two gestures do not collide.

Built to survive a power cut

The index is written so that a hard stop does not corrupt it or force a rebuild.

How it works

Every pass records its progress as it goes and resumes from there. In testing the process is killed mid-write and the index comes back intact. A real power cut on real hardware is not yet tested.

Voice

Every voice action has a key and a button too. Voice is never the only way to do something.

Speak a search

Press Ctrl+Shift+Space, Cmd on a Mac, from any application, or the microphone button in the window, and say what you are looking for.

How it works

The shortcut opens the search box already listening, wherever you are. The same press stops it, and it stops on its own when you stop talking. What you said is written into the field as if typed, and the main window comes forward on the results. Speech is turned into text on your computer by a model that runs locally. Audio stays in memory for the length of the search and is gone when it ends. Nothing is saved to disk and nothing is sent. English only in this build.

The speech model comes with the application

A wake phrase

Say Hey Borago or Hey BeeVee and the window comes forward listening. Or set a phrase of your own.

How it works

Listening is off until you turn it on in Settings, Voice. While it is on, the microphone is read into memory and checked for the phrase and nothing else. No audio is recorded, written to disk or sent, and each frame is dropped once it has been checked. A phrase of your own is checked as you set it: three syllables or more, six words or fewer, and not something people say all day. You can keep one phrase, both, or yours.

Off by default. Linux and macOS builds

You can see when it is listening

The tray icon changes while listening is on, and the menu says so in words.

How it works

Listening outranks every other state in the icon, because an open microphone is what you most need to see from outside the window. The tray menu, and the search box where a desktop has no tray, turn listening on and off and show what it is listening for. Saying stop listening turns it off from anywhere.

What you can say

A search, a date to narrow it, a view to open, Settings, Studio, or stop listening.

How it works

Most of what is said is a search, and dates, seasons and colours are read out of it as they are when typed. Only from last summer narrows what is on screen. Open the timeline, show my memories, show my suggestions and go to search switch views. Open settings opens the panel, and open Studio opens Studio. Anything not recognised is a search, so nothing you say is lost. A request said in the same breath as the wake phrase, Hey Borago, show me the beach, is answered without listening again.

A spoken answer, if you want one

After a spoken search, Borago can say how many photos it found. Off until you turn it on.

How it works

The voice is generated on your computer by a model that comes with the application. It says the count, not the query, because you have just said the query. Escape stops it, and a new search stops it before the microphone opens. It is off by default, because a computer that starts talking unasked is a surprise.

Off by default. English

Where the limits are

Voice has been tried by one person so far. Accuracy across voices, accents and rooms is not yet measured.

How it works

The wake phrases are listened for under several spellings, because a made-up name is heard in more than one way, and Hey Borago is heard more reliably than Hey BeeVee. Neither is yet measured across many speakers. On a Linux desktop running Wayland the shortcuts go through the desktop's own shortcut portal, which asks you once to allow them. A desktop without that portal has no global shortcut, and the tray and the button still work. Windows is not yet built.

The window

One page that scrolls

The field, the best answer large, the rest of the answer in a carousel, and everything found in a grid below.

How it works

The search field travels up as you scroll and docks into the title bar, so it is on every screen. The grid draws only what is on screen, so a library of a million photos scrolls as smoothly as a hundred. Hold Ctrl and scroll, or pinch, to change how many photos fit across.

A timeline of your library

The whole library grouped by year, month or day, with a scrubber to jump to any date.

How it works

A view of its own beside Search, Memories and Suggestions, with the current heading pinned while you scroll. The scrubber along the edge jumps to a year or a month. While indexing is running, a photo can briefly sit under the wrong heading until the next refresh.

Ctrl+2, Cmd+2 on a Mac

The viewer

One photo, full screen, with everything known about it beside it.

How it works

When it was taken, on the clock where it was taken and, when this computer's clock says another time, on yours. Camera, size, folder, the place by name with its coordinates under it, the colour palette, the text found in the photo, its tags, and the memories it is in. Arrow keys and swipes move through the photos around it. Tags and memories can be changed from here, and Open in Studio, or E, opens the photo in Studio. There is no written description of the photo.

Everything from the keyboard

Every action has a key, a pointer path and a touch path. A screen reader hears each tile and control.

How it works

Tiles take focus, Enter opens, Space picks, Escape closes or lets go. Views switch with Ctrl+1 to 4. The markup follows WCAG 2.1 AA, and a screen reader pass on each platform is not yet made.

Light, dark, contrast, text size

Follow the system or choose. A high-contrast mode and larger text are in Settings.

How it works

The palette is deliberately neutral so the photographs supply the colour. Text size scales the whole window, title bar included. The first frame is drawn in the right theme, with no flash.

In the tray, with the window closed

An icon shows whether Borago is idle, indexing, listening, or needs attention, with pause, resume and listening controls.

How it works

Closing the last window leaves Borago running and indexing, and asks nothing: the tray and the search box are how you reach it again, and Quit Borago is in both. Where a desktop has no tray, the search box stays open and stands in for it, with the same controls. Quit means quit: indexing stops with everything else.

A search box from anywhere

Ctrl+Cmd+B on a Mac, Super+Shift+B on Linux, opens a small box in any application. Type or speak, and the main window opens on the results.

How it works

The box is drawn by the system rather than by the window, so it opens at once, and your screen reader and input method work in it as they do everywhere else. It shows no results and keeps no history: the main window always shows the results. Enter with nothing typed opens the main window as you left it. Escape, or a click anywhere else, closes it. Both shortcuts can be changed in Settings, Shortcuts. You choose whether the window closes fully between searches, the default, so Borago uses less memory, or stays ready in memory so it opens instantly.

Linux and macOS builds

The first run

Your Pictures folder is chosen for you. Add more, then try a search. The models are already there.

How it works

Three steps, each remembered, so quitting in the middle picks up where you were. On macOS and Linux a step after the folders asks how Borago opens: use less memory, the default, or open instantly. The models come inside the package and are unpacked while the window says Getting ready, so a first run downloads nothing. An installation missing its models offers the downloads instead, naming where they come from and their size. Any search, typed, spoken or suggested, finishes the setup.

Borago Studio, in a window of its own

Enhance, Borago Studio's photo app, comes with every build. Open in Studio in the viewer hands it the photo.

How it works

Studio opens straight into Enhance, which adjusts light and colour, crops and straightens, and applies filters and effects. Studio's other apps, its sound apps among them, are not in this build. Studio opens from Studio in the title bar, from Open in Studio or E in the viewer, or when you say open Studio. From Vision, in Studio, brings the main window forward to pick photos from your library and send them across. Studio saves through the system's save dialog and never over a photo in your library. Adding a result to the library saves it in Borago's folder as a photo of its own, which is indexed. It is not yet linked to the original, and the original stays as it was. Nothing leaves the computer from Studio.

In every build

A second window

Ctrl+N, Cmd+N on a Mac, opens another window on the same library.

How it works

Each window has its own search and view. They share the library, so a tag or a memory changed in one is seen in the other.

Memories and tags

A memory is photos you chose

Pick photos from any search or the timeline and gather them under a name. It shows the same photos every time.

How it works

Select starts picking, or hold Ctrl and click. Shift picks a range. Space picks from the keyboard. A bar along the bottom counts what is picked and offers Add to memory, which names an existing memory or makes a new one. Picked photos survive a new search, so a memory can be gathered from several.

An order of your own

Newest first, oldest first, or your order. Move photos earlier, later, to the start or the end.

How it works

Move is in the bar while picking, and Alt with the arrow keys, Home and End moves a focused tile. Your order starts from what is on screen, so nothing jumps. A photo added later goes at the end.

A view of their own

Every memory as a card with a cover. Open one and search inside it.

How it works

Memories is the third view beside Search and Timeline. Opening a memory is browsing with that memory as the filter, so the grid, the month headings, the count and the search field all work as they do for the library. Rename, Delete memory and Close memory sit in a header over it. Deleting a memory never deletes a photo.

Ctrl+3, Cmd+3 on a Mac, or say show my memories

Found by name

A word in a memory's name finds its photos. So does a tag.

How it works

Memory names and tags are searched as words alongside content and text, and a result found that way says In a memory or names the tag. Memories are also listed first under the search field, each with its newest photo as a cover.

Suggested memories

The Suggestions view proposes your trips and your big days. Make memory keeps one, Dismiss takes it away.

How it works

A trip is days in a row whose photos were mostly taken away from home, titled by where and when, such as Sydney, 20 to 24 March 2025, so it needs photos with a GPS position. A big day is one to three days with at least 20 photos and three times your usual day. Up to three people you named, each in at least 30 percent of the photos, are said under the title. Only dates the camera wrote count. Suggestions are worked out on your computer each time you open the view, and only what you dismissed is kept. The thresholds are not yet tried on a real family library.

Ctrl+4, Cmd+4 on a Mac, or say show my suggestions

Faces

Grouped on your computer, named only by you

Borago finds the faces in your photos and groups the same face together. It never names anyone. You can.

How it works

Face detection and grouping run on the device from the photo's largest thumbnail. What is stored is a representation of each face, its box, the group it belongs to and any name you gave the group, all inside the encrypted index. Nothing from the face tables ever leaves the computer, under any setting, paid or free. The promise in full.

Yours to turn on

Find faces is a setting, off until you turn it on.

How it works

The face models come with the application, but having them is not choosing faces, so the face pass waits for Find faces in Settings, Faces. Once it is on, a face pass runs over the library in the background, after text. Turning it off asks whether to keep the faces found and the names given, for when you turn it back on, or delete them from this computer. Until it is on, the faces filter finds nothing.

Off by default, Settings, Faces

Name a group, search by the name

Show people lists every group. Name one, and a search for that name finds the photos.

How it works

Each group shows its faces, cut from the photos' thumbnails, and how many photos it is in. An empty name takes the name away. A name another group already has asks whether to merge the two. Not this person takes a face out of a group, and it stays out. A name of up to three words is searched whole, so photos of Mary Ann finds her, and Mary alone does not.

Settings, Faces, Show people

Where the limits are

Grouping is measured on a public benchmark, not yet on a family library.

How it works

The benchmark is well-lit, front-facing faces. Children, profiles, decades of age difference and poor light, which a family library is full of, are not yet measured.

Privacy and data

The short version. The privacy page has each promise in full, with its boundary.

What leaves, and when

An update check to Borago Soft, and a web image you allow it to fetch. That is the whole list, unless an installation is missing its models.

How it works

A packaged build asks Borago Soft's update server whether a newer version is out, and the request carries nothing about you or your library. A web image dropped on the window as an address is downloaded only after you allow it. The models come inside every package. An installation missing them offers to download them from Borago Soft, Hugging Face and GitHub, which see your address and which file was fetched, nothing else. A check script runs the whole app through indexing and a search and fails on any other connection off the machine.

An encrypted index

The index and the thumbnails are encrypted with a key kept in your system keychain.

How it works

That keeps your library from other accounts on the machine, from backups and from anyone with the disk. It does not keep it from a program running as you, and the privacy screen says so. Logs are encrypted with a key of their own and never record what was searched for.

A screen that says what is kept

Settings ends with a plain list of what Borago stores, where, and what leaves the computer, with a Show button for each place.

How it works

Every path is this computer's own. The screen describes the encryption as no stronger than it is, names the update check and the download hosts, and lets you turn an Always allow for web images back into a question.

Delete all data

Everything Borago keeps goes in two steps, the second by typing delete. Your own folders are never touched.

How it works

The index, thumbnails, settings, logs and Studio's storage go. Models go unless you keep them. Photos in Borago's own folder go only if you choose that, after a warning that some may be the only copy. Borago then starts again from setup.

No account, no telemetry

You need no account, and nothing is reported back. Not usage, not crashes, not searches.

How it works

Settings has an Account section for Borago's cloud. The cloud, with encrypted sync between your own computers, is not running in this alpha, so the section says the service is not reachable, there is nothing to sign in to, and nothing is sent. Every feature on this page works without an account.

A thumbnail cache you can cap

Thumbnails live beside the index. Set a cap of 1, 5 or 20 GB and the oldest are evicted first.

How it works

The cap is off until you set one. An evicted thumbnail costs one decode of the original the next time that photo is shown, nothing else. Settings shows the cache's size.

Platforms

One codebase, one installer per platform. Version 0.0.4, an alpha, is out for macOS on Apple Silicon and Linux x64. Windows is not built yet. Download it.

PlatformNeedsIn the alpha
macOSmacOS 11 or later, on Apple SiliconA disk image, signed with a Developer ID and notarized. No Intel build yet
Linuxx64An AppImage, which is not signed, and a deb and an rpm, which add Borago Vision's signed apt or dnf repository

Minimum 4 GB of memory. On disk, the application and its models, which unpack to 809 MB on the first run, plus the index and thumbnails for your library. The index is budgeted at under 2 GB per million photos. Thumbnails are separate and can be capped.

Related: Download, Privacy, FAQ.