SurfaBeam Guide • Halloween • Tutorial

Singing Pumpkins: How to Set Up and Align Them Without Shuffling Pumpkins All Night

AC
Alex Copper Projection Mapping Editor & Specialist, Secundum Reality
Aug 8, 2026 — min read singing pumpkins • halloween • projection mapping • tutorial

Every singing pumpkins tutorial ends at the same sentence: put the projector five to seven feet back and move the pumpkins around until the faces line up. That is where the guide stops and where your evening starts. You spend an hour on your knees on a cold porch nudging a pumpkin two centimetres left, which pushes the next face off the one beside it. The fix is not more patience. It is to stop moving the pumpkins and start moving the image, and that takes four operations you can do from a phone while standing at the display.

Three pale pumpkins on a porch step with animated singing faces projected onto them, each face masked to its own pumpkin so no light spills onto the wall behind
The tell of a good singing pumpkins setup is the wall behind it. If the wall is dark and only the pumpkins glow, each pumpkin got its own surface rather than one big rectangle stretched across all three.

What Singing Pumpkins Actually Is

There is nothing inside the pumpkins. A projector sits in front of them and plays a looping video of animated faces on a pure black background. The projector supplies the light and the movement, the pumpkins supply the shape, and your brain does the rest.

The whole craft is getting each face onto its pumpkin and nowhere else. Land it correctly and the pumpkin looks lit from inside. Miss, and you get one of three failures: the face slides off onto the wall behind, the mouth smears flat across a curved surface, or the pumpkins glow inside a bright rectangle of spilled light that announces exactly where the projector is. All three are alignment problems, and all three are fixed in software.

The Step Every Tutorial Skips

The standard advice fixes the video in place and asks you to move the pumpkins to meet it. That is a three-body problem solved by hand in the dark. Slide the left pumpkin to catch its face and it now sits nearer the lens than the other two, so it is bigger, brighter and slightly soft. Push it back to match and the face is off again.

Turn it around. Put the pumpkins where they look good on the porch and leave them there. Then move the image:

  • Give each pumpkin its own surface. Add Surface once per pumpkin and drag its four corner dots onto that pumpkin. Anything outside a surface stays black, so the wall, the step and the gaps between pumpkins go dark on their own — the difference between a lit rectangle with pumpkins in it and three objects glowing in the dark. Three separate surfaces also let a pumpkin sit further back, lower, or turned off-axis and still receive a correctly shaped face.
  • Cut the surface to the silhouette. Four straight edges around a round object still leak light at the shoulders. Pick Custom Mask takes a black-and-white PNG of that pumpkin's outline and carves the surface to it in real time, with a Threshold slider to place the cut and an Invert toggle if it keeps the wrong side.
  • Warp the edges to the curve. A pumpkin is closer to a sphere than a billboard, and a flat quad stretched over it smears the mouth sideways at the edges. Toggle WARP and each straight edge becomes a Bezier curve you can bow outward until the mouth follows the surface and stays legible from the sidewalk.
  • Save the layout. Halloween is not one night of setup. If the surfaces, masks and warps come back from a file, night two is putting the projector on its floor marks and pressing load. Save and Load are Pro features.

Where the Face Video Comes From

Stated plainly, because it is the question people arrive with: SurfaBeam does not supply singing-face loops. It is the mapping tool, not a content library, and it ships with no faces. You get the video one of two ways: buy it from a producer that makes Halloween loops for exactly this, of which AtmosFX is the best known and not the only one, or make your own by filming someone singing against a black sheet or animating faces in After Effects.

A usable loop has four properties, and cheap ones fail at least one:

  • A genuinely black background. A projector cannot project black, it can only fail to add light, so black in the file means the pumpkin stays dark there. Nearly black, a dark navy or a grey vignette, throws a visible glowing box on your wall.
  • A seamless loop point. The last frame has to cut cleanly to the first, with no black frame and no audio hitch. A one-frame gap you barely notice on a phone preview reads as a blink at 40 cm wide, every 30 seconds, all evening.
  • Faces framed to fill. If a face occupies a third of its area in the source file, you are spending two thirds of your projector's brightness on empty black. Loops sold for this purpose are framed tight for that reason.
  • A matched aspect ratio. Deliver H.264 MP4 at the projector's native resolution and frame rate, usually 1920x1080. Letterboxed or square-cropped files waste panel area before you start warping.

