Skip to content
ALMSTRAPublic

About

Open-source BMW iDrive 7 custom digital cluster platform, visual theme editor and development toolkit

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

47 stars

Watchers

2 watching

Forks

Latest commit

 

History

165 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

idv7lol

idv7lol

Custom digital cluster layouts for BMW iDrive 7 (MGU) cars, plus an editor for Windows and macOS to design them.

🎉 Now in beta: idv7lol.com

Browse 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.

Screenshots

The editor with the Performance theme while the simulator drives a track lap:

idv7lol Studio editing the Performance theme

The welcome window, where you start from a template, open a theme or begin with an empty layout:

Welcome window with the bundled and community templates

Image editor Build & Deploy
Image editor Compiling a theme for the car
Light mode, Classic theme Community template: Digital Dash
Classic theme in light mode Digital Dash
Template: Rally Dash Template: Night Minimal (Sport palette)
Rally Dash Night Minimal
Car preview: the car app's own engine and shaders Library blocks next to Supercar Track
Car preview Library blocks

Theme details and sharing a theme with the community:

Theme details and File › Share with the community

These are screenshots of the Studio running on a PC. They are not photos of a car.

What you get

  • 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.

Where things stand

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

Building it

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.git
cd idv7lol && npm install
npm test
npm run tauri:dev

There is more in docs/QUICKSTART.md and docs/developer/BUILD.md. Spanish speakers can start with docs/user/GUIA_USUARIO_ES.md.

Putting it on the car

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.

  1. 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 the catalog release, a ready package), and so does Branch main (the Store builds the app on the head unit from the latest code). Don't pick Tags: it skips pre-release tags like v0.2.0-beta.7.
  2. Open idv7lol in the list and press Install. The Store installs cluster-render first if it is missing, then builds idv7lol on the head unit. That takes about a minute.
  3. Restart the head unit if the Store asks for it.
  4. 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.
  5. 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.
  6. 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.

Your own theme, with a USB stick

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.

  1. 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>.idv7pkg on the stick.
  2. 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.
  3. Press Theme until your theme shows. Nothing changes on the cluster before that.
  4. 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.

Changing the built-in themes

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:validate
npx tsx tools/build/build-mgu-themes.ts

Then 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.

How it works

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.

Docs

License and contributing

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.

Credits

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.

Full licence details are in THIRD_PARTY_NOTICES.md.

Made with Claude Code

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.

A Claude Code session working on idv7lol: segmenting the rev arc on the car and running the tests

And the tokens it took to get here:

SpongeBob in front of a fire

About

Open-source BMW iDrive 7 custom digital cluster platform, visual theme editor and development toolkit

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

47 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages