Estimated reading time: 14 minutes
Imagine if your children could see where Santa Claus is on Christmas Eve. That's exactly what Home Assistant Santa Tracker possible. With this smart integration, your dashboard becomes an interactive Christmas highlight.
For detailed instructions and explanations of all configuration options, I recommend watching the YouTube video linked below. This video goes into detail about each individual setting, providing you with comprehensive instructions on how to set everything up correctly. Any code from the video can be found in this article, so you can use it directly without having to type it out.
What is Home Assistant?
Home Assistant is an open-source platform for home automation that aims to connect all devices in the home and control them centrally. It was developed to provide a unified user interface and simple, flexible control for a wide range of smart home devices from different ecosystems. Here are some points in favor of Home Assistant:
- CompatibilityHome Assistant supports thousands of devices and services from various manufacturers, including lighting, air conditioning, heating, cameras, weather sensors, voice assistants and more.
- Local controlUnlike many commercial smart home platforms that rely on cloud services, Home Assistant runs locally on your network. This means increased privacy and reliability, as your smart home devices work even without an active internet connection.
- Automation and scenesOne of the main features of Home Assistant is the ability to create complex automations and scenarios. For example, you can have lights turn on automatically when it gets dark, or turn on the heating when the temperature drops below a certain level.
- Simple user interfaceHome Assistant offers a user-friendly interface that makes it easy to monitor and control devices. This interface is fully customizable.
- Integration with voice assistantsHome Assistant can be integrated with voice assistants such as Amazon Alexa or Google Assistant to enable voice-controlled control of your smart home devices.
- Open source and community-drivenSince Home Assistant is open source, it is supported by an active community that is constantly developing new integrations and improving existing ones.
- Data protection and securityAs a locally running platform, Home Assistant has the advantage that the data remains within its own network. This protects privacy and increases security compared to cloud-based solutions.
In summary, Home Assistant is a powerful and flexible solution for those who want to design their own smart home and control their devices centrally, regardless of the manufacturer or ecosystem.
🏠 What is the Home Assistant Santa Tracker?
Santa Tracker is based on an open-source project from GitHub and integrates live tracking of Santa Claus directly into Home Assistant. It displays his location, speed, gift counter, and current stops—all automatically.
🎄 Main features
- real-time tracking of Santa's current location, based on the Google Santa Tracker API.
- Statistics and datasuch as:
- Number of countries visited
- Next destinations
- Number of gifts delivered
- Number of mince pies or cookies eaten
- Distance & arrival times
- Festive CCTV videos: Loopende, stylish surveillance camera footage from the North Pole setting, which are displayed via dashboard map.
The videos are not real live feeds — they recreate the illusion of a surveillance camera and provide a playful, interactive experience.
⚙️ Installation – Step by step
For Santa Tracker to work, you need to integrate it as part of your Home Assistant configuration.
🔧 Requirements
You will need:
- A functioning Home Assistant instance
- Access to the configuration files
- Your own videos or sample videos in MP4 format
📁 1. The correct folder structure
Copy the following files from the GitHub repository to your config/ Directory:
config/ ├── automations/ │ └── cctv_loop_player.yaml ├── templates/ │ └── santa_tracker.yaml ├── configuration.yaml (insert excerpt) └── www/
└── media/ ├── a1.mp4 ├── a2.mp4 ├── a3.mp4 └── … more videos(The folder structure is based on the repo structure: "automations," "templates," "configuration.yaml," and "www/media" for videos.) see GitHub.
🧩 2. Integrate configuration
Add the configuration snippet from the GitHub file configuration.yaml in your mainconfiguration.yaml . Sensors, trackers, and dashboard entities are defined there.
🆔 3. Create helper
For the CCTV video system to work, you need to create a Helper create:
- Go to: Settings → Devices & services → Helpers
- Choose: Text
- Name:
random_video_filename - Leave value blank (will be filled automatically later)
📹 4. Embed videos in the dashboard
To ensure that loop videos work:
- Create in the
www/Folder the subfoldermedia/ - Save your MP4 videos there:
a1.mp4,a2.mp4,a3.mp4etc. - When you create your own videos, name them continuouslyso that the automation can play them randomly.
🧠 5. Restart Home Assistant
After all, you have to Restarting the Home Assistantso that the new sensors, tracker data, and automations are loaded.
🎥 Creating your own videos – tips and tools
Because GIF or MP4 videos bring the dashboard to life, it makes sense to create your own clips or use AI tools.
🛠️ Methods for creating videos
✅ AI generators (e.g., Grok-AI or similar tools)
The videos in the repository were generated using an AI tool that produces CCTV-style footage from the North Pole setting and, for example, removes or scales audio.
Example:
ffmpeg -i input.mp4 -an -vf scale=iw/2:-1 output.mp4If you have your own scenes or clips of Christmas decorations, play scenes, or craft activities, you can creatively incorporate them as a CCTV loop.
📊 Designing a useful dashboard
Once you have installed everything, you can go to the Lovelace Dashboard Include the following elements:
📍 Santa Tracking Map
Shows Santa's location on the world map with icons and route.
🎬 CCTV video player
Displays the currently randomly selected video from www/media/.
📈 Statistics & Metrics
Widgets for:
- Country counter
- Gift counter
- Time until the next stop
You can find examples and YAML snippets for cards in the GitHub repository or in the community discussion.
ideas
push notifications
You can create automations that send a message to your phone when Santa reaches a new country.
Christmas dashboard theme
Use icons, graphics, and Christmas colors to make the experience even more festive.
Child-Friendly Display
Place the dashboard on a tablet in the living room or on a smart display where the whole family can see it.
YouTube video implementation
Conclusion
The Home Assistant Santa Tracker is much more than just a gimmick—it combines technology with emotion and makes Christmas interactive. Children and smart home enthusiasts alike will be thrilled when they can follow Santa Claus live on the dashboard. With a little creativity in your videos and automations, your smart home will become a festive experience!
If you need your own custom videos, dashboard layouts, or complex automations, I'm happy to help! 🎄✨
🔗 Useful links at a glance
- GitHub project: https://github.com/chrisefrost/HomeAssistant-Santa-Tracker
- Home Assistant: https://www.home-assistant.io
- Lovelace Dashboards: https://www.home-assistant.io/lovelace
0 Comments