← Guide

Library

The Library shows every capture in your captures folder (default Pictures › Frayo, see Cloud sync folders), including files you drop into it yourself. Open it with ⌥⇧H, or choose Library in the menu.

The grid

Each tile shows a preview and a caption. The caption is the name you gave it. Without one, it is the app and window title that were in front ("Safari · Pull Request #482"). If there is no title, it is the time: "4:12 PM", "Yesterday 4:12 PM", or "Nov 3, 4:12 PM". Times follow your Mac's language and region settings, including 12-hour or 24-hour clock.

Tiles have a saved badge, a kind icon, and a badge for recordings. The subtitle shows how many captures match.

Search

Type in the search field. It matches:

• the capture's name and the app or window title
• its date
• the text inside the screenshot

Frayo reads the text in each screenshot on your Mac (the text stays on this Mac and is never written into the folder), in the background, with macOS's Vision framework. A new capture is searchable a moment after you take it. Older ones are indexed when you open Frayo. Recordings and GIFs are not text-searched. They match on name and date.

Filters

The toolbar has three filters. They combine.

• Type: All, Screenshots, Recordings, GIFs, Saved.
• Date: Any Time, Today, Yesterday, This Week, Last Week, This Month, Last Month. Weeks follow the first day of the week set on your Mac.
• Project: appears once you have a project. Pick All Projects, No Project, or one project. See Projects.

Quick actions

Hover a tile for icons: Copy, Edit (double-click), Pin (screenshots) or Convert to GIF (recordings), Rename, Keep Forever, Trash. A tile with an orange key badge may hold a secret, and gets a Redact icon too (see Secret detection). Right-click for the full menu, including Save As…, Move to Project, Copy as Markdown and Copy Bug Report (see Bug reports).

Select several

• Click one tile, then ⌘-click or Shift-click more.
• ⌘A selects everything currently shown. It respects your filter and search.

A bar appears at the bottom with the bulk actions:

• Copy: puts all selected files on the clipboard.
• Rename: one prefix for all, then numbers, oldest first.
• Project: move them into a project.
• Keep Forever: saves all. If they are all saved already, unsaves them.
• Trash: moves them to the Trash.

Safe delete

Select all and press ⌘⌫. Plain Delete does nothing, on purpose.

Saved captures and project captures are kept by default. The confirmation tells you how many. Choose Move to Trash to trash the rest, Move All to Trash to trash everything, or Cancel. A message offers Undo right after.

Saved

Save keeps a capture forever: the thumbnail's Save (which also copies it), ⌘S in the editor, or Keep Forever in the Library. Save makes no copy. If your default format in Settings › Saving differs from the capture's (GIF for recordings, JPEG), Save also writes that format beside it, and that file is the saved one. Unsave in the Library undoes it. Find them under the Saved filter.

How long captures stay

By default, Frayo moves unsaved captures older than 30 days to the Trash. You can restore them from the Trash. Change this in Settings › Library › Keep unsaved: 7, 30, 90 days, 1 year or Forever. Only the Mac that took a capture ever moves it to the Trash, and only from the top of the folder. Saved captures, captures in a project, files you dropped into the folder yourself, and captures from your other Macs are never removed this way.

Keyboard