Documentation

Guides for local files, Canvas workflows and optional cloud providers.

Everything you need to get the most out of OY.Surf — how each feature works, what to click, and why. Use the search on the left, or start with Getting started.

Browse by topic

Getting started

• Getting started — Install OY.Surf and open your first folder.
• Library & folders — Quick folders, favorites, and how indexing works.
• Tags — Tag one file or a whole selection, then filter the library by tag.
• Import from Eagle — Bring your Eagle tags, folders, ratings, links and notes across — without touching the library.

AI & creation

• Lenses — Palette, OCR, scenes and AI descriptions for any file.
• Search — Find by meaning, by text-in-image, and by filters.
• Create — images & video — Generate images locally or with your key; create videos through fal.
• Edit images — Instruction edits and local finishing tools, with separate output files.
• Canvas — references & workflows — Arrange references, connect image steps, inspect results and reuse recipes.
• Portable Canvas recipes — Save a chain, export or copy its JSON, and apply it with a new reference.
• Motion — animate your images — Pick images, pick a template, export a loop. 200+ parametric templates, 70+ controls, real easing curves, 4K and alpha.
• Mockups — 3D device & apparel — Put your work on a MacBook that opens, apparel, a mug, a framed poster or a business card — studio light, animatable camera, transparent PNG.

Capture

• Surf Studio — screen recording — Record, edit on a multi-lane timeline, export MP4/GIF at pro speed.
• Surf Flow — voice dictation — Hold a key, talk, get cleaned text — transcribed on-device.
• Notes — Markdown notes pinned to your files and projects.

Models & privacy

• Models & downloads — Model downloads, storage requirements and optional authentication.
• On-device vs cloud — Local by default; optional cloud requests use the provider you choose.
• Connecting API keys — Connect fal, OpenAI or OpenRouter for optional cloud AI.

Integrations

• Figma integration — A local bridge so Figma and OY.Surf talk on your machine.
• MCP server & agent scenarios — Let AI agents search, curate and organize your library — locally, token-guarded.

Reference

• Settings — A tour of every Settings tab.
• Keyboard shortcuts — The keys that make OY.Surf fast.
• Privacy — Local work, optional providers and data you choose to share.