Media Viewer

Zoom into screenshots, step through recordings and play audio in bb's right panel instead of a fit-only preview. Drag to pan, pinch or Ctrl-scroll to zoom at the pointer, and double-click to switch between Fit and a close-up. Previous and next step through every image, video and audio file in the same folder. Videos get frame stepping, seeking and speeds from 0.25× to 2×, and agents can show the same viewer inline in a reply with a ::media directive.

Overview

View source

What you get

Zoom and pan in the right panel. Images, videos and audio files open in a viewer instead of bb's fit-to-panel preview. Drag to pan, pinch or Ctrl/Cmd-scroll to zoom at the pointer, and double-click to switch between Fit and a close-up. Fit and 100% buttons sit in the toolbar, and pixels stay sharp above 200%.
Every file in the folder. Previous and next buttons, or the arrow keys, step through the other images, videos and audio files in the same folder, in name order.
Video you can inspect. Play, step one frame at a time, seek, change speed from 0.25× to 2×, mute, and zoom into the frame.
Media inline in chat. Agents can write ::media{file="/path/to/shot.png"} in a reply to show the same viewer in the message, with a button that opens the file in the right panel.

How it works

The viewer takes over wherever bb opens a matching file in the right panel: file links, the file picker and bb thread open. Files stream through bb's own file routes, so long videos seek without downloading the whole file, and files on any connected machine work. To keep bb's own preview for a file type, choose it under Settings, File openers, or use Open with on a file.

The plugin ships a media-viewer skill that tells agents to put the files they want to show in one folder and open the first one in the right panel.

Supported files

Images: png, jpg, jpeg, webp, gif, avif, bmp, ico, svg
Video: mp4, m4v, mov, webm
Audio: mp3, m4a, aac, wav, ogg, oga, opus, flac

Formats play as far as bb's browser engine supports them. A file the viewer cannot decode shows an error with a button to use bb's preview instead.

More in File Viewers & Editors 29

Browse, open, preview, or edit files and document vaults.

View all

DocsCollaborate with agents on editing Markdown docs inline. Edit directly inside threads, approve/reject proposals from an agent, and undo/redo changes.BB992

File ManagerManage the files on the machine bb runs on without a terminal: browse, upload, move, rename, extract and hand them to the agent. Opens as a sidebar page, as a tab beside a thread that can start in that thread's folder, and from a file link in a message. Double-click shows images, PDF, video, Markdown and code; Space looks inside zip, tar, 7z and rar archives without extracting them. Multi-gigabyte uploads resume after a dropped connection, and several files or a whole folder download as one zip. On a phone, selected rows get an Actions bar with the whole row menu. Access stays inside the home folder of the user bb runs as; tar, 7z and rar archives need tar and 7z on that machine.

Foma530

FilesA VS Code-style file explorer and editor for the workspace behind a thread. Search in files finds a word across every file in the project: results are grouped by file with each hit highlighted, and clicking one opens the file on that line. It is smart case, with match-case, whole-word and regex toggles, and built for typing — file contents stay in memory between searches, so refining a query re-runs in tens of milliseconds, and a regex runs in its own worker so a runaway pattern cannot freeze BB. Around it: a file tree that shows dotfiles, editor tabs, a go-to-file palette (Cmd+P), find in the open file (Cmd+F), syntax highlighting in your BB code theme, and edit and save guarded so a change an agent made underneath you is never clobbered. Markdown files open rendered, with the source and the editor one click away. Two pickers choose the project and then its checkout or one of its worktrees; beside a thread it is pinned to that thread's worktree. Adds a `bb files` command so agents can browse and read the same workspace from the CLI, on whichever machine it lives.

AbdElrahman Telb367