What's new
- v1.5.20 (2026-10-18) — The introduction page shows the Venue Builder icon next to its name. Nothing in the app changed.
- v1.5.19 (2026-10-18) — The introduction page shows the MuffStuff wordmark at the top. Nothing in the app changed.
- v1.5.18 (2026-10-17) — A redesigned introduction page (vb.muffstuff.net/appinfo.html). Nothing in the app changed.
- v1.5.17 (2026-10-11) — Cloudflare Web Analytics can now count visits to the app and the manual (its script was being blocked).
- v1.5.16 (2026-10-06) — With no internet connection, Satellite and the links that open websites are hidden; they come back when you reconnect. On an iPad, opening an ArrayCalc project (.dbpr) now works offline straight after an update.
- v1.5.15 (2026-10-04) — Arena: tick Asymmetrical venue on the Section step to give any side (Left, Right, Far end, Stage end) or corner its own section, e.g. a side with no upper bowl. Where sections differ, the deeper one wraps the corner and stops square at an end wall; the piece you are editing shows in gold in the 3D room. A new default arena (lower bowl, concourse, overhanging upper bowl); retractable seating now starts 20 ft deep. Voms: hover a vom's row to see it in gold, and pick its side on a compass that previews where it lands; a new vom's tunnel stops at the concourse. A bigger axis gizmo and pop-out buttons.
- v1.5.14 (2026-09-28) — Satellite: drag the venue to move it, drag the ground to move the map. Works on a Mac trackpad, where right-drag doesn't. A knob past the venue's far edge rotates it with the mouse (Shift for 15° steps). Computers with a touchscreen now get the full desktop layout (the tablet layout is for iPads and Android tablets). Dragging an Advanced corner a long way no longer sends the plan zooming out.
- v1.5.12 (2026-09-27) — Phones no longer get an install prompt for an app they cannot run.
- v1.5.11 (2026-09-27) — Status bar reordered: MuffStuff on the left, coffee on the right; shorter messages.
- v1.5.10 (2026-09-27) — The 3D room is lit and shaded with depth, and its axes moved to a corner gizmo; a status bar along the bottom carries messages, the room's numbers (size, audience area, farthest and highest seat) and this version; Copy link on the Export step; icons; the header controls line up; view text is a size larger on an iPad.
- v1.5.5 – v1.5.9 (2026-09-26) — iPad: Venue Builder installs from Safari's Add to Home Screen, keeps its own copy for use without a signal, and offers an Update ready button when a new version is out; a landscape-only notice; the header clear of iPadOS 27's top blur; a Home Screen icon.
- v1.5.4 (2026-09-25) — Arena retractable seating: click a side or corner on the plan (or in 3D) to push it back or roll it out; pushing back the seats behind the stage lets the stage move back. The Footprint type folded into Flat field → Advanced.
- v1.5 – v1.5.3 (2026-09-25) — Display 2 report import (experimental); stage house walls; walls regrouped; an iPad layout with Share; phones told to use a bigger screen.
- v1.4 (2026-09-24) — Opens SketchUp, DXF, ArrayCalc and Soundvision venues; light mode.
- v1.3 — ArrayCalc and Soundvision exports.
What it does
Venue Builder builds a 3D venue from a handful of real measurements and exports it for prediction software: SketchUp (.skp) for Display 3, DXF for any CAD or predictor, ArrayCalc venue (.dbacv) and Soundvision 3D room data (.txt). Every surface is sorted into a coverage layer: Audience, Non-audience, Stage, Keep clear and Wall. You never draw in CAD. You describe the room the way you would measure it standing in it: a cross-section of laser shots, a few widths, and where the stage sits.
It also opens venue files made elsewhere — SketchUp, DXF, ArrayCalc venues and projects, Soundvision room data — so you can check their scale in 3D and export them in any of the other formats. See Opening other venue files.
Everything is live. Change a number and the section, the 3D room and the plan redraw immediately. Ctrl+Z undoes any change.
Video tutorial: Watch the walkthrough on YouTube — measuring a room, building it and exporting, start to finish.
The six steps
The pills across the top are the workflow. A pill lights up when its step is available; you can jump back to any earlier step at any time.
- Start. Three cards: draw your own section on the Section view, start from a demo venue and edit its numbers, or Convert a file made in another program (view and export only). Below them, Open a saved Venue Builder project brings a
.venuefile back editable, and Resume where you left off appears when this browser holds a draft of your last venue: the tool keeps one automatically as you work, so a closed tab does not lose the afternoon. A draft is not a file — Save when it matters. Starting a new one replaces what is on screen (Ctrl+Z brings it back). - Venue type. How the section becomes a room, and where you stand to measure it: Flat field, Theater, Amphitheater or Arena. You can change type later without losing your section.
- Section. The measured cross-section, one row per vertex. This is the heart of the model; see Measuring a section.
- Venue. The few numbers the chosen type needs (widths, fan angle, floor size) plus that type's extras: side balconies for a theater, voms, retractable seating and a scoreboard for an arena, the outline editor for a footprint.
- Stage & walls. Stage size and position, the room's walls, and the stage house (back wall and side walls) that trims seating behind the stage.
- Export. Save the project, then export for Display 3, CAD, ArrayCalc or Soundvision.
Measuring a section
Stand where the type tells you: the Section view says so in its header, and the Draw banner spells it out before your first click (the stage edge, the downstage edge, or the edge of the arena floor). The plan marks the spot with a figure facing down the throw. Shoot the points that define the room's profile straight down the throw: the front of the first seats, each change of rake, the top of a riser, the front lip of a balcony, the back wall. Each shot is one row.
- Survey mode takes what the laser gives you: distance and inclination angle, about your instrument height. YZ mode takes distance downrange and height instead. Switching converts the numbers so the venue does not move.
- The first vertex is pinned to the floor datum: heights are relative to the floor where the seating starts, so instrument height only matters for the geometry between shots.
- Surface column: each row's surface is the one arriving at that vertex. Auto reads the rake: gentle rises are Audience, risers, soffits and walls are Non-audience. Override any segment to Audience, Non-audience or Keep clear, for instance a rear lawn you want the predictor to treat as a no-spill zone.
- Balconies are drawn as a fold-back: after the rear wall rises, a vertex comes back toward the stage (the soffit), then a short lip rises, then the balcony rake continues. The Theater demo shows one.
- From Display 2… (experimental) fills the section from a Martin Display 2 rigging report PDF — always check the result against the PDF. The report's venue slice is a picture, so Venue Builder reads it the way you would: it calibrates the axes from the tick labels, finds every vertex marker, and follows the dotted lines between them — grey floor, red structure (Non-audience), blue (Keep clear). The stage depth and height come with it; the front edge of the stage becomes Y = 0. Display draws a structure box — back wall, roof, upstage wall — on every slice, outdoors too, so the import stops at the end of the seating (balconies included) and leaves walls to the Stage & walls step. For an Arena the level run in front of the stage is taken as the arena floor (it sets Floor length) and the section starts at the first riser. Accuracy is about half a foot, set by the picture. The numbers are read in the unit of the Units switch; if they look wrong for that unit (a 1 ft stage, a 5 m stage) it asks whether Display was set to the other one. Use the mains report: a delay array's report paints the ground in front of the delay red (the mains cover it), which would come in as Non-audience. Widths are not in a slice — set them on the Venue step. Only the printed report is read; Display project files are never opened.
- Redraw (a section you drew yourself) replaces it with one you click on screen. Restore section (a demo, or a Display 2 report) puts the vertices back the way they came and leaves widths, stage and walls alone; the Venue step's Restore defaults resets everything for the type. Ctrl+Z undoes either. The drawing frame starts 250 ft deep and 50 ft tall, grows by 50 ft and 10 ft as you approach its edges, and the wheel resizes it. Place vertex inserts one vertex where you click without disturbing the others. You can also drag any numbered vertex on the Section view.
- The yellow figure is you. Drag it to re-measure the same room from another spot; the shots update, the room stays where it is.
Venue types
- Flat field. Level ground across a front and back width. For uneven ground, use Advanced and add spot heights.
- Theater. Straight across a front and back width; balconies come from the section; optional room walls and side balconies.
- Amphitheater. The section swept around the downstage edge by a fan angle. The rear span field shows the corner-to-corner width of the fan and sets the angle when you type it.
- Arena. A bowl lofted all the way around a rounded floor. You stand at the floor edge; floor size and stage come from the measurements. Tick In the round to sell all the way around with no rear wall.
- An odd-shaped room or site (asymmetric, a stage in a corner, an L-shaped floor): start from Flat field and press Advanced on the Venue step to draw its outline. Projects saved with the older Footprint type still open.
Theater extras
Side balconies (Venue step) run each balcony in your section along both side walls toward the stage. The tool finds the balconies itself from the fold-backs and tells you what it found. You set how far toward the stage they reach, their width from the wall, and an optional rake that pitches them down toward the stage, hinged at the balcony.
Room (Stage & walls step): walls around the house — the back of the house, or the back plus both sides — with a height. Side walls can rise level with the back wall's top or follow the rake, and they duck under a balcony.
Arena extras
Vomitoria (Venue step): tunnel mouths cut into the bowl at floor level. Each vom has a side (the four straight sides, or the four rounded corners at 45°), an offset along that side, a width and a height. The open mouth runs from the floor edge up the bowl to where the rake reaches the vom's height; behind it the tunnel continues under the seats for the length you give, which defaults to the bowl depth. Drag a vom on the plan to slide it along its side.
Retractable seating (Venue step): shoot the section with the retractable seats rolled out, the usual show layout, so the lower part of the bowl you measured is the retractable seating. Tick Retractable seating and set Retractable depth, how far the retractable rows reach from the floor edge to the fixed seats. The plan then shows eight pieces: left side, right side, far end, behind the stage, and the four corners, each teal when out (exactly as measured) and amber when pushed back. Click a piece on the plan, or its lower seats in the 3D view, to switch it. A pushed-back piece loses those lower rows: the floor runs flat out to the stacked units, a Non-audience block against the fixed seats. Two pushed-back neighbours join; where one meets a piece that is out, the cut is closed with your section's shape. Behind the stage and its two corners start pushed back, since they usually go first, and while they are back the stage may move back to the stack (a stage still in its default spot moves with them).
Scoreboard: a box floating over the centre of the floor, with width, depth, height and clearance above the floor. It exports as Non-audience.
Smoothness is the number of faces around each rounded corner, in steps that each change the bowl.
Advanced (outlines)
Flat field and Amphitheater have an Advanced button on the Venue step. It turns the venue into a footprint whose outline you can pull around, keeping your section, stage and the exact heights the simple type produced. Use it for an asymmetric lawn or an odd field edge. Back to … (simple setup) returns to the numeric version.
The Venue step then has two sub-steps, so the plan only ever does one thing at a time:
- 1 · Shape. The outline: corners in a table, or drawn on the plan; drag any corner. Working on picks the main floor or a level. Levels (amphitheater and footprint) are extra outlines at a height, flat, with an underside — a gallery or terrace.
- 2 · Heights (field and amphitheater): the floor already follows your section; add spot heights only where the ground is higher or lower than that. Click Place on plan, then click the spots on the plan (until then the plan drags and zooms as usual); the ground passes through every spot and blends between them, so three or four per feature give a natural surface.
- Room wall height for a footprint lives on the Stage & walls step.
Stage & walls
The stage is a box: one row for its size (width × depth × height, the way staging is written) and one for its offsets (left/right, front/back) from where you stood. In an arena it can sit anywhere on the flat floor. Seating in front of the stage line stays Audience; floor behind the line becomes Non-audience and the footprint under the stage is Stage.
The stage house: Back wall cuts away seating behind the stage and adds a wall of the given height and width, offset from the stage's back edge. Its width starts as, and follows, the stage width; type a different width and it stays yours. Side walls (needs the back wall) adds a wall each side of the stage at the stage's own width, from the back wall to the stage front, same height. Both are off in the round.
Views, plan & satellite
Look (top right, beside Units and Colors): System follows your computer's light or dark setting; Dark and Light force one. The views, legend and this manual follow. (The manual has no scripts, so it follows the system setting only.)
The 3D room always carries a scale bar (bottom left) and the venue's overall across × deep × high (bottom right), in your units. The legend uses Venue Builder's own names while you build; on the Export step it switches to the words your chosen format will use — Display 3 / DXF layer names, ArrayCalc listening · structure · transparent, or Soundvision group names. Hover a swatch for the mapping.
- Section: what you measured, side on, with axes in your units.
- 3D room: drag to orbit, wheel to zoom, double-click to reset; Iso, Top, Front and Side presets. Walls you would be looking through are drawn as outlines so you always see into the room. From below, everything dims.
- ⤢ on either view header expands it to the whole work surface; the expanded view follows the step pills. Escape restores.
- Plan and 3D (view bar): Plan appears whenever there is something to show top-down — an outline, voms, or satellite imagery — and switches the plan panel on or off; while it is on, 3D switches the 3D room off or on, so you can have the plan alone. Escape brings everything back.
- Satellite (Flat field and Amphitheater, including Advanced — from above, a theater or arena is just a roof; it needs an internet connection and is hidden without one): tick it, enter a location (coordinates, a full Google Maps link, or a place name), press Load. Aerial tiles appear at true scale with your venue over them. Drag the venue to move it on the ground; drag the ground around it to move the map (right-drag, or Ctrl / Option / ⌘ + drag, moves the map from anywhere); wheel zooms. To turn the venue, drag the round knob at the end of the dashed line past its far edge (hold Shift for 15° steps), or type the heading into Rotate, in degrees clockwise from north. The imagery is a reference for fit, not survey data.
- Draw mode on the plan. While clicks on the plan place outline corners or spot heights, a dashed frame runs round the plan and a label at the top says so; double-click finishes and the plan drags normally again.
Export
Save the project first (.venue, a small text file you can reopen later). Then pick a Format; the choice is remembered.
Copy link puts the whole venue into a web address — nothing is uploaded, the venue is the link. Paste it to a colleague and it opens in their Venue Builder (on an iPad the link goes to the Share panel). An imported file cannot go in a link: save it instead.
The status bar along the bottom shows the room's numbers all the time: overall size, audience area, and the farthest and highest audience points measured from the front centre of the stage deck.
- Display 3 · SketchUp (.skp): real-world size, already turned to Display 3's orientation (loudspeakers point down your throw without rotating the import), every surface its own face on a layer named for its coverage:
AUDIENCE,AVOID,STAGE,HARD_AVOID,WALL. In Display 3, import, then Cover → Coverage Tool → Auto-Assign. Audience, Avoid and Stage map by name; if a layer is not picked up, drag it onto its coverage type in the same dialog. Flat floors are split into cells with tiny height offsets so Display's "Clean faces on import" cannot weld them into one face. - DXF (.dxf): the same surfaces and layers as 3DFACE entities (the surface type every CAD program and predictor reads), in the units you work in (the Units switch: feet or metres, written into the file's unit header). A surface with more than four corners is split into triangles with the split edges hidden.
- ArrayCalc · venue (.dbacv): d&b's venue file exactly as ArrayCalc 12 writes it, in metres. Audience surfaces become listening planes, the stage becomes a structure, and everything else (non-audience, keep clear, walls) becomes a transparent obstacle. ArrayCalc's four-sided plane is a parallelogram, so any other four-sided surface is split into two triangles. In ArrayCalc: Venue → Import venue → Replace current venue (or Add venue elements). Opening the file from Home → Open instead loads it as a whole project, and ArrayCalc then notes that air absorption was off in the file and switches it on; it says the same about its own venue files, and the venue is unaffected. Verified by round trip through ArrayCalc 12.8.3: what it saves back is what Venue Builder sent.
- Soundvision · 3D room data (.txt): L-Acoustics' text import (the format its SketchUp and Vectorworks plug-ins write), in metres, one labelled surface per block. Labels carry the layer names (Audience, Stage, Avoid, KeepClear, Wall) and become groups in Soundvision. Import it from the 3D ROOM DATA panel (Import 3D room data), then set the audience listening level, which the format cannot carry. Verified by import into Soundvision 2026.3.
Opening other venue files
Start → Convert a file opens a SketchUp .skp, a DXF, an ArrayCalc venue .dbacv or project .dbpr, or a Soundvision .txt — a venue built somewhere else, or one you exported earlier. Pick the file and you land on the Export step with the 3D room filling the view. (A .venue project picked here simply opens as a project.)
An opened file is view and export only: a banner says so, and the Venue type, Section, Venue and Stage & walls steps stay locked, because a finished mesh has no rows or measurements to edit. What you can do:
- Check the scale. The 3D room fills the right side. Its scale bar (bottom left) and the extents readout (bottom right) are in your units, and the banner adds the surface count per coverage layer with the names they had in the file. Legend colours that the file does not use are greyed.
- Export it in another format. Pick a Format and Export as usual — Display 3 ↔ ArrayCalc ↔ Soundvision ↔ DXF in one step. Layers are mapped by name: listening/Audience/seating → Audience, stage or structure → Stage, wall/roof → Wall, anything with "hard" or "keep clear" → Keep clear, transparent, floor and everything else → Non-audience. The banner lists the source names behind each layer so you can see what was assumed.
- Start over. Draw or Demo on the Start step begins a venue of your own and drops the import.
What comes through: flat surfaces (SketchUp faces in groups and components, DXF 3DFACE, closed polylines, polyface meshes and circles, including everything inside block references, ArrayCalc planes, boxes and circular segments from venue or project files, Soundvision polygons). DXF sizes follow the file's unit header; a file without one is read in whichever unit makes it a plausible venue size, and the banner says so — check the extents. Lines, arcs and hidden geometry are not surfaces and are listed in the banner as not carried over. The Save button is off for an import — save the exported file instead. Opening an ArrayCalc .dbpr project loads a small database engine (about 0.7 MB) the first time, so it takes a moment longer.
On an iPad
Open the same address in Safari. Venue Builder sees the touch screen and switches to finger-sized controls; the tool itself is the same. Hold the iPad sideways: the layout is landscape only, and upright it asks you to turn it (a web page cannot lock rotation — Rotation Lock in Control Center keeps it there).
- One view at a time, full size: the section on the Section step; on the Venue step the plan when there is one to edit (an outline, satellite imagery, voms), otherwise 3D; 3D on Stage & walls and Export. The View switch at the right of the step bar shows another view until you change step.
- Tap where the desktop says click. Drag a vertex, a corner or the avatar with one finger.
- Pinch zooms (the 3D room, the plan, and the drawing frame while you draw a section). Two fingers move the plan, or the map under satellite imagery.
- Done drawing appears while you draw a section or place outline corners or spot heights; a double-tap also finishes. Undo and Redo sit at the top right.
- Tap a field's name to read what it means; tap the status line when it has an ⓘ for the detail. Number fields bring up the number keys.
- Files open from the Files app. Share (the Export button on an iPad) and Save project open the iPad's Share panel: AirDrop to a Mac, Mail, Messages, Google Drive and other apps, or Save to Files. If a file type cannot be shared it is saved to Files → Downloads instead.
- Add to Home Screen (Safari's Share button) makes Venue Builder an app on the iPad. It keeps its own copy, so it opens with no signal and uses almost no data: each launch only asks whether there is a new version. Satellite needs a connection, so it is hidden while you have none.
- When a new version has downloaded, Update ready appears at the top. Tap it to switch; your venue comes back with Resume where you left off.
Phones are not supported: on a phone the page says so and links to muffstuff.net.
Shortcuts
- Ctrl+Z undo (one vertex at a time while drawing, one step otherwise) · Ctrl+Y or Ctrl+Shift+Z redo
- Ctrl+S save project · Ctrl+O open a project or venue file · Ctrl+E export in the chosen format
- Esc restore the two-panel layout
- Double-click finishes a drawing; on the 3D room it resets the view; on the plan it resets pan and zoom
Units (ft / m), Appearance and the colour-vision palette are in the header and apply everywhere, including the legend and the exported DXF's units. Leaving the page with unsaved work asks first.
Glossary
- Rake
- The slope of a seating surface, rising away from the stage.
- Riser
- A vertical step in the section, drawn as two vertices at the same distance.
- Fold-back / soffit
- A section segment that comes back toward the stage at height: the underside of a balcony. This is how the tool recognises a balcony.
- Downstage / upstage
- Toward the audience / away from it.
- Throw
- The direction from the stage into the house; distances "downrange" are along it.
- Retractable seating
- Telescopic seat units that roll out onto the floor or push back into a stack against the fixed seats.
- Vomitorium (vom)
- A tunnel entrance through the seating at floor level.
- Keep clear
- The strictest non-audience class: surfaces where sound is unwanted, not merely uncovered. The stage is one by default. Exported as the
HARD_AVOIDlayer so predictors that know that class pick it up. - Listening plane · Structure · Obstacle
- ArrayCalc's three plane types. Audience surfaces export as listening planes, the stage as a structure, everything else as transparent obstacles; the same words appear in the legend when ArrayCalc is the chosen format.
- Group (Soundvision)
- Soundvision collects imported surfaces by their label into groups: Audience, Stage, Avoid, KeepClear, Wall.
- Scale bar
- The bar under the 3D room: a known length in your units, exact anywhere on screen because the view has no perspective.