How to use Reverium.

Download the latest .dmg from reverium-releases, drag Reverium.app to your Applications folder, and launch it.

On first launch macOS may show a Gatekeeper warning ("can't be opened because the developer cannot be verified"). Right-click the app → Open → Open again — macOS will remember the choice. We're working on notarization to remove this step.

Reverium runs entirely on your machine. There's no account required to start — you can begin collecting immediately. Email sign-in is only needed for cloud backup, Telegram bot linking, and Pro features.

Reverium is built on three primitives. Understand these and the rest is intuitive:

• Item — anything you save (a Vimeo cut, a still, an audio track, a PDF). Each item has a thumbnail, source URL, tags, rating, notes, and an optional local copy.
• Folder — a manual collection of items. One item can live in many folders. Folders are for projects, mood references, client boards — not for organization-by-type (use tags for that).
• Moodboard — a free-form canvas where items live as cards you can move, group, and connect. The same item can appear on multiple moodboards without being duplicated.

Everything is local-first: your library is a single database on your disk. Cloud sync is optional and only stores metadata (titles, tags, notes) — not the actual videos or images.

Six ways to put something into your library:

1. Drag & drop — files from Finder, images/videos from a browser, even text snippets onto the window.
2. Paste a URL — ⌘V with a link in your clipboard opens the Add URL dialog. Reverium fetches title, description, thumbnail and (when possible) the video file itself.
3. Quick save — ⌘⇧V saves the URL on your clipboard immediately, without opening a dialog.
4. Browser extension — a bronze "R" chip appears on every supported site. One click and the page is in your inbox. See browser extension.
5. Telegram bot Pro — send a link to @reverium_bot; it syncs into your inbox within seconds. See Telegram bot.
6. Eagle / RAW import — File menu → Import… — bulk-imports thumbnails and metadata from existing libraries.

Reverium understands the structure of these platforms — it pulls real titles, thumbnails, durations and (where possible) the media itself:

• Video: Vimeo, YouTube, Instagram (Reels / Posts / TV), Pinterest (including native video pins), TikTok, Twitter / X, Tumblr, Reddit, generic og:video sites.
• Audio: SoundCloud (full track via Widget API), Bandcamp (full track / album via EmbeddedPlayer), Artlist (metadata + link-back; preview playback only).
• Images: any web image, Pinterest pins, Behance, etc.
• Documents: PDFs (drag & drop).

For unsupported sites Reverium falls back to OpenGraph metadata — you'll still get a thumbnail, title and a "Open source" link.

Every item has a type that determines how it plays back and what tools are available:

• Image — opens in a full-screen viewer.
• Video — opens in the video player with seek bar, IN/OUT markers, frame stepping.
• Audio — opens in an embedded player (SoundCloud Widget / Bandcamp Player / Artlist card).
• Document — opens in the system viewer (Preview).
• Clip — a trimmed GIF/MP4 exported from a video.
• Scene — a still preview from an auto-detected video scene.
• Other — anything Reverium couldn't classify; still has thumbnail, tags, notes.

The left sidebar is your view-switcher. From top to bottom:

