/HINTControl

A cross-platform app using JetBrains Compose to view and control various T-Mobile Home Internet gateways.

Primary LanguageKotlinMIT LicenseMIT

T-Mobile Home Internet Control

A cross-platform app using JetBrains Compose to view and control the following T-Mobile Home Internet gateways:

  • Arcadyan KVD21
  • Arcadyan TMOG4AR
  • Sagemcom Fast 5688W
  • Sercomm TMOG4SE
  • Nokia 5G21

Translating

HINT Control uses Crowdin to manage translations. Help translate to your language here!

Crowdin

Installing

Check the Releases page for binaries.

Android

The Android version is available on the Google Play Store,

Alternatively, you can download HINTControl_Android_<VERSION>.apk and install it.

iOS

The iOS version is available on the App Store.

Windows

Download the .zip ending in windows-amd64.

Native ARM64 Windows builds aren't currently available.

macOS

  • On Intel Macs, download the .zip ending in mac-amd64.
  • On Apple Silicon Macs, download the .zip ending in mac-aarch64.

Linux

  • On Debian-based systems, download the .deb file.
  • On other Linux distros, download the .tar.gz file.

On x64 Linux, download the amd64 variant. On ARM64 Linux, choose aarch64.

Usage Notes

iOS

On iOS, when you enable Snapshots from the Settings page, the stored snapshots will be available in a JSON file from the Files app.

To access the JSON:

  1. Open the Files app.
  2. Tap the "Browse" tab in the bottom right.
  3. Tap the "Browse" tab again to back out of "iCloud Drive".
  4. Choose "On My iPhone".
  5. Tap "HINT Control".
  6. Copy or share snapshots.json as needed.

Support

  1. For questions about your T-Mobile Home Internet service, such as outages, speed, or billing, you'll need to contact T-Mobile support.
  2. If there's a bug or a crash in HINT Control, open a new issue with as much detail as possible.
  3. If you'd like to request a new feature, please check the open and closed issues before creating a new one. Be aware that it might not be possible to implement.
  4. For anything else, send me an email at zachary@zwander.dev.

Building

Desktop

HINT Control makes use of Conveyor to create binaries for different desktop platforms.

Conveyor can build for Windows and Linux from any host OS, but macOS is required to build for macOS.

  1. To build, first download and install Conveyor from the link above.
  2. Next, open a terminal to the project's root directory.
  3. Run ./gradlew :desktop:build (.\gradlew.bat :desktop:build on Windows).
  4. Run the following command based on your target system.
    4.1. Windows: conveyor make windows-zip.
    4.2. Debian: conveyor make debian-package.
    4.3. Linux: conveyor make linux-tarball.
    4.4. Intel Macs: conveyor -Kapp.machines=mac.amd64 make unnotarized-mac-zip.
    4.5. Apple Silicon Macs: conveyor -Kapp.machines=mac.arm64 make unnotarized-mac-zip.
  5. Check the output folder in the root of the project for the binary.

Android

  1. Open the project in Android Studio.
  2. Build the APK or run the Android configuration with your device plugged in.

iOS

Creating an IPA

  1. Open iosApp/iosApp.xcworkspace in Xcode.
  2. Open the "Product" menu, choose "Destination", and select "Any iOS Device (arm64)".
  3. Open the "Product" menu again and select "Archive".
  4. Once the build completes, a new window will open listing the newly-created archive.
  5. Right click the archive and select "Show in Finder".
  6. Right click the highlighted file in Finder and select "Show Package Contents".
  7. Go to Products/Applications and create a new folder called Payload.
  8. Drag HINT Control.app into the Payload folder.
  9. Right click Payload and choose "Compress".
  10. Change the resulting .zip file extension to .ipa.

Running on a Simulator or Device

  1. Open iosApp/iosApp.xcworkspace in Xcode.
  2. Choose your target device in the top of the window.
  3. Press the "Play" button to the left.

Error Reporting

HINT Control uses Bugsnag for error reporting.