Composing the shot before you press render.
ProFrame overlays composition guides, platform-accurate crop formats, and a light compositor pipeline directly onto your camera view — built for product photographers and social/e-commerce creators working in Blender.
Installing ProFrame
- 1Open Blender, then go to Edit › Preferences › Add-ons.
- 2Click the dropdown in the top-right and choose Install from Disk…, then select
proframe.py. - 3Enable the checkbox next to ProFrame in the add-on list.
- 4In the 3D Viewport, press N to open the sidebar, then click the ProFrame tab on the right edge.
Interface Tour
Every ProFrame feature lives in one collapsible panel, opened and closed section by section so you only see what you're using. The master switch is the ProFrame ON/OFF toggle at the very top — turning it off hides every overlay instantly without losing any of your settings.
Section boxes
Camera, Guides, Platform, Render, Scale Refs, Compositor, Drawing Tool, and more — each is its own collapsible box with a ▶/▼ arrow showing its state. Every section starts collapsed on a fresh scene, so the panel opens clean; click a header to expand it.
"?" help buttons
Every section header has a small ? icon that opens this manual scrolled straight to that section — each link on the left matches one of those buttons exactly.
Active Guide Settings
Turning on a guide adds a compact settings row for it under "Active Guide Settings" — colour swatch, a reset icon, and an expand arrow for opacity/transform/extra controls.
Flash-hide
Hold \ anywhere in the viewport to instantly hide every guide and check the clean shot — see Flash-Hide Hotkey for rebinding it.
Camera
Quick camera controls so you rarely need to leave the viewport:
- Cam to View — locks the active camera to your current viewport angle, so orbiting the view moves the camera live (same as Blender's own "Lock Camera to View", surfaced here for convenience).
- Render Region — toggles Blender's render border; Draw lets you drag a new one directly.
- Set Selected as Camera / the Scene Cameras list — jump between multiple cameras in one click.
- Direct access to Focal Length, Sensor Width, Clip Start/End, Passepartout, and Depth of Field (focus object/distance, f-stop) without opening the Object Data Properties tab.
Guides
Twenty-one composition guides across seven categories. Click an icon to toggle a guide on — its settings appear below under "Active Guide Settings." Every guide has its own colour, opacity, and transform (rotation, offset, scale, invert), independent of the others.
Line Style
The Line Style dropdown next to Line Width, at the top of the panel, sets a global default — Solid, Dashed, or Dotted — that every guide follows unless overridden. Each guide's own settings (under "Active Guide Settings") have their own Line Style dropdown too, defaulting to Use Global; switch it to Solid/Dashed/Dotted instead to make just that one guide differ — a dotted Custom Grid alongside solid Thirds, for example.
Per-Camera Guides
By default every camera in the scene shares one guide setup. Turn on Per-Camera Guides (the toggle at the top of this section) to give each camera its own — every guide's on/off state, colour, opacity, transform, and Line Style, stored separately per camera. Switching the active camera automatically swaps in that camera's own guide setup, and a label under the toggle shows which camera you're currently editing.
Categories
Perspective Guides, in detail
These are the guides most worth understanding fully, since real vanishing points don't behave like the other symmetric overlays.
1-Point
A single vanishing point radiating spokes evenly around the frame's perimeter. VP X / VP Y move the point anywhere (even outside the frame); Lines sets the spoke count (3–32).
2-Point
Two vanishing points sit on a horizon line, deliberately extended beyond the frame edges — that's correct, not a bug: real vanishing points genuinely sit off-camera. Each VP's fan crosses the whole frame to the opposite edge. Horizon, VP Spread, and Lines are all adjustable.
3-Point
The 2-point pair plus a third vanishing point above the frame (fanning to the bottom edge — the "looking up" convention) or, with Below Frame enabled, below it fanning to the top edge ("looking down"). VP3 X and VP3 Distance control its position.
Guide Presets
Save the exact state of every guide — on/off, colour, opacity, transform, and every sub-setting — under a name, and recall it instantly later. Useful for switching between shoot types ("Product Shot," "Portrait Setup") without re-toggling everything by hand.
- Type a name in the field under Presets and click + to save the current setup.
- Pick a saved preset from the dropdown, then click the ↓ (import) icon to load it, or the trash icon to delete it.
- Presets are stored per-user (not per-file), so they follow you across every
.blendyou open.
Built-in presets
| Preset | What it sets up |
|---|---|
| ★ None | Hides every guide and resets all colours/settings to default — a clean slate. |
| ★ Product Shot | Thirds + Safe Zone. |
| ★ Portrait (Golden Spiral) | Golden Ratio, Spiral template. |
| ★ Symmetrical Object | Symmetry + Center Cross. |
| ★ Instagram Square | Thirds + a 3×3 Custom Grid. |
Export & Import
Click Export (next to the Presets fields) to save every preset you've made to one .json file — handy for backing them up or sharing your setup with someone else. Import loads presets from a file the same way; presets with a matching name are overwritten, everything else is added alongside what you already have. Both buttons are also available in Edit › Preferences › Add-ons › ProFrame, in case that's easier to reach.
3D Guidelines
Unlike the 2D overlays above, this is a real object placed in your scene. Click Add to spawn two small sphere empties (A at the world origin, B offset); move either one in 3D space to define a guide line that projects correctly onto the camera view from any angle. Give each its own colour. Clear All removes every 3D guideline at once, or delete a single one from its list entry.
Each guideline in the list also gets its own Hide toggle (the eye icon) and Line Style button. Hide switches a guideline off without deleting it — its empties stay in the scene, ready to bring back later — and the Style button cycles Use Global → Solid → Dashed → Dotted for that one guideline, independent of every other guide's Line Style.
3D Grid
A real, camera-facing grid mesh (built with geometry nodes) you can position and scale like any other object. Set columns, rows, width and height before adding; existing grids keep whatever settings they were created with.
Drawing Tool
Freehand annotation directly on the camera view — for sketching a pose, marking a crop, or roughing out a layout before you shoot.
Tools
Line, Rectangle, Circle, Curve (click points, click again to finish), Freehand.
Snapping
None, Grid (uses your Custom Grid's subdivisions), Thirds, or Frame (corners + centre).
Controls
Colour, opacity, line width, and Line Style per stroke; Undo Last Shape and Clear All.
Toggle Drawing Mode on, then click in the viewport to draw with the selected tool — a cursor circle shows you're active.
The Line Style dropdown (Use Global / Solid / Dashed / Dotted, same as every other guide) seeds the next shape you draw — but since there's no way to select an individual shape afterward, changing it also retroactively restyles every shape already drawn on the current camera. Reach for it to switch your whole sketch from solid to dashed at once, not just what you draw from that point on.
Platform Overlays
Shows exactly what will be cropped, cut off by UI, or safely visible when your image lands on a specific platform. Choose a Mode — Social Media, E-Commerce, or Custom — from the Platform section.
Social Media
11 platforms, 23 formats.
| Platform | Format | Resolution | Aspect |
|---|---|---|---|
| Square 1:1 | 1080×1080 | 1:1 | |
| Portrait 4:5 | 1080×1350 | 4:5 | |
| Story / Reels | 1080×1920 | 9:16 | |
| TikTok | Feed | 1080×1920 | 9:16 |
| YouTube | Thumbnail 16:9 | 1920×1080 | 16:9 |
| YouTube | Shorts 9:16 | 1080×1920 | 9:16 |
| YouTube | Channel Banner | 2560×1440 | 16:9 |
| YouTube | Community Post | 1200×1200 | 1:1 |
| Pin 2:3 | 1000×1500 | 2:3 | |
| Post 1.91:1 | 1200×630 | 1.91:1 | |
| Story 9:16 | 1080×1920 | 9:16 | |
| Cover Photo | 820×312 | 2.63:1 | |
| Post 1.91:1 | 1200×628 | 1.91:1 | |
| Profile Banner | 1584×396 | 4:1 | |
| Company Banner | 1128×191 | 5.9:1 | |
| Twitter / X | Post 16:9 | 1200×675 | 16:9 |
| Twitter / X | Header | 1500×500 | 3:1 |
| Snapchat | Story / Ad | 1080×1920 | 9:16 |
| Threads | Post 4:5 | 1080×1350 | 4:5 |
| Discord | Server Banner | 960×540 | 16:9 |
| Discord | Server Icon | 512×512 | 1:1 |
| Twitch | Channel Banner | 1200×480 | 2.5:1 |
| Twitch | Clip Thumbnail | 1280×720 | 16:9 |
Each format also carries its own safe-zone/headroom margins — shown as a dashed inner box so you can see what stays clear of UI overlap before you export. (YouTube's Channel Banner uses the platform's real "safe area" spec — the box shows exactly what survives cropping on TV, desktop, and mobile.)
E-Commerce
3 platforms, 15 formats.
| Shop | Format | Resolution | Aspect |
|---|---|---|---|
| Amazon | Main Product | 2000×2000 | 1:1 |
| Amazon | Swatch | 1000×1000 | 1:1 |
| Amazon | A+ Hero | 1464×600 | 122:50 |
| Amazon | A+ 3-Module | 300×300 | 1:1 |
| Amazon | A+ Feature | 300×400 | 3:4 |
| Amazon | Storefront Hero | 3000×600 | 5:1 |
| Amazon | Brand Story | 1080×1080 | 1:1 |
| Shopify | Product | 2048×2048 | 1:1 |
| Shopify | Slideshow Hero | 1200×400 | 3:1 |
| Shopify | Blog Featured | 1200×630 | 1.91:1 |
| Shopify | Logo | 512×512 | 1:1 |
| Etsy | Listing Primary | 2000×2000 | 1:1 |
| Etsy | Shop Banner | 1600×213 | 1600:213 |
| Etsy | Shop Icon | 500×500 | 1:1 |
| Etsy | Ad Campaign | 1200×1200 | 1:1 |
A Official Guidelines button links straight to each platform's own image-spec page.
Custom Formats
Any format not listed above — set Platform Mode to Custom, then:
- 1Enter a Name, Width, Height, Safe Margin %, and Headroom %.
- 2Click Save — it's added to the dropdown above and drawn as a distinct violet overlay.
- 3Select any saved format from the dropdown to switch to it instantly; Delete Selected removes it.
Advanced Margins
By default, Safe Margin % applies to both top and bottom, and Headroom % to both left and right. Toggle Advanced Margins to set all four edges independently instead — useful when a platform's real UI isn't symmetric (a bottom navigation bar taller than the top status bar, for example). Whatever you're editing updates the viewport overlay immediately, whether or not the format has been saved yet; Save just persists the current live values under a name.
The same Export / Import pattern as Guide Presets applies here — one .json file holds every custom format you've saved, shareable or backed up the same way, and also reachable from Add-on Preferences.
Custom formats are stored per-user, the same way presets are, so they persist across projects.
Reference Layout
Drop in a screenshot of the real app UI you're targeting — Instagram's post composer, a client's storefront, whatever the shot needs to sit inside — as a reference overlay on the camera itself, so you can compose against exactly how it'll look once it lands there. This is Blender's own camera background-image system; ProFrame just surfaces Scale, Rotation, Offset, and Opacity directly in the panel instead of Object Data Properties.
Remove clears both the image and Blender's background-image toggle in one click, so it won't linger visibly in the viewport after you're done with it.
Render Settings
Common render setup in one place, applied directly to the scene: Focal Length presets (24/35/50/85/135mm), Resolution presets (from HD up through 8K, plus vertical/square/Amazon/Shopify presets), Frame Rate, and output Format (PNG, JPEG, WebP, EXR, TIFF).
Scale References
Drop a correctly-proportioned silhouette into the scene so viewers get an instant sense of real-world scale next to your product:
| Reference | Real-world size |
|---|---|
| Human | 1.75 m |
| Hand | 18 cm |
| Coin | 25 mm |
Clear Refs removes every scale reference at once.
Export Guidelines
Exports exactly what's visible in camera view — guide overlays and all — as a standalone image, without needing a full scene render. Set an Output Path, choose Format (PNG/JPEG/WebP) and whether resolution should Match Render Settings or use a Custom width/height, then click Export.
Compositor
A light post-processing pipeline built from Blender's own compositor nodes — automatically wired up behind the scenes when you click any of the buttons below. Requires Use Nodes enabled in a Compositing workspace (ProFrame will prompt you if it isn't).
Quick Filters & Custom LUT
30 built-in color-grade presets, grouped below by character. Pick one from the dropdown and click Apply Filter.
| Filter | Character |
|---|---|
| Warm | Brighter, warmer highlights and shadows |
| Cool | Blue-leaning shadows and highlights |
| Fade | Lifted blacks, reduced contrast — washed look |
| Matte | Crushed contrast, slightly desaturated |
| Vibrant | Punched-up brightness, contrast and saturation |
| B&W | Fully desaturated |
| Teal & Orange | Cyan shadows, warm-orange highlights — cinematic grade |
| Bleach Bypass | Heavy desaturation, high contrast — skip-bleach film look |
| Vintage Film | Faded contrast, warm sepia-leaning tone |
| Cinematic | Cool shadows, warm highlights, mild desaturation |
| Cross Process | Green shadows, yellow highlights, high contrast |
| Golden Hour | Warm golden cast, soft contrast lift |
| Day for Night | Blue-tinted, darkened, desaturated — day-for-night film technique |
| Cyberpunk | Magenta shadows, cyan highlights, high saturation |
| Sepia | Classic warm brown monochrome tint |
| Noir | High-contrast black & white, deep blacks |
| Pastel | Soft, light, low contrast, desaturated |
| Polaroid | Faded, warm-yellow cast, lifted blacks |
| Kodachrome | Punchy saturated reds/yellows, classic film look |
| Arctic | Strong cool-blue cast, clean highlights |
| Desert | Warm sandy tones, orange/yellow cast |
| Moody Blue | Dark, blue-shadow heavy, desaturated |
| High Key | Bright, low contrast, lifted shadows — airy |
| Low Key | Dark, high contrast, crushed shadows — dramatic |
| Autumn | Warm orange/red cast, boosted saturation |
| Forest | Green-tinted shadows, natural earthy highlights |
| Rose Gold | Pink-warm highlights, soft glow |
| Steel | Cool grey-blue, desaturated, industrial |
| Sunset | Warm orange highlights, magenta-leaning shadows |
| Dreamy | Very low contrast, lifted blacks, soft glow |
Filters and a Custom LUT (a .cube file, with adjustable strength) are mutually exclusive — applying one clears the other. Guide Overlay bakes your current guides into the compositor as a static image layer, useful for a final render that includes them.
Watermark
Two modes, switchable at any time:
- Image — load a PNG/logo file.
- Text — type a string directly (e.g.
© Your Studio); rendered with your chosen font size and colour, no external image needed.
Both share Position (9-point grid: corners, edges, centre), Scale, and Opacity — all of which update live as you drag them, no need to re-click Add. Position is calculated from the watermark's actual rendered size, so it always stays fully inside the frame regardless of text length or scale.
The small ↩ button next to Add / Remove resets position, scale, opacity, font size and colour back to defaults — without touching your chosen type or content.
Flash-Hide Hotkey
Hold \ anywhere in the 3D Viewport to instantly hide every guide overlay — release to bring them back exactly as they were. Useful for checking the clean shot without losing your setup.
To use a different key: go to Edit › Preferences › Add-ons › ProFrame, click the key field under Flash Hide Guides Hotkey, then press whatever key (with any modifiers) you'd rather use.
Frequently Asked Questions
Nothing is drawing in my viewport — why?
Three things ProFrame needs: a Camera object in the scene, the viewport set to Camera view (Numpad 0), and the ProFrame ON toggle at the top of the panel switched on. Also check that the specific guide you expect is actually enabled under Guides.
My 2-point/3-point perspective lines run off the edge of the viewport — is that a bug?
No — that's correct. Real vanishing points genuinely sit outside the visible frame; that's the whole reason they're called "vanishing." You can pull them closer with the VP Spread slider if you want a tighter view.
Where are my presets and custom platform formats stored?
In your Blender user config folder, not inside the .blend file — so they follow you between projects. That also means they don't travel with the file if you send it to someone else; they'd need ProFrame installed with their own presets.
The Compositor section says "Open Compositing workspace first" — what do I do?
Switch to the Compositing workspace tab at the top of Blender, enable Use Nodes, then come back and click the button again (or use Enable Compositor Nodes directly in the panel).
Can I use ProFrame's guides without a camera, just in the regular viewport?
Not currently — every guide is drawn relative to the active camera's frame, so you'll need to be in Camera view. The one exception is the Custom Grid's "Free 2D" mode, which covers the full viewport regardless of camera.
Does exporting guidelines require Pillow (PIL) installed?
No. ProFrame checks for Pillow and uses it if present, but falls back to a built-in numpy-based renderer automatically — the output is visually identical either way.