Homey Dashboard on Shelly Wall Display XL

[ifMike]

I got a question in another tread about my image of Homey Dashboard running on the Shelly Wall Display XL. So I thought I try a guide here instead.

I’ve tried to remember the steps. But basically you need to enable developer options on the Shelly, enable ADB and open android settings. You always launch the Homey app from the Android settings.

The most cumbersome part is to get the right APKS for Homey and SAI.

You might need to troubleshoot this, but all-in-all it should work something like this. I could be wrong on some points, but you will probably get the idea.

If something does not work, or does not add up - let me know. I did all this a while ago.

Also, this is non-destructive. So your default/normal Shelly app will always work. You can always just press the Shelly icon to go back like nothing ever happened.

Quick Summary

1. Enable Developer Options on the Shelly device
2. Enable ADB (Wi‑Fi or USB)
3. Transfer SAI APK and Homey APK/APKS files to the device using ADB
4. Install Split APKs Installer (SAI)
5. Install Homey using SAI (all split APKs together)
6. Launch Homey via Settings → Apps → Homey → Open

---

Prerequisites

• Shelly Wall Display XL powered on
• Android 11
• Network access (Wi‑Fi)
• Homey app provided as:
  • a single .apks file, or
  • multiple APK files (base APK + configuration APKs)
    (Make sure it contains config.armeabi_v7a.apk)
• Split APKs Installer (SAI) APK
• Computer with Android Platform Tools (ADB)

---

Step 1 – Enable Developer Options

1. Open Settings on the Shelly device

2. Go to About Device

3. Tap the following items in this exact order:

   FW Version
   Hardware revision
   FW Version
   FW Version
   Hardware revision
   FW Version
   Hardware revision
   Hardware revision
   

4. A message will appear confirming that Developer Options are enabled

---

Step 2 – Enable ADB

1. Go to Settings → Developer Options
2. Enable:
   • ADB
   • ADB over Wi‑Fi (recommended)
3. Note the device’s IP address
   (found under Settings → Network / Wi‑Fi)

---

Step 3 – Connect to the Device Using ADB

ADB over Wi‑Fi

On your computer:

adb connect <DEVICE_IP>:5555

Example:

adb connect 192.168.1.123:5555

Accept the authorization prompt on the Shelly display.

Verify connection:

adb devices

---

ADB via USB (Alternative)

1. Connect the Shelly device to your computer using a USB cable
2. Enable USB debugging when prompted
3. Verify connection:

adb devices

---

EASY STEP

If this works for you, then use this. Otherwise, continue to step 4.
Make sure you are in the folder on your MAC/PC where the three apk files are:

adb devices

adb connect "YOUR-IP:PORT"

adb install-multiple Homey-9.6.5.apk config.armeabi_v7a.apk config.xxhdpi.apk

Then continue to Step 7

---

Step 4 – Transfer Installation Files to the Device (ADB)

All installation files are transferred to the Shelly device using ADB.

Create a Working Folder on the Device

adb shell mkdir -p /sdcard/Download/install

---

Transfer Split APKs Installer (SAI)

From the folder containing SAI.apk on your computer:

adb push SAI.apk /sdcard/Download/install/

---

Transfer Homey Files

If you have a .apks file:

adb push Homey.apks /sdcard/Download/install/

If you have multiple split APK files:

adb push Homey-<version>.apk /sdcard/Download/install/
adb push config.armeabi_v7a.apk /sdcard/Download/install/
adb push config.xxhdpi.apk /sdcard/Download/install/

All files should now be available under:

Downloads → install

---

Step 5 – Install Split APKs Installer (SAI)

SAI is installed by opening the transferred SAI.apk file directly on the Shelly device.

1. On the Shelly device, open Settings → Apps
2. Open the File Explorer (where you can see downloaded files) and navigate to:

   Downloads → install
   

3. Tap SAI.apk to start the installer
4. If prompted, allow installation from unknown sources:
   • When Android shows “Install unknown apps” for the app you used to open the file (often a file manager / downloads app), enable Allow from this source
   • Go back one step and tap SAI.apk again
5. Complete the installation

---

Step 6 – Install Homey Using SAI

1. Open Settings → Apps → Split APKs Installer
2. Tap Open
3. In SAI, tap Install APKs
4. Navigate to:

   Downloads → install
   

Installation Options

• Select the .apks file
  OR
• Select all Homey APK files at the same time (base + config APKs)

5. Confirm installation
6. Wait for Installation successful

Installing only the base APK will cause the app to crash.

---

Step 7 – Grant App Permissions

1. Open Settings → Apps → Homey
2. Open Permissions
3. Grant required permissions as needed

---

Step 8 – Launch Homey

Apps on the Shelly Wall Display XL are launched via Android Settings.

1. Open Settings
2. Go to Apps
3. Select Homey
4. Tap Open

---

Troubleshooting

App crashes on launch

• Ensure all split APKs were installed together
• Verify correct ABI (armeabi_v7a)
• Reinstall using SAI

Files not visible in SAI

• Confirm files were pushed to /sdcard/Download/install
• Reboot the device if needed

ADB connection issues

• Ensure ADB is enabled
• Confirm correct IP address
• Accept authorization prompt on the device
• If you’re using ADB over USB, check that the cable you are using is actually for data (don’t ask me how I know)

[Bulletcather]

@ifMike

Shelly Wall Display XL

Thanks for your great explanation.

How fast is the Homey app?

Would this also work for the smaller Shelly models?

[ifMike]

To be honest, it struggles sometimes. Always when loading the first time.
But once it’s up and running on the dashboard it runs smoothly. So I would not guarantee “better” performance" on smaller models.

But work in practice? Yes.

There is also a way where you can do this through the browser (Android settings → Apps → Browser). You just have to give the permissions. Then you have access to whatever page you need to go to.

[brotherhood4]

Super clear explanation — much appreciated

I’m still running into an issue on Shelly firmware 2.5.5, where I can’t seem to get it to start properly.

Which Homey app version are you using on your side? That might help me pinpoint where the difference is.

[ifMike]

@brotherhood4

Which Homey app version are you using on your side? That might help me pinpoint where the difference is.

I just checked. I’m running Homey 9.6.5 on the Shelly.
Shelly is running 2.5.5 (latest)

From what I can remember I tried with different versions until I got it right. And I believe I even tried different “downloads” of the 9.6.5 version as well.

I tried going back in my terminal to see the commands I tried afterwards while trying to update and found this (so that might even work without the SAI)

adb install-multiple Homey-9.6.5.apk config.armeabi_v7a.apk config.xxhdpi.apk

So basically,

1. adb devices
2. adb connect "YOUR-IP:PORT"
3. adb install-multiple Homey-9.6.5.apk config.armeabi_v7a.apk config.xxhdpi.apk
   (you have to do this from the folder where you have the files)

See if that works!

[brotherhood4]

Thanks for the quick reply. Any suggestions where I can download your version? I tried APKpure but i got a config.arm64_v8a.apk and not the config.armeabi_v7a.apk. I think there is the difference

[ifMike]

If you Google “Homey-9.6.5.apk” there should be a site called Apk.watch. Try that

It might even work with later versions if you have the correct armeabi file.. Really don’t know, but worth a try!

[brotherhood4]

Found if! And that was the issue. So if anyone tries it make sure you have the file with onfig.armeabi_v7a.apk in it

[ifMike]

@brotherhood4

Found if! And that was the issue. So if anyone tries it make sure you have the file with onfig.armeabi_v7a.apk in it

I updated the guide with “easy steps”. Thanks for testing my memory

[brotherhood4]

Thanks for sharing!