You also choose between one three-up clip, where all three faces sing together in a single video, and three separate files. Three-up is easier, and SurfaBeam has a pair of controls built for exactly it: the lip sync is already correct, and Extended Mask Video tags one surface as the parent canvas holding the whole clip, while Child Video Mask on each of the other surfaces shows just its own slice of that same video. Set the parent first, then the children, and one clip runs continuously across all three pumpkins. Separate files give per-pumpkin control, useful when one pumpkin sits much further back, but keeping them in sync becomes your problem.

Making your own faces? Do the map first. Fit the surfaces and warps on the real pumpkins, use SurfaBeam Pro's Map Export to PNG to get the calibrated layout out as an image, then drop that into After Effects as a guide layer and animate faces that fit those exact shapes. Far quicker than animating blind and finding out on the porch that the mouth sits 4 cm too low.

How Many Pumpkins, and Why Three Is the Sweet Spot

Three, and for reasons rather than tradition. One projector throws one rectangle, and every pumpkin you add has to fit inside it. Three pumpkins at roughly 50 cm centre to centre put the outer two a metre apart, so with their own width the group spans about 1.4 m and you frame a rectangle about 1.5 m wide — comfortable to throw from a porch. Go to five at the same spacing and the group is nearer 2.4 m, so the projector moves back, the rectangle grows, and brightness per square metre falls with the square of the distance. The fourth and fifth pumpkin do not just add themselves, they dim the first three.

The outer pumpkins are the other constraint. A pumpkin near the edge of a wide frame is seen by the lens at a steep angle, so its face arrives foreshortened and the side turned away from the projector gets almost no light. On a curved porch step it also becomes impossible to keep them all at the same distance from the lens, which costs you focus. Three in a shallow arc, all within about 20 cm of the same throw distance, stays sharp and evenly lit without a fight. Most commercial loops are cut as three-up sets anyway, so you are not paying to crop content you cannot use.

Real Pumpkins vs Foam Pumpkins

Foam wins, and it is not close if you plan to run the display for more than a weekend.

  • The surface is lighter. Carvable craft-foam pumpkins come in pale orange and cream and take a coat of matte primer without complaint. A field pumpkin is a deep, saturated orange that eats most of the blue and green you throw at it.
  • They do not rot. A real pumpkin softens and slumps within one to two weeks, and a pumpkin that changes shape has quietly invalidated the map you saved. Foam looks the same on 31 October as it did on 1 October.
  • They are reusable. Same pumpkins next year, same positions, same saved layout.
  • They can be cut. Foam takes a craft knife cleanly, so you can hollow one and drop a dim warm LED puck inside for depth. Keep it dim: anything bright inside competes with the projector and washes out the face you spent an hour aligning.
  • The honest downside: foam is light and blows over. Weight each base with a brick or a couple of kilos of gravel, or the first gust rearranges the display and breaks your alignment.

Why a pale pumpkin projects better

Projection is additive. The projector adds light on top of whatever colour the surface already is, and the surface subtracts what it does not reflect. A deep orange pumpkin reflects red strongly and absorbs most of the blue and green, so a white tooth comes back dull grey-orange and the whites of the eyes never look like whites. Brightness will not fix it: you are adding more of a light the surface is throwing away.

A pale surface returns all three channels, so whites read white and colour arrives as the colour you chose. For real pumpkins, the white varieties sold as Casper, Lumina or Polar Bear work straight out of the patch. Otherwise a can of matte white primer on a foam pumpkin costs a few dollars and buys more apparent brightness than a projector upgrade. Matte, not gloss: a waxy finish sends a specular hotspot back along the projector axis, and it reads as a bright blob on the pumpkin's cheek from every angle except the one you were standing at.

Projector Placement: Distance, Brightness and Ambient Light

Start with the arithmetic rather than the folklore. Throw distance equals image width multiplied by the projector's throw ratio. Three pumpkins at 50 cm centres need a frame about 1.5 m wide, so a 1.5:1 lens sits about 2.25 m back and a 1.2:1 short-throw lens covering the same frame sits about 1.8 m back. The five-to-seven-feet advice you see everywhere is that same sum done once for one particular projector, which is why it works for some people and not others.

The trade-off runs both ways. Closer means a smaller rectangle and a brighter image, because the same lumens land on less area, but it puts the projector in the walkway where a trick-or-treater will kick it. Further back is easier to hide, but the rectangle grows and brightness per square metre drops fast: doubling the distance quarters it.

The good news is that pumpkins are a small target. Read every figure here as ANSI lumens, the standardised measurement, and treat the "LED lumens" or "light source lumens" on a cheap box with suspicion: those numbers routinely run about ten times the ANSI figure, so a projector advertised at 20,000 LED lumens may be delivering nearer 2,000 ANSI. A genuine 2,000 to 2,500 ANSI lumen projector is enough here, and that is not a contradiction of the 3,500 to 6,000+ ANSI we recommend for an outdoor evening house or stage display: that range has to light a whole facade of 15 square metres or more, while a 1.5 m frame around three pumpkins is roughly one square metre. Same lumens, a fraction of the area, so many times the brightness per square metre — which is why this works on hardware that would embarrass itself on a whole-house display. Lighting the facade too is a separate job with a separate projector in the 3,500 to 6,000+ ANSI class, covered in our guide to DIY holiday projection for Halloween and Christmas.

Three details people get wrong first time. Put the lens at pumpkin-face height, because projecting steeply down stretches the face down the front and drags the mouth below where a mouth belongs. Keep every pumpkin within about 20 cm of the same distance from the lens, since depth of field is shallower than you expect. And keep the projector out of the walking route, to one side and above head height: this is front projection, so anyone crossing the beam becomes a large black silhouette.

Ambient light beats lumens

The most common cause of a washed-out display is not an underpowered projector. It is the porch light, the security floodlight that trips when someone walks up, and the streetlight nobody controls. Ambient light lifts the black level, so the black background that was supposed to be invisible becomes a grey rectangle floating on your wall and the faces lose contrast at the same time.

Turn off the porch light. Disable the motion sensor on the floodlight for the evening, or the whole display flashes off every time a group arrives. For a streetlight you cannot switch off, use what you have: park the car to cast a shadow, put the pumpkins on the shrub-shielded side of the porch, or stand a sheet of black-painted cardboard between the light and the display. Half an hour of shading beats a thousand extra ANSI lumens.

Do the alignment pass from the porch

Masking and warping go faster when the controls are in your hand and you are standing at the pumpkins instead of walking back to a laptop between every nudge. The same mapping, masking and warping toolset runs on Android, iOS, macOS and Windows. Nothing syncs automatically, but Pro exports a project file you can reopen elsewhere — bring the media with it. If the display is going to run three hours a night unattended, make that machine a Mac or a PC from the start.

How to Make Singing Pumpkins: Step by Step

Budget 45 minutes for the first setup and five for every night after. Keep this order: warping before the projector is locked means doing the job twice.

Step 1: Set the pumpkins and mark their feet

Place the pumpkins where they will live for the whole season, roughly 50 cm centre to centre, all at the same distance from where the projector will stand. Draw round each base with chalk, or run a strip of painter's tape at the front and one side, so a pumpkin that gets knocked goes back in exactly the same place.

Turn each pumpkin so its flattest, widest face points at the projector; one side is always better than the others. Weight foam pumpkins now, before you align anything.

Step 2: Place and lock the projector

Set the projector at pumpkin-face height and back by image width times the throw ratio, so a 1.5:1 lens covering a 1.5 m wide frame sits about 2.25 m away. Lock the tripod, tighten every knob including the pan head, and set the output to the projector's native resolution, usually 1920x1080.

Turn off the projector's own keystone correction. It squares up a trapezoid by throwing pixels away, and you are about to do that job properly in software.

Step 3: Frame the whole group in a single output

Throw a plain white full-screen image and adjust distance and zoom until the lit rectangle covers all three pumpkins with about 5 cm of spare light past each outer pumpkin, which puts the frame near 1.5 m wide. Focus on the middle pumpkin, then check the outer two are still sharp; if one is soft, move that pumpkin forward or back rather than refocusing.

The spare margin matters: a pumpkin sitting hard against the edge of the frame leaves no room to warp, and the first edge you bow outward will clip.

Step 4: Add one surface per pumpkin and corner-pin it to the face