• Videos, Images, Favorites, All items — type-based filters.
• Inbox — items captured by the browser extension or Telegram bot that you haven't yet sorted.
• Last added — newest first across all items.
• Sorted — items that already live in a folder (helps you see what's still loose).
• Editorial Pro — long-form articles and interviews curated by Reverium.
• Folders — your project / mood collections. Right-click for context menu (Rename, Delete, Duplicate).
• Moodboards — your canvases.
• Tags — every tag you've used, with counts.
• Trash — recently deleted; emptied manually or after 30 days.

Resize the sidebar by dragging its right edge. Collapse it entirely with ⌘[.

Click + New folder at the top of the Folders section in the sidebar. Drag items onto a folder name in the sidebar to add them. One item can live in many folders simultaneously.

From the Inspector you can see and toggle every folder an item is part of — the "Folders" section lists all folders with checkboxes.

Open in Finder — right-click a folder → Show in Finder. Reverium opens the corresponding directory on disk where any downloaded media for items in that folder is stored.

The toolbar at the top has a search box. It searches across:

• Item titles
• Tags
• Notes
• Source URLs (host names)
• Voice note text (transcribed)
• Video transcripts Pro

Filter chips appear below the search box: click a tag, color, rating or type to narrow further. Multiple chips combine with AND.

Sort modes — to the right of the search: Newest, Last edited, Most played, Rating, Title. Click again to reverse direction.

Type a natural-language query (woman dancing in a red dress) and Reverium finds matching visual content across your library — even items you never tagged. Powered by an on-device CLIP model: no data leaves your machine.

How it works:

• When you save a video or image, Reverium computes a visual embedding in the background (a few seconds per item).
• For videos, embeddings are computed per-scene — semantic search opens the video at the exact second your query matched.
• Click any result to jump straight to that moment.

Indexing status appears in the bottom-right corner ("Indexing 12 of 340…"). You can browse normally while it runs.

Deleting an item moves it to Trash, not off the disk. Trash is in the bottom of the sidebar. From there you can Restore or Empty trash. Items in trash are automatically removed after 30 days.

Deleting from Trash is permanent — also removes any local downloads. Cloud snapshot still holds metadata for 7 days (see Cloud backup).

Select any item and the right panel ("Inspector") shows everything about it. Top-to-bottom:

• Preview — click to open in the player.
• Platform badge — Vimeo / YouTube / Instagram / SoundCloud / Bandcamp / Artlist.
• Duration for video / audio items.
• Show in Finder + Delete local (only if downloaded). "Delete local" opens a confirmation — it removes the file but keeps the item entry, so you can re-download anytime if the source URL still works.
• Download button + quality picker (360p / 480p / 720p / 1080p) for sites that allow it.
• Palette — auto-extracted dominant colors. Click any swatch to filter the library by similar palette.
• Title, Source URL, Rating, Color label — all editable inline.
• Tags — see tags.
• Notes — markdown-style plain text, auto-saves.
• Voice notes — see voice notes.
• Folders — checklist of every folder; toggle to add/remove.
• Stills / Clips / Scenes — children captured from this video.
• Metadata — added date, file size, dimensions, fps, etc.
• Delete at the very bottom (red) — moves to Trash.

Resize the Inspector by dragging its left edge. Collapse it with ⌘] for more grid space.

Tags are the fastest way to organize. They're free-form text and any item can have many. To add a tag in the Inspector, click the input below the "Tags" header, start typing — Reverium suggests existing tags. Press Enter to apply, or click a suggestion.

Suggest tags — a button that asks Reverium to propose tags based on the item's visual content and existing tags in your library. Pick the ones you like; the rest are discarded.

Classify shot — for videos, suggests a shot-type tag (wide / medium / close-up, eye-level / low-angle, day / night, etc.).

Tag synonyms — in Settings you can map tags to synonyms (e.g. sunset ⇔ закат). Search for one and results for both appear.

Remove a tag by clicking the × on its chip. Empty tags (no items left) automatically disappear from the sidebar list.

Each item can have 0–5 stars and one of 8 color labels (red, orange, yellow, green, blue, purple, pink, none). Both are editable in the Inspector and visible as small dots/badges on the card.

Filter by color/rating: click a color swatch or star count in the Inspector while holding ⌘, or use the filter chips above the grid.

Plain-text notes per item. They auto-save as you type — no need to hit a save button. Notes are searchable from the toolbar search box.

Notes appear in moodboards when you hover over a card too — handy for quick context about why this reference matters.

For videos and stills you can record a voice memo right inside the Inspector. Click the microphone icon in the "Voice notes" section, record (up to 3 minutes), stop. Reverium transcribes the audio automatically.

Why use voice notes: faster than typing for spontaneous ideas ("nice lens flare around 0:34", "use this transition in the bridge scene"). The transcript is searchable.

Playback — click the play button on a voice note. For video items, a voice note can be "anchored" to a specific timecode — playing it auto-seeks the video to that moment.

Double-click a video to open it. The player has three modes:

• Local — for downloaded videos. Full controls: frame stepping, IN/OUT markers, captions, speed.
• Stream — embedded Vimeo / YouTube / Instagram player. Play/pause/seek/volume work via their APIs. Frame stepping and IN/OUT are not available (the embeds don't expose enough control).
• Direct — for sites that give a direct MP4 URL (Pinterest, Reddit). Same controls as Local.

Keyboard controls:

• Space — play / pause
• ← / → — seek 5 sec
• ⇧← / ⇧→ — seek 1 frame (for Local / Direct)
• I / O — mark IN / OUT
• L — toggle loop between IN and OUT
• C — toggle captions Pro
• F — fullscreen
• ↑ / ↓ — volume
• 1–9 — jump to 10%, 20% … 90%
• Esc — close player

Audio items (SoundCloud / Bandcamp / Artlist tracks) double-click into a player matching the source platform:

• SoundCloud — full track via Widget API. Visual mode shows the artwork.
• Bandcamp — full track or album via public EmbeddedPlayer. Album items show a clickable tracklist.
• Artlist — info card with artwork, artist, BPM, album description and an "Open on Artlist" link. Playback happens on Artlist itself (their preview limits apply).

For Local / Direct video, you can set IN and OUT markers on the timeline. Use them for:

• Looping — press L to play only the IN–OUT section on repeat. Great for studying a few seconds in detail.
• Capturing a clip Pro — export the IN–OUT range as a GIF or MP4 (see Trim & export).
• Multiple segments Pro — right-click the timeline → Add segment. Reverium remembers every segment between sessions and you can export them all at once.

Press ⇧I / ⇧O to clear the markers.

For Local videos, Reverium can generate captions on-device using Whisper. Click the Transcribe button in the Inspector — it runs in the background (a few minutes for a 5-min video).

Once ready, captions appear over the video (toggle with C) and the transcript becomes searchable from the toolbar. Click any line in the transcript panel to jump to that moment.

Export the transcript as .srt from the Inspector → Export menu.

In the video player click the camera icon (or press S) to capture the current frame as a still. It's saved as a new image item, automatically linked to the parent video — you'll see it in the Inspector's "Stills" section of the parent.

Stills are saved at full source resolution and inherit the parent video's tags. Use them as poster frames for moodboards, references for colorist sessions, or simply as visual bookmarks.

Set IN and OUT markers (see IN/OUT), then press E or click the Export button. Pick a format:

• MP4 — H.264 + AAC, plays everywhere.
• WebP — looped animation, much smaller than GIF, great quality.
• GIF — classic, biggest file, max compatibility.

Exported clips appear in your library as new "clip" items, linked back to the source video.

Multi-segment export — if you've defined multiple segments, you can export them all at once into a single file (concatenated) or as separate clips.

For Local videos, Reverium can analyze the footage and auto-detect scene boundaries (hard cuts). Right-click the video in the grid → Detect scenes. Each scene becomes a sub-item with its own thumbnail.

Useful for browsing a 40-minute talk by chapters, or building a moodboard from a music video's beat changes.

Moodboards are infinite canvases. Click + New moodboard in the sidebar to create one. The canvas appears in the main area — drag items from the grid (open it in a second column via ⌘L) or from anywhere in Finder / your browser.

What you can do on a moodboard:

• Drag & resize any card. Hold ⌘ while resizing to keep aspect ratio.
• Group selected cards: ⌘G. Groups can be resized and moved as one block.
• Connect cards with arrows: drag from a card's edge to another card. Useful for visualizing flow / influence.
• Paste images directly from clipboard. They become hidden items (live in this moodboard only, not in your main library).
• Group resize — when you resize a group, child cards scale proportionally inside it.
• Reorder with ⌘[ / ⌘] — send backward / bring forward.

Export a moodboard as a high-res PNG or as a PDF. File → Export moodboard…

The same item can appear on many moodboards — it's a reference, not a copy. Tag, rate or rename an item once and every board sees the update.

Editorial is Reverium's curated reader — long-form articles, interviews, DP breakdowns, and shot-by-shot analyses. Click Editorial in the sidebar.

Inside an article:

• Mixed media — text, images, embedded video, audio, code, quotes.
• React with emoji at the bottom — they're public and aggregated.
• Save references — every embedded media item has a "Save" button that adds it to your library as a normal item.

New articles are published weekly. Notifications appear as a badge on the Editorial sidebar entry.

Reverium works without an account. Sign in only when you want:

• Cloud backup of your library metadata Pro
• Telegram bot to send into your inbox
• Access to Editorial Pro

How sign-in works: Settings → Account → Sign in with email. Enter your email. Reverium sends a 6-digit code to your inbox. Enter it (you can paste from clipboard). That's it — no password.

Sessions last 8 weeks. Sign out from Settings → Account whenever you want.

Stores a compressed snapshot of your library metadata — items, folders, tags, moodboards, settings — in Reverium Cloud. Roughly 0.5–5 MB per user.

What's backed up: everything you can see in the app except the actual videos / images on disk. If you reinstall on a new Mac, signing in restores your entire structure — and you can re-download media that's still online via the source URLs.

Schedule:

• Auto-snapshot 5 minutes after any meaningful change.
• Retention: last 7 daily + 4 weekly + 12 monthly snapshots.
• You can also create labelled snapshots manually ("Before reorganize"), which are kept indefinitely.

Restore: Settings → Cloud backup → pick a snapshot → Restore. Restoration is atomic — your current library is replaced only after the restore fully succeeds; interrupted restores leave your data untouched.

End-to-end encryption is planned but not yet shipped. Data is currently protected by TLS in transit and ACL at rest.

Settings → Storage. Shows where your library lives on disk and how big it is. A treemap visualizes which folders / items eat the most space.

Three operations:

• Cleanup unused videos — finds local copies of videos you haven't opened in 60+ days. Preview the list, then delete. Source URLs remain — you can re-download anytime.
• Move library — pick a new location (external SSD, network drive). Reverium copies everything, verifies, then switches to the new path. Source folder is kept by default — delete manually when confident.
• Reveal in Finder — opens the library folder for manual inspection.

Download the extension from reverium.app → Download. It works in Chrome, Arc, Brave, and Edge. Firefox / Safari are on the roadmap.

Once installed, a small bronze "R" chip appears in the bottom-right corner of every supported page (Vimeo, YouTube, Instagram, Pinterest, SoundCloud, Bandcamp). One click and the page is added to your Reverium inbox.

Pair with your account — the first save asks for a pairing code, generated in Reverium Settings → Browser extension. Once paired, saves go directly to your library.

@reverium_bot accepts any link or media. Forward a reel, paste a YouTube link, drop a photo — it lands in your Reverium library in seconds.

Why it's Pro: the bot relies on Reverium Cloud to relay messages from Telegram to your desktop in real time — that infrastructure (sync queue, atomic delivery, multi-device replay) is the same that powers Cloud backup. Available with any Pro plan including the Founding Supporter perpetual license.

Linking your account: in Reverium → Settings → Account → Telegram bot → Generate link code. You'll see a 6-letter code. Send /link CODE to the bot. Done — the bot now delivers everything you send straight into your library.

Auto-import is on by default — links appear in your Inbox sidebar within a second. Toggle off in the Telegram card if you'd rather review each item before saving.

Use it from your phone, your couch, or anywhere outside the Mac. Especially handy for capturing things you stumble on during the day.

Library / navigation

• ⌘N — new item from URL
• ⌘V — paste URL from clipboard (opens dialog)
• ⌘⇧V — quick save (no dialog)
• ⌘F — focus search
• ⌘[ / ⌘] — toggle sidebar / Inspector
• ⌘L — split view (open second column)
• ↑ ↓ ← → — navigate grid
• ↵ — open selected item
• ⌘A — select all visible
• ⌫ — move to Trash
• ⌘⌫ — delete permanently (from Trash)

Player

• Space — play / pause
• I / O — mark IN / OUT
• L — loop IN–OUT
• S — capture still
• E — export clip Pro
• C — toggle captions Pro
• F — fullscreen
• Esc — close

Moodboard

• ⌘G / ⌘⇧G — group / ungroup
• ⌘D — duplicate
• ⌘+ / ⌘- — zoom in / out
• ⌘0 — fit to view
• Space + drag — pan canvas

Reverium Free includes everything you need to collect, organize and review references. Reverium Pro adds the AI-powered tools and cloud features.

How to upgrade: Settings → Account → Upgrade to Pro. Reverium Pro is a monthly or yearly subscription. Founding supporters (early backers) keep Pro forever at no recurring cost.

Where is my library stored?

Default: ~/Documents/Reverium. You can move it to any location (external SSD, network drive) from Settings → Storage.

Is my data private?

Yes. Everything lives on your machine. The only cloud component is optional metadata backup (Pro). Telemetry is minimal and opt-in (Settings → Privacy).

What happens if a Vimeo / YouTube link becomes private?

If you already downloaded the video, it still plays from your local copy. The thumbnail and title remain. If the source goes private before you download, you'll keep the thumbnail and metadata Reverium fetched at save time.

Can I use Reverium on Windows / Linux?

Not yet. macOS only (Apple Silicon recommended). Windows is on the roadmap.

I lost my email — how do I get back into my account?

Email support@reverium.app from any email address with your Founding Supporter code or order receipt. We'll reset the linked email.

How do I contact support?

support@reverium.app or DM @reverium_bot on Telegram with /support.