For Muckup beta 0.9.11 on macOS 14 Sonoma or later. Something missing? Click Feedback at the bottom right of the app, or write to [email protected].
Install
Get the beta at muckup.app/beta: confirm your email at Polar and the .dmg downloads. Open it and drag Muckup to Applications. The app is signed and notarized by Apple. On first launch, a short guided tour shows the essentials; Help › Replay the Tour shows it again. Muckup follows your Mac's language (English or French).
A project is a folder
File › New Project… asks for the client and project names, which also name your exports, and creates a folder with three sub-folders: Mockups for your scene photos, Designs for your flat artwork, Exports for the results. Open Project… opens any existing folder; Switch Project… and the left panel list recent projects.
Add files by dropping them on the window, with Add Mockups… and Add Designs…, or by pasting with ⌘V (a copy from Illustrator, Photoshop or Finder works). Photos go to Mockups, artwork to Designs. Photos can be JPG, PNG or HEIC; designs PNG, PDF, SVG or JPEG. Mockup PSD files can be imported when they hold a readable RGB photo layer.
Muckup watches the folders. Add, change or remove a file in Finder and the project follows. Save a new version of a design from your usual app and every scene using it refreshes.
Map a mockup
- Double-click a photo on the board to open it. Surface detection proposes layers; Detect Surfaces Again reruns it, New layer (⇧⌘N) adds one by hand.
- Drag the four corners of a layer onto the surface. The handles in the middle of the edges stretch one side and keep the perspective; with ⌥, both opposite sides. ⌘ + drag slides the layer on the surface. Snap edges to the photo fits the edges to the real borders.
- Pick a format from the Format menu (business card, A4, poster, 16:9…) or create your own with New format…, in millimetres.
- Choose a shape in the Surface tab: Flat, Curved, Fabric or Cylinder.
The mapping is saved inside the photo itself. Copy the photo into another project and it arrives ready. Right-click a photo › Add to Favorites to keep it in Favorite Mockups, available in every project.
Place a design
Drag a design from the Designs column onto a layer, or paste it with ⌘V while the layer is selected. Rotate 90° turns it. Give the layer a Tag (card front, poster…) and every layer of the project with the same tag receives the same design.
To swap a file everywhere, right-click it on the board › Replace…: the new file takes its place in every mockup, with the same position, finishes and settings, and the old one goes to the Trash. Moving designs to the Trash with ⌫ always asks first and says how many mockups use them.
Layers
A mockup can hold several layers: front and back of a card, a stack, a poster and a flyer. Drag the layer cards to reorder them, ⌘D duplicates one. Right-click a layer to Bring to Front, Bring Forward, Send Backward or Send to Back, hide it, or delete it (⌫).
The selected layer's settings sit in four tabs: Surface (shape, format, corner radius, thickness, existing print), Print (opacity, the photo's light, focus and grain, inner shadow, glass reflection), Finishes and Mask. A pink dot marks a tab with an active setting.
Shapes
- Curved: the edges follow a bent surface, such as curling paper or a sleeve, and snap to the photo.
- Fabric: raise Folds and the design follows the folds read in the photo (t-shirts, totes).
- Cylinder: set Curvature, then match Top view and Bottom view to the camera angle. ⌘ + drag, or Rotation, turns the design around the object.
Light and masks
In the Print tab, Tone has three handles: how much the hollows darken and the highlights lift the design. Ink lets the light brighten dark inks. In the Surface tab, Remove existing print cleans text or a logo already printed on the photo's surface.
The Mask tab hides the design where something passes in front of it: a pen, a finger, a coffee cup. Its tools: Brush, Eraser, Rectangle (⌥ on release to subtract) and Pen, whose paths stay editable. [ and ] change the brush size, ⇧[ and ⇧] its hardness. As in Photoshop, ⌃⌥ + drag on the photo sets both: left and right for size, up and down for hardness. Feather softens the mask's edge.
A layer's mask hides only that layer. For a hand or an object in front of every layer, use Foreground above the layer list: Detect subject finds it for you, or paint it.
Finishes
Click the sparkles at the right of a layer to add a finish; hold to choose the type, ⌥-click to remove the last one. Or hold ⌥ while dropping an image on a layer: it becomes its finish, and its white areas get the finish. Types: Gold, Silver, Copper (flat or raised), Spot varnish (flat or raised), Emboss, Deboss. Sheen adds a ripple to metals. The eye on the thumbnail hides the print and keeps only the finishes, for blind embossing or varnish alone.
Drag the light to move the reflections, or click Match the Photo. Same Light Everywhere copies the light to every mockup of the project.
Effects
Thickness, in the Surface tab, draws two edge lines in colours you choose, for cards and boards. In the Print tab, Inner shadow suits bus shelters and light boxes, and Glass reflection mirrors a street or your own image on the poster, with position and blur.
Cast shadow
Like a gobo in front of a studio light: a window, blind or foliage shadow falls across the whole scene, layers and foreground included. Click + on the Cast Shadow card, under Foreground, and pick one of nine gobos (four- and six-pane windows, arch, blinds, palm, monstera, branch, dappled leaves, and the mckp logo) or Import Gobo…: in your own image, light areas let the light through. Drag on the photo to move the shadow, then set opacity, blur, warmth, scale and rotation. Same Shadow Everywhere copies it to every mockup of the project; the eye hides it.
Export
⌘E exports every mockup of the project to Exports, named after the client and project. The arrow next to the button sets the format (WebP, JPEG, PNG, HEIC), the quality and the size of the longest side. Press C in a mockup to draw its export frame; Remove Crop goes back to the full photo. File › Export Presentation PDF… (⇧⌘E) makes a 16:9 PDF of the whole project for the client: each page shows the exported mockup, frame included, never cropped. Older versions of an export move to Exports/_archives.
To get a single mockup out: ⌥⌘E, or Export This Mockup in its thumbnail menu, exports just that one. ⌘C copies the render of the open or hovered mockup, and a thumbnail drags straight into Figma, Keynote or the Finder.
Focus and grain
In the Print tab, Blur softens a design that sits outside the photo's sharp zone. Blur by Points… places up to four points on the layer, each with its own strength: sharp in front, soft at the back, like a field blur. Grain gives the design the noise of a low-light or film photo.
Full view
@ (or ⌘\) hides the whole interface, as in Figma, and leaves only the visual. @ or Esc brings it back.
Shortcuts
| Keys | Action |
|---|---|
| ⌘V | Paste an image into the project, or onto the selected layer |
| ⌘E | Export all mockups |
| ⌥⌘E | Export this mockup only |
| ⇧⌘E | Export the presentation PDF |
| ⌘C | Copy the render of the open or hovered mockup |
| @ | Full view: hide or show the interface |
| ⇧⌘N | New layer |
| C | Frame the export of this mockup |
| ⌘ + drag | Slide a layer on its surface; on a cylinder, turn the design |
| ⌥ + edge handle | Stretch both opposite sides |
| ⌥ + drop | Use the image as a finish |
| ⇧ + slider | Ten times finer adjustment |
| [ ] | Brush and eraser size |
| ⇧[ ⇧] | Brush hardness |
| ⌃⌥ + drag | Brush size (left, right) and hardness (up, down) |
| Arrow keys | Nudge the selected layer; with ⇧, ten times more |
| Tab ⇧Tab | Next or previous layer |
| ← → | Previous or next mockup when no layer is selected; on the board, the neighbouring file |
| ⌘D | Duplicate the layer |
| ⌘A | Select every file on the board |
| ⌘0 ⌘+ ⌘− | Fit, zoom in, zoom out |
| Esc | Deselect the layer, then back to the board |
| ⌘, | Settings |
Updates
New versions are offered inside the app, with what changed. Muckup › Check for Updates… looks right away; Automatically check for updates in Settings turns the check off.
Privacy settings
Muckup asks once whether you want to help improve it. Settings › Privacy holds the two switches: Send crash reports and Share anonymous usage statistics. Your images and files never leave your Mac. Details in the privacy policy.
Feedback and problems
Feedback, at the bottom right or in the Help menu, prepares an email with your Muckup version, macOS version and Mac model. Say what you were doing and what you expected; a screenshot helps a lot. You see the email before you send it.
Requirements
A Mac with macOS 14 Sonoma or later, Apple silicon or Intel.