How to install
Two parts: first the idv7lol app goes on the car through the MGU Store, then you add themes. Do it all parked, with the car on stable power (engine running or a charger).
Before you start
- A BMW with iDrive 7 (MGU head unit) and a digital cluster. Many users have already tried it.
- A backup of your head unit’s coding and a way to code it again (BimmerCode, E-Sys or a workshop). Step 1 says why.
- Internet on the head unit for the Store (mgu-uplink: your phone’s hotspot or a modem), or a USB stick.
1 · Install the MGU Store
The MGU Store, by Robert Nisipeanu, is what installs apps on the head unit. idv7lol doesn’t install it for you: follow its README. It needs root SSH access once, which you get with idrive7-8-ssh-root.
The flash leaves the unit uncoded: language, menus and settings reset, the Store refuses to install anything until the unit is coded again, and BMW Digital Key pairings are usually lost. Back up your coding first, have a way to recode ready, and flash only once. If SSH stops working later, use that tool’s enable or persist steps instead of flashing again. idv7lol itself never flashes or codes anything.
Once the Store opens and shows its list of apps, go on to step 2.
2 · Add idv7lol to the Store
Open the sources
In the Store on the car go to Settings › Sources › Add GitHub repository.
Enter the repository
ALMSTRA/idv7lol, then pick a channel:- Branch with
main: builds the app on the head unit from the latest code. Tested on a car; the recommended one. - Releases: a ready-made package from the
catalogrelease. Not tried on a car yet.
Don’t pick Tags: it skips pre-release versions such as
v0.2.0-beta.7, so idv7lol wouldn’t show.- Branch with
Install it
idv7lol appears in the list. Open it and press Install. The Store first installs what idv7lol needs: cluster-render 0.6.6 (the service that draws on the cluster) and its own deploy tool mgu-deploy 0.8.21, which makes an update run the new code. Then it builds idv7lol on the head unit. That takes about a minute.
Restart if asked
If the Store asks to restart the head unit, do it before opening the app.
No internet on the head unit? Copy the repository to a USB stick, plug it in and add it in the Store with Add from USB. The Store builds the app the same way.
3 · First run
Open the app
From the apps menu open idv7lol. Its tabs are Themes, Data, Status, Signals, Renderer and About; Page moves between them. The renderer connection should read connected (id7).
Show it on the cluster
Nothing is drawn until you press Show, or set Show on the cluster: On in Settings. The layout only appears while car data is live: start the car, or turn Demo data on to look at it.
Pick a theme and palette
With Theme and Palette, or in Settings. Start-up sweep and Clock offset from UTC are there too.
Check the way back
Factory warnings stay on top of the theme. Press Show again: the factory cluster is back within a second. Now you know how to get out before you drive.
4 · Add themes from this site
You need app 0.2.0 or newer, or 0.2.6 for themes with an animation such as Volt Runner. Up to 20 themes can be installed at a time.
Download the theme
On the theme’s page press Download for the car. It is an
.idv7pkgfile.Copy it to a USB stick
On any FAT32 or exFAT stick make the folder
idv7lol/themes/and copy the file there. Several themes can sit side by side.Plug it in the car, parked
Open the idv7lol app and plug the stick in. Within seconds the status page says Installed from USB, or why a file was refused.
Pick it
Press Theme until the new one shows. Installing never changes the cluster by itself.
Removing a theme: with the theme on show, choose Settings › Theme from USB on show › Remove it from the car. Delete it from the stick too, or it installs again the next time the stick is plugged in.
Reading the stick hasn’t been confirmed on a car yet. Coming very soon to try: if your head unit is online through the MGU Store, the app will show this catalog on the central display and install themes from it with no USB stick, only while parked.
5 · Updating
When the car app changes, the Store offers an update for idv7lol; install it from idv7lol’s page in the Store. If the app still behaves like the old version afterwards, update the Store’s tools and restart the head unit.
6 · Removing idv7lol
- To get the factory cluster back at once: press Show, or set Show on the cluster: Off in Settings.
- To uninstall: MGU Store › Installed › idv7lol › Remove. Removing cluster-render is optional; other apps may use it.
- The Store can also roll back what it installed. If the head unit misbehaves, its documentation explains how to remove everything over SSH.
If something fails
- idv7lol doesn’t appear in the Store
- Check the source:
ALMSTRA/idv7lolwith Branchmainor Releases, not Tags. - “no catalog release and no …”
- The source was added on Releases before the
catalogrelease existed. Let the Store check its sources again, or remove the source and add it again. Branchmainworks as well. - “coding is missing: it holds default values”
- The head unit has no coding, almost always because of the SSH flash. Code it again (BimmerCode, E-Sys or a workshop) and retry.
- Installed, but no tile in the apps menu
- Update the Store’s tools, then install idv7lol again.
- The app says “not connected”
- cluster-render is not installed or not running. Install it from the Store (source
robertnisipeanu/idrive-apps), version 0.6.6 or newer. - “Waiting for live car data”
- With the engine off and the car asleep, no data arrives. Start the car, or turn Demo data on to check the layout.
- Black boxes on the cluster
- Update the app to 0.2.4 or newer, then restart the head unit: hold the volume knob down for about 30 seconds. From 0.2.4 the layout ends above the car’s own bottom strip; when a layout covered it, some clusters, M cars among them, kept black boxes over it until a restart.
Not here? Report it with a picture or a video. More cases in the troubleshooting guide, and every detail in the repository’s installation guide.
Safety
idv7lol is experimental and not made by BMW. Factory warnings stay on top of the theme, and pressing Show again brings the factory cluster back. Install and try everything while parked.