Tap Add Surface once for each pumpkin and drag that surface's four corner dots until the face sits square on its own pumpkin. Anything outside a surface stays black, so the wall, the step and the gaps between pumpkins go dark without any extra work, and each pumpkin reads as lit from within instead of sitting inside a glowing rectangle. Three separate surfaces are also what lets a pumpkin sitting further back, lower, or turned off-axis still receive a correctly shaped face without you touching the pumpkin.

Align the eyes first, then the mouth. A mouth 1 cm off looks like a design choice; eyes 1 cm off look broken. Bring the dots a few millimetres inside the pumpkin's outline rather than exactly onto it, because an edge sitting right on the silhouette throws a thin halo on the wall the moment anything shifts, and nothing shifts more reliably than an outdoor tripod overnight.

Step 5: Cut the surface to the silhouette with a custom mask

Step 4 gives you a four-cornered quad, and a pumpkin is round, so light still lands on the wall at the shoulders. For a tighter cut, tap Pick Custom Mask and hand SurfaBeam a black-and-white PNG silhouette of that pumpkin: the app reads the image's light and dark areas and carves the surface to that shape in real time. Slide Threshold until the cut sits on the pumpkin's outline, and hit Invert if the app has kept the background rather than the pumpkin.

Photograph the silhouette rather than inventing it. Shoot each lit pumpkin from where the projector stands, crank the contrast to pure black and white on your phone, and the mask matches the real object from the one viewpoint that matters. Include the stem in the white area only if you want the stem lit.

Step 6: Turn on WARP and bow the edges to the curve

Select a pumpkin's surface and tap WARP, which glows green; nothing moves yet, and that is expected. Double-tap the corner node at the end of the edge you want to bend and two orange tangent handles appear. Drag a handle until that edge bows out to hug the pumpkin's curve, then repeat at the other corners until the mouth follows the surface instead of smearing flat across it. Double-tap a node again to tidy its handles away.

Two kinds of dot, two jobs: the orange handles bend one edge, the corner dots reshape the whole surface, and with WARP on, dragging a corner stretches the surface like fabric. There is no interior grid to subdivide — the shape lives entirely in the four corners and their handles, which is why a pumpkin that shifts 5 mm costs you one drag rather than a rebuild.

Step 7: Check it from the sidewalk

Walk to where people will actually stand, about 5 to 8 m back and slightly off to one side, and judge the display from there rather than from behind the projector. Light spilling onto the wall, a face sitting 3 cm low, and a grey haze where the black background should be are all obvious from the street and nearly invisible from the tripod.

This is where running the map on a phone or tablet pays for itself: see the problem from the sidewalk and fix it without walking back.

Step 8: Save the layout and mark the tripod legs

Save the project in Pro so the surfaces, masks and warps come back exactly as you left them, and mark the tripod feet on the ground with tape or chalk so the projector returns to the same spot. Night two then takes five minutes: stand the projector on its marks, load the file, nudge a corner or a handle if a pumpkin moved.

Two honest notes here. Save and Load are Pro features, so on the free version this alignment does not survive closing the app. And the free version puts a watermark on the projected image as well as on exported video, which is fine while you learn the tool and not fine on a display the neighbours are photographing. Pro removes both, sold as monthly, quarterly, yearly and one-time lifetime plans on the App Store and Google Play, and as a one-time DLC on Steam rather than a subscription.

Weather, Damp and Running It Unattended

Late October evenings drop dew on the lens by about 10pm and make the cold start slow. Put the projector under an eave if you have one; if not, a clear plastic storage bin with a hole cut for the lens works, tilted a few degrees nose-down so water runs off the glass rather than pooling on it. Cut a vent, keep the intake and exhaust clear, and check the case temperature after the first hour. A sealed box will cook a projector faster than the weather kills it.

Power it from an outdoor-rated extension cord on a GFCI or RCD outlet, tape the cord flat anywhere people walk, and leave a drip loop so water runs off the cable before it reaches the connector. Run the display for the hours that matter, roughly 6:30pm to 9:30pm, rather than all night. Three hours a night for a week is a realistic duty cycle for a consumer projector standing outdoors, and it keeps you on speaking terms with the neighbours.

