Custom digital cluster layouts for BMW iDrive 7 (MGU) cars, plus an editor for Windows and macOS to design them.
🎉 Now in beta: idv7lol.comBrowse 13 themes with a live preview, download any of them for the car (a USB stick, no account needed), sign in to upload your own layouts and vote for the ones you like. New: the web editor. idv7lol Studio in the browser, nothing to install: design, try it with the simulator, compile for the car and share, with a free account on a computer (Chrome, Edge or Firefox). The desktop app is still the better pick for the car. The site and the install guide are in English, Español, Русский, 日本語 and 简体中文, and there's a place to report bugs with a picture or a video. Read the announcement. Coming very soon to try: download themes from the site's catalog straight in the car, no USB stick needed. |
You draw your cluster on the PC, drive it with a simulated car to see how it behaves, check it against the limits of the cluster renderer, and build a package that the MGU Store can install. When idv7lol is switched off, the car shows its factory cluster again.
Disclaimer. This is an unofficial hobby project. It has nothing to do with BMW AG. Changing what your cluster shows can distract you, and it may affect your warranty or break local rules. Use it parked or on a closed course, keep the factory warnings visible, and read SECURITY.md first.
Status: 0.2.0-beta.7, an experimental pre-release. Tested on one car: on a 2021 X4 M Competition (iDrive 7) the app installs and updates from the MGU Store, its themes draw on the cluster with live car data (fuel and range included), and switching it off brings the factory cluster back. Its owner reports that everything tried worked well. Other cars and themes loaded from a USB stick haven't been confirmed yet. Details in docs/PROJECT_STATUS.md.
New in beta 7: the Studio has a new view that takes the work a step at a time (Template, Design, Simulate, Validate, To the car). It asks which one you want, and the classic view is still there under … > View. The desktop app looks for a newer version when it starts and can update itself, asking first unless you tell it not to; that works from beta 7 on, so install this one by hand. The Windows installer now comes in all five languages. In the car, the app has a new screen with tabs, sketches of the themes and the idv7lol icon (app 0.2.14).
Download: the Windows installer of idv7lol Studio is on the Releases page. It isn't signed, so Windows SmartScreen warns the first time; choose More info and Run anyway. The Studio speaks English, Español, Русский, 日本語 and 简体中文 (… > Language); it starts in your system's language when it has it, otherwise in English.
In the browser: the same Studio runs at idv7lol.com/editor, with a free account. Files open and save through the browser instead of straight to a USB stick.
On a Mac: there is a build for Apple silicon and Intel Macs (macOS 10.15 or newer). It is compiled but not tested on a Mac yet; how to get it and open it the first time is in docs/user/INSTALL_MAC.md.
The editor with the Performance theme while the simulator drives a track lap:
The welcome window, where you start from a template, open a theme or begin with an empty layout:
| Image editor | Build & Deploy |
|---|---|
![]() |
![]() |
| Light mode, Classic theme | Community template: Digital Dash |
|---|---|
![]() |
![]() |
| Template: Rally Dash | Template: Night Minimal (Sport palette) |
|---|---|
![]() |
![]() |
| Car preview: the car app's own engine and shaders | Library blocks next to Supercar Track |
|---|---|
![]() |
![]() |
Theme details and sharing a theme with the community:
These are screenshots of the Studio running on a PC. They are not photos of a car.
- idv7lol Studio, the editor for Windows and macOS. Drag gauges, bars, readouts and text onto the layout, import pictures, GIFs or short videos and edit them, try it with the simulator, and build. In English, Spanish, Russian, Japanese and Simplified Chinese, on the desktop or in the browser.
- Themes to start from. The newest first: Lily Pad (a night pond where a tree frog hops in the rev ring, faster the faster you go, with fireflies for shift lights and reeds for fuel, oil and water), Supercar Track (a thick segmented rev band to 10 under a yellow rim, a huge red gear and a hexagon floor, in the style of Italian supercar clusters), Neon Drive (cyberpunk: neon speed in turning holo rings, a segmented rev bar and a glitch past 130), Heritage 89 (round dials with chrome bezels and amber lighting, inspired by late-80s and 90s BMW clusters) and Volt Runner (bright yellow, with a running bolt in the middle). Then Performance, Modern, Classic, Night Minimal and Rally Dash, plus seven free community layouts converted from eroobeeroo's Cluster Layouts (GPL, credited in each theme).
- The car app, which runs on the head unit, draws the active theme through
cluster-render, and lets you turn it on or off and switch themes from the iDrive menu. - The pieces behind them: a signal catalog, the theme format, a renderer for the PC preview, a simulator and the compiler that turns a theme into what the car runs.
| Part | State |
|---|---|
| Signals, theme format, engine, simulator | written, covered by tests, published |
| Compiler (GLSL layers, SDF fonts, validator) | written, covered by tests, published |
| Bundled themes | pass validation, compiled into the car app |
| idv7lol Studio for Windows and macOS | tested on a PC; Mac build compiled, not tested on a Mac; unsigned installers released |
| Car app (Node 8) | installs and draws on a car (one car so far) |
| Tested in a vehicle | yes, X4 M Competition 2021: the car app, its themes and live data |
You need Node.js 20 or newer (24 works best) and npm 10. For the desktop app you also need Rust (MSVC toolchain), Visual Studio Build Tools 2022 with the C++ workload, and WebView2.
git clone https://github.com/ALMSTRA/idv7lol.gitcd idv7lol && npm installnpm testnpm run tauri:devThere is more in docs/QUICKSTART.md and docs/developer/BUILD.md. Spanish speakers can start with docs/user/GUIA_USUARIO_ES.md.
These steps have worked on one car so far. Do them parked with the car on stable power, and know how to remove the app before you start (last step below). The full guide is docs/user/DEPLOYMENT.md.
You need a BMW with an iDrive 7 (MGU) head unit and the MGU Store installed on it. Installing the Store needs root SSH access once; its README explains how.
Heads-up before the SSH unlock: the flash that enables SSH erases the head unit's coding. Its settings reset, the Store refuses to install until the unit is coded again (BimmerCode or E-Sys), and Digital Key pairings are usually lost. Back up your coding first and flash only once. Details in DEPLOYMENT.md.
- In the Store on the car, open Settings, then Sources, then Add GitHub repository,
and enter
ALMSTRA/idv7lol. The Store offers Releases first: that works (it reads thecatalogrelease, a ready package), and so does Branchmain(the Store builds the app on the head unit from the latest code). Don't pick Tags: it skips pre-release tags likev0.2.0-beta.7. - Open idv7lol in the list and press Install. The Store installs
cluster-renderfirst if it is missing, then builds idv7lol on the head unit. That takes about a minute. - Restart the head unit if the Store asks for it.
- Open the idv7lol app from the apps menu. Its first tab, Themes, shows a sketch of the theme on show with its neighbours. Nothing is drawn on the cluster until you press Show, and the layout only appears while car data is live.
- Pick the theme and palette with Theme and Palette, or in Settings. Page (or a tap on a tab) goes to the car's data and the diagnostics pages.
- To go back to the factory cluster, press Show again. To uninstall, use Remove in the Store's list of installed apps.
No internet on the head unit? Copy the repository to a USB stick and add it in the Store with Add from USB. The Store builds it the same way.
Once idv7lol 0.2.0 or newer is on the car, your own themes go over on a USB stick. No GitHub, no rebuild and no internet.
- In the Studio, open Build & Deploy, press Compile theme, then Save for the car (USB)
and pick your USB stick. The theme is saved as
idv7lol/themes/<theme>.idv7pkgon the stick. - Plug the stick into the car with the idv7lol app open. Within a few seconds the app finds the theme, checks it and installs it. The app page says what it installed, or why a file was refused.
- Press Theme until your theme shows. Nothing changes on the cluster before that.
- To delete it, show it and choose Settings > Theme from USB on show > Remove it from the car. Themes built into the app can't be removed. If the file is still on the stick, it installs again the next time you plug the stick in.
The car checks every package before installing it: layer count, image sizes, renderer memory, that everything sits on the panel and that it only names shaders the app already has. Packages carry no shader code of their own. Up to 20 themes can be installed this way.
The USB path hasn't been tried on a car yet. In particular, it is not confirmed that the app can read the stick. Cluster Layouts writes its logs to sticks in the same place, which is a good sign.
To change the themes that come inside the app, fork this repository, put the theme in your fork as
themes/<your-theme>/theme.json, check it and regenerate the car files:
npm run themes:validatenpx tsx tools/build/build-mgu-themes.tsThen commit, push, and add your fork in the Store instead of ALMSTRA/idv7lol.
On the car, the 12 V battery is not read yet and shows dashes; the fuel level and range come from the cluster and the engine unit (read on the X4 M). Opacity animations don't play there either. The current list of known limits is in the deployment guide.
A theme is a JSON file (themes/<id>/theme.json) with a list of components. Each one reads a
signal such as engine.rpm and takes its colours from the theme's palette. The Studio edits that
file and draws it on a canvas. For the car, the compiler turns the same file into one small GLSL
ES 1.00 shader layer per piece (the renderer allows 64 per app), a glyph atlas for text, and data
for a Node 8 app. That app reads vehicle signals over SOME/IP and feeds them to cluster-render,
which passes the scene to the cluster's own RAMSES renderer. Turning the app off removes the
layers, and the factory cluster comes back.
- Architecture and renderer notes
- Making themes, components and signals
- Building, installing on the car, compatibility and troubleshooting
- Project status and changelog
GPL-3.0-or-later. Third-party parts keep their own licences, listed in THIRD_PARTY_NOTICES.md.
Contributions are welcome, see CONTRIBUTING.md. Ask questions in GitHub Discussions. Report security problems privately as described in SECURITY.md.
idv7lol is made by @1vs1m88 on Instagram: say hi there, or show what your cluster looks like.
It is built on top of other people's open-source work. Thank you to all of them.
- eroobeeroo/idrive7-cluster-info: Cluster Layouts proved that a fully custom layout works on the KOMBI, and it is the project this one started from. Its seven layouts are included as free templates, converted to idv7lol's format (GPL-3.0-or-later, see themes/community/README.md).
- cauliflowermossgrape/idrive7-apps:
the app kit and GPU renderer. The kit is included in
kit/under the MIT licence. - robertnisipeanu/idrive-apps:
cluster-render, the service that draws on the cluster. Its client is included under MPL-2.0. - robertnisipeanu/mgu-store: the Store that installs apps on the head unit.
- Barlow by Jeremy Tribby (SIL Open Font License) for the cluster font, and Lucide (ISC) for the editor's icons.
Full licence details are in THIRD_PARTY_NOTICES.md.
Claude Code measured its own share from its session logs on
2026-11-11: about 80% of the code and docs match lines it wrote (60% counting the themes'
data files, which scripts and the Studio produce). The rest is the author's own work, or was
reformatted or generated afterwards. Vendored code (kit/, the renderer client) and generated
files are left out of the count.
And the tokens it took to get here:












