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.
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.
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.
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.
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.
Search
By what is in the picture
A pineapple. A yellow hat. A graduation. Describe it and Borago finds it, with no fixed list of categories.
How it works
Each photo's content is represented in a form that can be compared with free text, by a model that runs on your computer. The query is compared with every photo and the closest come first. Words it has never been told about work, because nothing is predefined. The model, 454 MB, comes inside the package, so nothing is downloaded.
By date, the way you say it
2016. Last summer. Winter photos. Photos from March. Borago reads the date out of the sentence.
How it works
Absolute dates, relative ones and seasons are understood from the words, with no model involved, so this part of a search is instant. The date applies to the photo's capture date where there is one, and its file date otherwise. The rest of the sentence is still searched as content.
By the text inside the photo
Signs, receipts, slides, whiteboards, screenshots. The words in a photo are searchable.
How it works
Text is read from each photo at full resolution in a pass of its own, after every photo can already be found by content. The reading model, 16 MB, comes inside the package. Rotated or curved text reads less well than straight text.
By colour
Red cars. A green dress. Or pick a swatch in the filters. Borago keeps each photo's five main colours.
How it works
A colour word in the query is matched against the photo's palette, and the filters offer a colour to narrow any result set. The palette is made during indexing from a small decode of the photo and costs nothing extra.
By place
Sydney. Photos in Paris. Sri Lanka. A photo with a GPS position is named after where it was taken, on your computer.
How it works
Each position is matched against a table of places from GeoNames that comes with Borago, so nothing is looked up online and the position goes nowhere. A photo answers to its district, town, city, region and country, so one taken in Surry Hills is found by Sydney and by Australia. A part of a name finds nothing, because it is usually another place. A result found this way says Taken there. Names a place has in other languages are not searched. A photo with no GPS position has no place.
All of it in one sentence
Mountain photos from summer 2019. Content, season and year apply together.
How it works
A query is split into the parts the date grammar understands, the colour words, and the rest, which is searched as content, as text inside photos, as tags, as memory names, as places, as the names you gave people and as file names. Each part ranks the library on its own and the rankings are combined, so a photo near the top of several lists wins. Nothing is dropped from a sentence: whatever is not understood as a date or a colour is still searched.
Ranked, with the reason shown
Results come in order of relevance, not date, and each one says why it is there.
How it works
The best answer is shown large, the rest of the top results in a carousel, and everything found in a grid below. Each result names what matched: the picture, words found in it, a tag, a memory it is in, where it was taken, or its file name.
Filters
Narrow any result by date range, folder, file type, colour, whether it has text, and whether it has faces.
How it works
Filters sit under the search field and apply on top of the words. A folder filter for a folder that has since been removed comes off on its own. The faces filter finds nothing until you turn on Find faces in Settings.
Saved searches and recent ones
Save a search by name and run it again. Recent searches are listed under the field and can be cleared.
How it works
Save search appears at the end of the filters row whenever there are words or filters on screen. It keeps the words and the filters together, and a saved name that already exists is replaced on request. Recent searches are kept on this computer only and go when you clear them. Both are stored inside the encrypted index.
Your own tags
Add a tag to a photo in the viewer. Keywords already written into a file count too.
How it works
Tags are added and removed in the viewer's details, with the library's existing tags offered as you type so one spelling is reused. A tag is searched like a word. A word in the name of a memory the photo is in works the same way.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
| Platform | Needs | In the alpha |
|---|---|---|
| macOS | macOS 11 or later, on Apple Silicon | A disk image, signed with a Developer ID and notarized. No Intel build yet |
| Linux | x64 | An 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.