For those long unattended runs, the host device matters, and it needs deciding before you map rather than after. A phone is the right tool for the alignment pass and the wrong tool for three hours of continuous playback: it sleeps, it takes calls, it throttles when it warms up, and a notification banner across a singing pumpkin is a memorable failure. Run the show from macOS or Windows if you can, keep the machine indoors with an HDMI cable out to the projector, and disable sleep and screen savers before you walk away.

One caveat that decides the order of your evening: there is no cloud sync, so the simplest path is to build the map on the machine that will host the display. If you do want to move it, Pro exports a project file that reopens on another machine — but the project stores links to your clips, so carry the media across as well or the faces come back missing. A layout saved on a phone does not open on a desktop. The toolset is identical everywhere, and a handheld pass still earns its keep — it hands you the projector position, the content decisions and the tape marks on the ground — but the project file stays on the machine that made it, so make the surfaces, masks and warps you intend to keep on the host.

Sound needs one deliberate decision, and it is the one most people get wrong: do not use a Bluetooth speaker. Bluetooth adds roughly 100 to 300 ms of latency between the video and the audio, and on a lip-synced face that is the single most visible fault in the whole display — the mouth closes and the word arrives a beat later, and every person on the sidewalk sees it even if they cannot name it. Run a wired speaker instead: a powered speaker on a 3.5 mm cable or USB from the host device, or simply take the audio out of the projector itself, since the sound then arrives down the same HDMI cable as the picture and stays locked to the frames. Put the speaker behind the pumpkins and out of the beam, and tape the cable flat where people walk.

Troubleshooting: Four Things That Go Wrong

The faces have drifted since last night

Something moved, and it is nearly always the projector. An untightened pan head creeps under the weight over a few hours, a tripod leg sinks into damp lawn, a gust rotates a light foam pumpkin. Fix it at the source: mark the tripod feet, hang a bag of sand from the centre column, stand the tripod on a paving slab instead of soil, weight the pumpkins. If everything drifted the same way, moving the projector back onto its marks fixes it without touching the map.

The image looks washed out and grey

Ambient light first, projector settings second, ANSI lumens a distant third. Kill the porch light and the motion floodlight, shade the streetlight, then check whether the projector is in a vivid or dynamic picture mode. Those lift blacks to make daylight viewing look punchy and ruin a black background at night; cinema or standard mode with brightness set low gives a deeper black. If it is still weak, move the projector closer so the same lumens land on a smaller area.

The mouth smears out at the edge of the pumpkin

This is the curve beating a flat quad, and it has two causes. Either WARP is off or its edges are still straight, in which case turn WARP on, double-tap the corner nodes at each end of the smearing edge and drag the orange handles until that edge follows the pumpkin's curve rather than cutting across it; or the pumpkin is rotated too far off-axis and the face is wrapping onto a surface the projector can barely see. Turn its flattest face toward the lens and re-check. No amount of warping recovers a surface that is nearly edge-on.

One pumpkin is much darker than the others

Check three things in order. Colour: a deeper orange pumpkin next to two pale ones will always look dim, and the answer is primer rather than settings. Distance: if it sits 40 cm further back it receives measurably less light, so bring it into line. Content: if that face occupies less area in the source video than the others it is delivering less light by definition, and rescaling its surface will not add brightness that was never in the file.

Keep reading

What SurfaBeam Does and Does Not Do for This

For singing pumpkins, SurfaBeam covers the whole job: multi-surface mapping and corner pinning, Warp for curved objects, digital masking including Pick Custom Mask with Threshold and Invert, MP4 and PNG import, a Timeline for sequencing more than one clip through the evening, and output over USB-C or Lightning HDMI as well as AirPlay and Chromecast. It runs on Android, iOS and iPadOS, macOS and Windows, with the Windows build available as a direct .exe, through the Microsoft Store, and on Steam. One Apple App Store listing covers iPhone, iPad and Mac.

One expectation worth resetting before you go shopping for a loop. SurfaBeam has a music visualizer, but it will not make your singing faces react to a song. It is a separate tool: you point it at its own mp3, wav, ogg or m4a file and it generates one of twelve procedural looks — Fluid Water, Fire Tornado, Galaxy and so on — onto your surfaces in time with that track. An imported MP4 is not analysed and not driven by audio; it plays exactly as it was authored. The lip sync in a singing pumpkins display comes from the loop you bought or made, which is why a clean seamless file matters more than any effect in the app.

