Technical Guide For CMZ Launcher

Technical Guide for CMZ Launcher: Disabling the Default Home Screen

This process replaces the default Android TV launcher to ensure a controlled environment for the Mosques. By deploying the CMZ Launcher (us.msasoftware.cmzlauncher), administrators can prevent the display of unwanted or inappropriate images typically found on the standard interface. The CMZ Launcher is designed to automatically launch the CMZ TV app and ensure that the application restarts automatically whenever the TV restarts.

1. Download and Set up ADB

The Android Debug Bridge (ADB) is a versatile command-line tool that lets you communicate with a device. To begin:

Download the SDK Platform-Tools for your specific operating system (Windows, Mac, or Linux) from the official Android Developer website – https://developer.android.com/tools/releases/platform-tools.
Extract the ZIP file to a dedicated folder on your computer, such as C:\platform-tools.
Open your terminal or command prompt and navigate to the folder where you extracted the tools.
- On Windows (Command Prompt), use cd C:\platform-tools.
  - Video Tutorial: https://youtu.be/JQrMvecOAeE?si=UzGZIN0DPf8ribiA
- On Mac/Linux (Terminal), use cd /path/to/platform-tools (or wherever the folder was extracted).

2. Enable Developer Mode on Your TV

To allow the computer to communicate with your TV, you must unlock the internal developer settings:

Navigate to Settings on your Android TV.
Select Device Preferences (or System) and then About.
Scroll down to the Build number section.
Please Note: Some TV Might shows different label. Please look for Build or Build Number or Android TV OS build or Something similar.
Press the “Select” button on your remote repeatedly (usually seven times) until a toast notification appears stating, “You are now a developer!“
Return to the previous menu (Device Preferences or Systems) and select Developer Options.
Toggle the switch for Wireless Debugging to the “On” position.

Video Tutorial: https://youtu.be/0xY2-p-FJLU?si=9I4OotG2ULNl7mzj

3. Connect to the TV Wirelessly via ADB

Once your TV is ready, you must establish a handshake between your computer and the TV over your local network: We can connect to 2 ways

3. 1 [1st way] Pair mode:

Navigate to Settings > Device Preferences > Developer Options.
Enable Wireless Debugging (toggle it to ON).
Click directly on the text “Wireless Debugging” to open its sub-menu.
Select Pair device with pairing code.
- You will see an IP Address & Port, a Pairing Code, and a separate Port for the pairing process. Keep this screen open.
Open your Terminal/Command Prompt and use the pair command. Use the Port specifically shown in the “Pairing Code” popup (this is usually different from the main connection port).
- Command: adb pair [TV_IP_ADDRESS]:[PAIRING_PORT]
  1. Example: adb pair 192.168.1.15:37845
- When prompted, enter the 6-digit pairing code shown on your TV. If successful, you’ll see: Successfully paired to 192.168.1.15:37845
Once paired, you still need to “connect” to the service. Look at the main Wireless Debugging screen (the pairing popup may have closed) for the “IP address & Port” listed under the “Wireless Debugging” toggle.
Command: adb connect [TV_IP_ADDRESS]:[CONNECTION_PORT]
- Example: adb connect 192.168.1.15:42301

Video Tutorial: https://youtu.be/iFzz744quJ4?si=E9nYvjUtu6RUHu8Y

Note: Only need to flow till 2:26

3.2 [2nd way] Direct connect

Find your TV’s IP address by going to Settings > Network & Internet and selecting your active Wi-Fi connection.
On your computer, in the terminal/Command Prompt, type the following command (replacing the placeholder with your TV’s IP):
adb connect [Your TV IP Address]
- Example
  - adb connect 192.168.1.50:5555
    - The port number (5555) is the default port used by Android Debug Bridge (ADB) for TCP/IP connections.
A prompt will appear on your TV screen asking to “Allow USB Debugging?” Select Always allow from this computer and click OK.

4. Disable the Existing Launcher

With the connection established, you can now execute the command to disable the system’s default launcher. Running this command permanently enforces the pre-installed CMZ Launcher as the primary home screen, ensuring the TV remains locked to the intended Mosque environment.

Open CMZ Launcher in your TV> Click on i (Info) Button located on top Right corner>
Look for Existing Home Package Name
Note: If Existing Home Package Name not showing then CMZ Launcher is set to Default Home Already. You do not need to disable anything.
Execute the following command in your terminal:

adb shell pm disable-user –user 0 [package name shown on the tv]

Example:
adb shell pm disable-user –user 0 com.google.android.tvlauncher

Important Considerations

Recovery: If you wish to revert to the default launcher, use the command: adb shell pm enable com.google.android.tvlauncher.
Third-Party Launchers: Always ensure a replacement launcher is installed and functional before disabling the default system package to avoid a “black screen” state.