OpenPelo lets you install apps, manage files, and control your Android device from a Windows, Mac, or Linux computer. It is designed primarily for Android-based fitness equipment such as Peloton, Echelon, and NordicTrack, but it can work with other Android tablets, phones, and TVs.
Screenshots use sample devices, apps, and files.
Install · Connect a device · Feature walkthrough · Troubleshooting · For contributors
| Feature | What you can do |
|---|---|
| Device connections | Connect over USB or WiFi, switch between devices, and reconnect automatically. |
| App installation | Choose from a catalog tailored to your device or install an APK (Android app file) from your computer. |
| Installed App Manager | Find, open, stop, reset, or uninstall apps, and save a list of what's installed. |
| File Manager | Browse device storage, transfer files, and organize files and folders. |
| Remote screen and media | Use an embedded live screen viewer on desktop, save PNG screenshots, and record video-only MP4 files. |
| Device tools | Choose a default launcher, rotate the screen, apply developer settings, and access Peloton-specific tools. |
| Ready to use | Includes the connection tools you need, with no separate ADB installation. |
Download the version for your computer from the GitHub Releases page:
- Windows:
OpenPelo_Setup_Windows.exe - macOS:
OpenPelo-macOS.dmg - Linux:
OpenPelo-Linux.tar.gz
OpenPelo sets up its connection tools automatically the first time you open it.
Linux releases link to the distribution's libmpv and libepoxy libraries.
Install the matching runtime packages before launching OpenPelo; missing shared
libraries can prevent the application itself from starting. For Ubuntu 24.04,
install libmpv2 and libepoxy0 (package names vary by distribution/release).
The archive does not bundle those system libraries.
- Enable Developer Options on the Android device.
- Enable USB debugging.
- Connect the device with a USB data cable.
- Accept the device's Allow USB debugging prompt.
- Launch OpenPelo, click Refresh Devices if needed, and choose the device from Target Device. The status banner and ADB Messages show connection progress.
The Developer Mode Guide on the home screen provides an in-app setup walkthrough. Menu locations depend on the device and its firmware.
- Connect the computer and Android device to the same local network.
- Open Connect via WiFi, follow the guide, and click I'm Ready - Connect Device.
- For a new Android 11+ wireless-debugging connection, open the device's Pair device with pairing code dialog. Enter its IP address, Pairing Port, and six-digit Pairing Code in OpenPelo.
- Enter the Connection Port from the device's main Wireless debugging screen. This is usually different from the pairing port.
- Click Connect and check the status below the form. Click Done to return to the home screen, or Connect Another to clear the form and add another device.
Use Scan for Devices to find your device and fill in its connection details. Enter the pairing code shown on the device yourself. If the scan finds nothing, enter the details manually. You only need the pairing code and pairing port the first time you pair a device.
With your device connected over USB and on the same WiFi network as your computer, open the wireless connection form and click Pair using USB. Choose your device if prompted. Once Wireless ADB Enabled appears, you can unplug the cable and continue over WiFi.
After your first WiFi connection, OpenPelo remembers supported devices and tries to reconnect automatically, including when you reopen the app. If it doesn't reconnect after a device restart or network change, use Connect via WiFi or Pair using USB again.
Use Target Device to choose the device you want to manage. The list identifies USB and WiFi connections. Peloton devices appear first; other Android devices remain available. Check this selection before starting an operation when multiple devices are connected.
The status banner shows whether you're connected. ADB Messages shows progress and details if something goes wrong. Scroll back to read earlier messages; the down-arrow control returns to the latest activity. Refresh Devices checks the connection again and refreshes the compatible app list.
Click Export beside ADB activity to save the currently retained activity to a UTF-8 text file, including timestamps and message types. Choose the file location in the save dialog. The activity buffer holds the most recent 300 entries. On desktop, the catalog and activity panels resize with the window; the device sidebar scrolls independently when needed.
The device tile also reports total and available RAM, the highest hardware CPU
clock Android exposes, and total/used/available space on the /data filesystem
where apps and user data live. RAM is the memory available to the operating
system; /data capacity excludes other system partitions. Clock is a reported
maximum, not a live frequency. Missing readings show Not reported. Details
refresh about every 30 seconds while idle, or immediately using the tile's
refresh button, without rechecking the app catalog.
- Connect and select a device to populate Compatible applications. The device tile shows its Android version, API level, CPU information, RAM, maximum CPU clock, and storage usage.
- Choose a Category, read the descriptions, and check the apps you want. Selections remain checked when you change categories. All apps shows the full compatible catalog.
- Click Install selected. OpenPelo downloads and installs the selected apps; follow ADB activity for progress and results.
- To install an APK you already have, click Install local APK and choose
the
.apkfile on your computer.
Recommended opens by default and includes SmartSpin2k, Grupetto, Material Files, Lawnchair, Aurora Store, Moonlight, and Google Text-to-Speech when compatible and available. Install all recommended installs the apps shown in that category, without including other checked apps or changing your selections. Only one version of each app is recommended: the preferred catalog build when compatible, otherwise the available legacy build. Other categories are Fitness, Launchers, App stores, Browsers, Files, Media & streaming, and Accessibility.
Google Text-to-Speech uses Google-signed APKs from the Open GApps archive, pinned to a 2022 ARM64 build (Android 6.0+) and a legacy v3.16.6 ARM build (Android 4.4+). After installation, select Google in Android's text-to-speech settings and download your preferred voice. These archived builds are not the latest Google Play release.
The bundled catalog includes fitness utilities such as SmartSpin2k and Grupetto, launchers such as Lawnchair, app stores, browsers, file managers, and media or streaming clients. Entries are not assigned to CPU categories. OpenPelo reads each APK's minimum Android API and native-library architectures, and lists only verified files compatible with the selected device. APKs without native libraries are architecture independent. A 32-bit APK is offered on a 64-bit device only when Android reports support for its 32-bit ABI. Selecting another device updates the list.
Catalog checks use bounded HTTP byte ranges to read ZIP metadata and the manifest, without downloading the full APK collection. Results are cached locally for 24 hours; an hourly check while OpenPelo is running refreshes expired entries and retries failed sources. The catalog's refresh button checks immediately. Latest release links are resolved again when their cached result expires. Missing files, hosts that cannot serve bounded ranges, and unsupported APK formats are excluded and explained in ADB activity. This is a compatibility check, not a guarantee that a vendor's installation policy will permit the app.
The downloaded APK is checked again before installation, including local APKs. The original signing identity is preserved; no APK is repackaged or re-signed.
If Android reports a Signature Mismatch, OpenPelo offers Uninstall & Reinstall. That removes the existing app and its local data before reinstalling. Choose Cancel to keep the current installation.
Open Tools → Installed App Manager to inspect apps on the selected device.
- Search apps finds apps by name or Android package name. Enable System apps to include built-in apps, and use Refresh to reload the list.
- Launch starts an app and opens the remote screen view. Force stop stops the app; App settings opens its Android settings and the remote screen view so you can interact with them.
- Clear data erases the app's saved settings and local data after confirmation. Uninstall removes an app you installed; this action is disabled for built-in apps.
- Export visible list saves the apps shown in the list to a text file in your save folder.
Open Tools → File Manager to browse your device's shared storage, with shortcuts to sdcard, Download, DCIM, and Movies.
- Click a folder to open it, use Up one level, or enter a folder location in Device path and press Enter.
- Click the Name, Size, or Modified column header to sort. Click the same header again to reverse the order.
- Use Upload files here to select local files and send them to the current device folder. Use New folder to create a folder there.
- Use a row's Download action to copy a file or folder to your computer. More actions → Download to... selects a destination for just that download. Rename and Delete operate on the device; deletion requires confirmation.
The bottom of the dialog shows the download destination. Change updates the save folder, while Ask each time prompts for a destination for each download. The transfer area displays progress and results, and a completed download can be located with Open containing folder.
The home screen's Media section groups the save folder and capture controls. On supported desktop platforms, View opens a live H.264 screen viewer using the bundled scrcpy server. OpenPelo does not capture system audio or microphone audio in this first version.
| Control | Walkthrough |
|---|---|
| Save folder | Use Change Location to choose the computer folder used for media, file downloads, and app-list exports. Open Folder opens it in your file browser. |
| Screenshot | Save a PNG picture of the device display to the save folder. The filename includes the date and time. |
| View | Open the live remote-screen viewer. It is configured for 1280 pixels at 30 fps by default; use Tutorial mode for 1920 pixels at 30 fps when the device and connection can sustain it. |
| Record MP4 / Stop (inside View) | Save the live H.264 stream as a video-only MP4 file in the save folder. Keep the device connected until recording stops. |
| Record (on the home screen) | Use the original Android screen-recording method without opening the viewer. Stop this recording before opening the live viewer. |
OpenPelo falls back to a screenshot-based preview when live viewing is not available, including unsupported platforms or devices that reject the server.
For tutorials, open View, choose Tutorial, then Record MP4. The preset
caps the longest edge at 1920 pixels and the frame rate at 30 fps; actual output
depends on the device. Click, drag, scroll, and type inside the viewer to control
the Peloton, or use its Back, Home, and Recents buttons. Recordings contain the
device screen, without OpenPelo's controls. Add narration in your video editor.
Rotation or an encoder-format change ends the current recording and saves its
valid portion; start another recording after the screen settles. Closing the
viewer or the application's window finalizes the recording. A forced termination
or power loss can leave an unfinished .partial file.
Open Tools in the upper-right corner for these additional controls:
- Set Default Launcher: install a launcher (home screen app) first, then open this tool to see available launchers. Click Set Default beside a launcher to make it your device's home screen.
- Rotate Screen: use Rotate to cycle the orientation in 90-degree steps, or enable Auto-rotate to follow how the device is held. Some apps have their own rotation settings.
- Enable Developer Settings: choose Wireless Debugging and/or Stay Awake While Charging, then click Apply. OpenPelo reports results for the requested settings. Connect your device before using this tool.
- Enable/Disable Built-in Netflix: a Peloton-specific tool with Enable Netflix and Restore Defaults actions. If enabling it affects other Peloton features, choose Restore Defaults.
- Uninstall Peloton Apps: choose which Peloton apps to remove. This is an advanced option; removing built-in apps can affect normal Peloton features.
- Check For Updates: checks OpenPelo's GitHub releases. When a newer version is found, the home screen shows View Release, which opens the release page for download. A failed check offers Retry.
| Symptom | What to check |
|---|---|
| No device or empty catalog | Enable USB debugging, use a data-capable cable, accept the device's authorization prompt, click Refresh Devices, and select Target Device. |
| Wireless pairing fails | Check the current six-digit code and pairing port in the device's pairing dialog. The connection port comes from the main Wireless debugging screen. |
| Scan finds nothing | Check that both devices are on the same network and wireless debugging is enabled. Try entering the address and ports manually. |
| Wi-Fi connection fails on macOS | Allow OpenPelo under System Settings → Privacy & Security → Local Network, then retry. The permission covers device discovery, Wi-Fi ADB, and remote viewing. |
| A remembered WiFi device stops reconnecting | Make sure it's on the same network as your computer, then try Connect via WiFi or Pair using USB again. |
| An APK will not install | Check ADB Messages for the reason. Make sure the app supports your device and Android version. If you see Signature Mismatch, read the reinstall prompt before continuing. |
| A file or setting cannot be accessed | Some system folders and settings are protected by Android. Check ADB Messages for details. |
| Capture controls are missing from view | Scroll the home page to Downloads & Media, or enlarge the window. |
See CONTRIBUTING.md for building from source, updating the app catalog, and regenerating screenshots.
OpenPelo is independent and is not affiliated with, authorized by, endorsed by, or otherwise connected to Peloton Interactive, Inc. Product and company names are trademarks of their respective owners. Use this software at your own risk.
OpenPelo is available under the MIT License. Third-party attribution and the pinned bundled-server checksum are in THIRD_PARTY_NOTICES.md.