Adaptive Music
How Do Christmas Light Shows Sync to Music?
By the Starchild Music team · November 6, 2026 · 6 min read

The short answer
A synchronized light show is a map of one recording's timeline. You mark the beats and other moments in sequencing software, place light effects on those marks, and a small computer plays the map and the song together, sending the lights new instructions about 20 times a second. Because the map belongs to that one recording, the music holds still and the lights follow, the reverse of a game, where the music follows the player.
Christmas lights stay in time with a song because someone wrote down the song's timeline first. In sequencing software you mark the beats and other moments, place a light effect on each mark and save the result. On show night a small computer plays that file and the song together. The lights are not listening. They are following a map.
Displays start going up in November, so this is the season to see how it works. Here is the path from a song to a flashing yard, where the timing can go wrong, and what it shows about music that adapts.
Step one: mark the song's timeline
Sequencing programs start from an audio file. xLights, which describes itself as "a free and open source program" for designing and playing lighting displays, has you create a Musical Sequence, choose the audio and set the frame rate. "50ms is the most commonly used one," its quick-start guide says, and the manual notes that 50 milliseconds means a playback speed of 20 frames per second.
Next comes a timing track, a row of marks along the song. The software can place them: its Audio Tempo option "detects the beat and drops a fixed timing track with a mark on every beat." Or you press the t key as the song plays. Effects are placed against the marks, but the manual notes that once they are dropped they have no relation to the marks used to place them. The marks are scaffolding, and they are only as good as the beat finder. Beat finders can make the half-and-double mistakes described in why a BPM finder says half or double, so check the grid by ear.
To try it, download the program, start a new Musical Sequence with a short clip of music you have the right to use, and ask it for beat marks. Thirty seconds is plenty for a first run.
Step two: turn the map into frames and play it
At 50 milliseconds a frame, a three-minute song becomes 3,600 frames, and each frame says what every light should be doing at that instant. The finished sequence goes to a player. The Falcon Player, or FPP, calls itself "a lightweight, optimized, feature-rich sequence player" and is meant for Raspberry Pi and BeagleBone boards. It can talk to lighting hardware using protocols such as E1.31, DDP and DMX. xLights can upload a sequence to it together with the song's audio file. In order, then, the parts are sequencing software on a computer, a player, controllers that run the lights, the lights themselves, and a way to play the sound.
Step three: get the sound to the audience
Sound is slow. NASA Glenn puts the speed of sound at about 1,100 feet per second on a standard day at sea level, so a speaker 100 feet away sounds roughly 90 milliseconds behind the lights, and one 300 feet away about 270. Writing about Bluetooth audio delay, SoundGuys says that delay "above 150ms becomes quite noticeable." Radio waves cross those distances almost instantly, and a car's own speakers sit a few feet from the listener, so sound and light arrive together.
That is how one of the best-known early displays worked. WVXU reports that in 2004 Carson Williams synced 16,000 lights to music at his home in Mason, Ohio. Wikipedia adds that viewers heard the music on an FM broadcast in their cars, which "kept the speaker noise level down for his neighbors," and that a clip of the show circulated widely online in late 2005.
If you try the radio route, check the rules. In the United States the FCC's Part 15 rule for operation in the FM band, 47 CFR 15.239, limits the field strength to 250 microvolts per meter at 3 meters, which keeps the range short. Other countries have their own limits.
A note on rights
If your show plays recorded music for people outside your home, treat it as a public performance. U.S. law counts a performance as "public" if it happens at a place open to the public or is transmitted to the public "by means of any device or process," and the owner of a musical work has the exclusive right to perform it publicly (17 U.S.C. sections 101 and 106). Rights holders usually license that through performing rights organizations, which our song licensing glossary explains. This is general information, not legal advice, so ask the organization or a lawyer before you build a show around a particular song.
If you would rather start from an original holiday song, you can browse holiday songs and read the license terms for public displays before you sequence anything.
Two ways to make lights follow music
What we have described is a sequenced show. It is made ahead of time, repeats exactly and can anticipate a drop, because its author knows one is coming. The other approach is reactive. WLED's documentation says its Audio Reactive feature "lets your LEDs react to music and sound in real time," with the sound fed in through a microphone, a line-in adapter, another WLED device or a PC, and effects drawn from frequency data. Reactive lights work with any music you feed them, but they can only respond to what has just happened.
When the audience picks the song
Some displays let viewers choose. The Remote Falcon docs say "Viewers can request sequences from your show through Jukebox Queue or Voting methods." Its Falcon Player plugin checks shortly before the current sequence ends whether requests or votes are waiting, and if so "it grabs the request or the highest voted sequence and tells FPP to play it next." A setting called Interrupt Schedule lets a request start immediately instead of waiting. Either way, "the scheduled playlist will always resume where it left off."
That is the choice every adaptive music system faces: change at a natural boundary or change now. Game audio designer Guy Whitmore wrote in 2003 that starting a cue "on a specific rhythmic boundary of the underlying music" lets different cues become part of a single piece, and that "transition boundaries and timing are so crucial." Waiting costs a few seconds. Cutting in costs smoothness.
An old idea
The idea is older than LEDs. In 1725, French Jesuit Louis Bertrand Castel proposed an "ocular harpsichord" with 60 small colored glass panes, "each with a curtain that opened when a key was struck." It was played live. Today's sequences are written ahead, but the wish is the same.
What lights teach adaptive music
A light show is a clean case study, because the music holds still and everything else adapts.
- Fixed music, adaptive output. Most game scores flex around the player. A light show is the mirror image, with a fixed recording and flexible visuals.
- A map belongs to one timeline. Swap in a different cut of the song and the lights drift. Versions that share a timeline, as described in designing a song so it can adapt, can share a map.
- Wait or cut in. Remote Falcon's default and its interrupt setting are the two basic choices in any transition rule.
- Check the grid by ear. Automatic beat marks are a starting point, and a grid at half speed sends every effect to the wrong place.
Sources
- xLights: a free and open source lighting sequencer
- xLights manual: Creating a New Sequence
- xLights manual: Sequence Settings
- xLights manual: Timing Tracks
- xLights manual: FPP Connect
- GitHub: Falcon Player (FPP)
- Remote Falcon docs: Introduction
- Remote Falcon docs: FPP plugin setup
- WLED documentation: Audio Reactive
- WVXU: Are you an extreme Christmas decorator? (2013)
- Wikipedia: Carson Williams (electrical engineer)
- NASA Glenn Research Center: Speed of sound
- Cornell Legal Information Institute: 47 CFR 15.239, Operation in the band 88-108 MHz
- U.S. Copyright Office: Title 17, Chapter 1 (sections 101 and 106)
- Game Developer: Design With Music In Mind, A Guide to Adaptive Audio for Game Designers (Guy Whitmore, 2003)
- SoundGuys: Android's Bluetooth latency needs a serious overhaul (Robert Triggs, 2021)
- Wikipedia: Color organ
Find a song to license
Every song on Starchild can be heard in different styles and in your key before you license it.