Tesla light show not working: a troubleshooting checklist
When a custom light show does not work, the cause is almost always one of a handful of things. Work through this list from the top. It is ordered so the quickest checks come first.
Checked against Tesla’s published light show guide on November 12, 2026.
Start here: read the popup title
Plug the drive in, wait a few seconds, then open Toybox, Light Show, Schedule Show. Tesla says that if the popup title is Light Show instead of Custom Light Show, the requirements are not being met for the drive formatting, the folder, or the files.
Tesla also says error messages appear when the required files exist but there is a problem with the sequence file. If you see an error, read it. It is pointing at the .fseq.
The car does not list my show
- Check the car. Supported vehicles are Model S (2021 or later), Model 3, Model X (2021 or later), Model Y, and Cybertruck, on software v11.0 (2021.44.25) or newer.
- Check the format. exFAT, FAT32, ext3, and ext4 work. NTFS does not.
- Check the folder name. It must be LightShow at the top level, with a capital L and a capital S.
- Check that the files are inside that folder, not beside it.
- Check that the .fseq file and the audio file have the same name apart from the extension, including capitalization.
- Look for a TeslaCam folder, or map or firmware update files, at the top level. Tesla says the drive must not contain them.
- Plugged into the right place? Use a front USB or USB-C port or the glovebox port, and give the car a few seconds.
- Several shows on one drive need vehicle software 2023.44.25 or newer.
If you copied files from a Mac, hidden files beginning with ._ may appear next to your show files. Tesla does not list them as a cause, but they serve no purpose on the drive, and Maestro removes the ones it creates.
The audio is out of sync with the lights
Check the sample rate. Tesla says audio must be encoded at 44.1 kHz, and that less common 48 kHz files will not sync properly. Re-export the audio at 44.1 kHz and keep the same name as the .fseq.
If you built the show in xLights, confirm FSEQ Version is set to V2 Uncompressed in File, Preferences, Sequences, as Tesla instructs.
The car shows an error about the sequence
Run Tesla’s validator on the .fseq without a car. Tesla provides validator.py, plus validator-windows.exe and a macOS build for people without Python. The command is python3 validator.py yourshow.fseq on macOS, or python validator.py on other systems. It prints the frame count, step time, and total duration, and reports problems it finds.
Closures misbehave, or the show stops partway
- Closures such as doors, windows, mirrors, and the charge port have command limits per show, and only Open, Close, and Dance count toward them. Tesla says commands spaced very close together cause little visible movement and use up the limits quickly.
- Closures can only dance for a limited time before reaching thermal limits. If that happens, the closure stops moving until it cools down. Tesla recommends dancing for about 30 seconds or less per show.
- Tesla notes that moving the windows while Model X doors are moving can cause false pinch detections, which stop the light show.
- The charge port door closes automatically 2 minutes after it opens, whatever the show says.
Some lights never turn on
Not every car has every light. Tesla lists several cases: front fog lights are not installed on the Model 3 Standard Range Plus, aux park lights are not installed on that car either, and side markers are only installed in North America. Tesla also says a car without a given light does not substitute another light for it.
The guide to which lights each Tesla can use goes through each model.
Still stuck
Try the drive in a second front port or the glovebox port, and try a different drive if you have one. Tesla points to r/TeslaLightShow on Reddit as a community for light show questions. If you use Maestro and have a problem, the developer replies to email at the address on the support page.
Quick answers
- Why does the popup say Light Show instead of Custom Light Show?
- Tesla says this means the drive does not meet the requirements for formatting, the LightShow folder, or the required files. Check the format, the folder name and capitalization, the file names, and that no TeslaCam folder is on the drive.
- Why is my music out of sync?
- The usual cause is 48 kHz audio. Tesla says audio should be encoded at 44.1 kHz, and that 48 kHz files will not sync properly.
- Can I test a show without the car?
- You can check the sequence file with Tesla’s validator.py script, which reports problems without needing a vehicle. It does not check your USB drive layout.
Want a show made from a song?
Maestro turns any song into a Tesla light show on iPhone, iPad, or Mac. Free to try, no account.
Maestro is an independent app from Molargik Software and is not affiliated with or endorsed by Tesla, Inc. Tesla, Model S, Model 3, Model X, Model Y, and Cybertruck are trademarks of Tesla, Inc.