What it does not do, stated so you do not find out on 30 October. It drives one projector and one output, so there is no multi-projector edge blending and no blending a second machine in to widen or brighten the group. No DMX or fixture control, so it will not run your smoke machine from the same timeline. No Syphon, Spout or NDI, so it takes no live video feed from another application. No true 3D-model projection from a virtual camera, which means you align by eye against the real pumpkins rather than loading a 3D scan of them. And it is not a media server, so a full facade with several blended projectors is a different class of product.

It also does not supply content. No singing faces, no ghost loops, no bundled library. SurfaBeam plays the media you bring, which here means a loop you bought or one you made.

Free versus Pro is simple. Free gives you the complete mapping, masking, warping, media, effects, tracking, visualizer and Timeline toolset, plus an entry gate before mapping and a watermark on both the projected image and any video you export. Pro removes the watermark and the gate and unlocks Save, Load and Export, including Map Export to PNG. For a project defined by coming back to the same alignment on six consecutive nights, Save and Load are what decide it.

Frequently Asked Questions

Do I need special pumpkins for singing pumpkins?

No, but pale and matte beats dark and glossy every time. Projection is additive: the projector adds light to whatever colour is already there, so a deep orange pumpkin absorbs most of the blue and green in the image and a white tooth comes back as dull grey-orange. Cream or white varieties such as Casper, Lumina and Polar Bear work straight out of the patch, and a carvable craft-foam pumpkin given a coat of matte white primer is the easiest surface of all.

Does SurfaBeam come with singing pumpkin videos?

No. SurfaBeam is the mapping tool, not a content library, and it ships with no singing-face loops. You buy the loops from a content producer such as AtmosFX or a similar seller, or you make your own by filming someone singing against a black backdrop or animating faces in After Effects. SurfaBeam imports MP4 video and PNG images and handles the masking, warping and playback from there.

How far back should the projector be for singing pumpkins?

Multiply the width you need to cover by the projector's throw ratio. Three pumpkins at roughly 50 cm centre to centre span about 1.4 m including their own width, and you frame about 1.5 m to leave a margin for warping, so a 1.5:1 lens sits roughly 2.25 m back and a 1.2:1 short-throw lens sits about 1.8 m back. The often-repeated five to seven feet is a rough version of the same sum, but it only holds for one particular throw ratio, and checking your own projector's spec takes ten seconds.

Can I do singing pumpkins with the free version of SurfaBeam?

You can build and run the display on the free version, which includes the full mapping, masking, Warp, media, effects, tracking, visualizer and Timeline toolset. Two things will bother you for a display the neighbours are looking at: the free version puts a watermark on the projected image and on exported video, and it shows an entry gate before you get into mapping. It also cannot save or load a project, so the alignment you did on Thursday is gone on Friday. Pro removes the watermark and the entry gate and unlocks Save, Load and Export.

How many pumpkins can one projector cover?

Three is the sweet spot and five is about the practical ceiling for one projector. Every pumpkin you add widens the rectangle the projector has to cover, and brightness per square metre falls as that rectangle grows, so a fourth and fifth pumpkin make the whole group dimmer. The outer pumpkins also sit further off-axis, which means more warping and a face that foreshortens. SurfaBeam drives one projector and one output, so covering a wider porch means a brighter projector or a shorter-throw lens, not a second machine blended in.

More answers of this kind live in the SurfaBeam FAQ, and the user guide documents every panel and gesture in the app if you want the reference rather than the walkthrough.

Build it in August, not on 30 October

Set three pumpkins on a table indoors, throw a face loop at them, and do the surface, mask and warp pass once with the heating on. When Halloween arrives you are reloading a saved layout instead of learning a tool in the dark. Install SurfaBeam on Android, iOS, macOS or Windows — the toolset is the same on all of them — and do that rehearsal on the machine that will host the display, so what you rehearse is what runs.

AC

About the Author

Alex Copper

Projection Mapping Editor & Specialist, Secundum Reality

Alex Copper has built outdoor holiday projection installs every season for the past decade, from three-pumpkin porches to full-facade snow scenes. The numbers on the SurfaBeam blog come from real driveways, real lumens and real October weather, including the years when the tripod sank into the lawn by midnight.

Areas of expertise: projection mapping, video mapping, digital mapping, outdoor and holiday projection, curved-surface warping, digital masking, keystone correction.

Related Articles