# Adding things

Six doors into the same vault. Whatever comes in gets a thumbnail, a place, and, with the Curator on, a title and tags.

*Written from Teserra 1.3.16.*

**In short**

1. Drop files on the grid, or **File → Import Folder…** for a whole folder.
2. Press `⌘⇧M` in any app to capture an area of the screen.
3. With the browser extension, hold `⌥` and click any image or video.

## Drag and drop

Drop files from the Finder, a browser or any app onto the grid. Drop them while a collection is open, or onto a collection in the sidebar, and they join that collection. Duplicates are caught by content, not by name: the same image twice is stored once.

## Import…

**File → Import Files…** (`⌘O`) or **Import Folder…**, which brings in everything Teserra can read inside the folder and its subfolders. **Import Installed Fonts** pulls the fonts you installed for your user (~/Library/Fonts) into the library as specimens.

## Paste, ⌘V

An image in the clipboard becomes an item. A URL becomes a **link card** or an **article**: Teserra decides from the page, and a toast lets you switch.

## Capture, ⌘⇧M

From any app: select an area and it lands in the vault. The shortcut can be changed in Settings → Capture. While Teserra is in front, `⌘⇧W` captures a window, `⌘⇧F` the whole screen, `⌘⇧S` opens **Studio**: the window on a backdrop, margins, arrows, text, numbered badges, a redaction tool. The menu bar icon offers all four captures from any app and any Space. Every capture also appears in the **Captures** view.

*(new in 1.3.10)* For five seconds a small bar waits at the bottom right of the screen under your pointer, without bringing Teserra forward: drag the shot into Slack, Figma, Mail or Finder, copy it, or file it in a collection. Point at the bar to keep it. It is **Quick actions after a capture** in Settings → Capture, on by default.

[Clip: ⌘⇧M over a music player; the bar Screenshot added, with Copy and Add to…, waits at the bottom of the screen and the shot is dragged into a Slack message.](https://teserra.app/assets/tour/capture.mp4)

> **macOS screenshots too.** Turn on **Settings → Capture → Offer to save images you copy** and the same bar appears when an image lands in your clipboard, a macOS screenshot set to copy for example. Nothing is saved unless you click **Save**. The first time, macOS asks whether Teserra may paste from other apps: choose Allow, or set Teserra to Always Allow in System Settings → Privacy & Security → Paste from Other Apps.

## From the browser

The browser extension, for Chrome, Firefox and Safari, saves a page as a card, an article as clean offline text, or any image or video with an Option-click. [Set it up](https://teserra.app/docs/chrome-extension)

## From your agents

With Agent access and **Allow changes** on, Claude Code, Raycast or Cursor can import a URL and file it in a collection for you. [Agent access](https://teserra.app/docs/agents)

## What formats

| Family | Formats | What you get |
| --- | --- | --- |
| Images | JPG, PNG, WEBP, HEIC, AVIF, GIF, TIFF, BMP | Thumbnails, palette, EXIF, GIF and WEBP animate on hover |
| RAW | CR2, CR3, NEF, ARW, RAF, ORF, RW2, DNG, PEF and most other camera formats | Preview from the camera's embedded JPEG, sensor size, EXIF, full-size export |
| Fonts | TTF, OTF, TTC, OTC | Composed specimens, a viewer, install and uninstall |
| Video | MP4, MOV, M4V, WEBM, MKV, AVI | Poster frame, duration, a player with chapters. WebM, MKV and AVI need ffmpeg installed (`brew install ffmpeg`) |
| Documents | PDF, SVG | First page as preview, vectors that zoom sharp |
| Web | Links, articles, X posts | Cards with a live Peek, clean offline text, tweet videos saved locally |

> **Nothing to save yet?** [Where to find pictures worth keeping](https://teserra.app/where-to-find-references): the places to look, by what you make, with the gesture that works on each.