Skip to content

A lightweight Flutter Desktop tool to manage remote debugging sessions via SSH, ADB, and `flutter attach`. Perfect for developers working with remote Android devices, embedded boards, or LAN-connected iOS simulators.

Notifications You must be signed in to change notification settings

jonasermert/Flutter-Remote-Debug-UI

Repository files navigation

🧰 Flutter Remote Debug UI

A lightweight Flutter Desktop tool to manage remote debugging sessions via SSH, ADB, and flutter attach.
Perfect for developers working with remote Android devices, embedded boards, or LAN-connected iOS simulators.


✨ Features

  • πŸ”— Establish SSH tunnels to remote Flutter devices
  • πŸš€ Run flutter run remotely via SSH
  • πŸͺ„ Start flutter attach with a single click
  • πŸ“‘ ADB TCP port forwarding for Android devices (local or remote)
  • 🌐 Open Flutter DevTools from the UI
  • 🧠 Saved hosts dropdown for quick access
  • 🧾 Live logs view in the interface

πŸ“Έ Screenshots

(Add UI screenshots here, e.g., assets/screenshot1.png)


πŸ–₯️ Supported Platforms

  • βœ… macOS
  • βœ… Windows
  • βœ… Linux

Make sure Flutter Desktop support is enabled:

flutter config --enable-macos-desktop
flutter config --enable-windows-desktop
flutter config --enable-linux-desktop

βš™οΈ Requirements

  • 🧩 Flutter installed on both local and remote machines
  • πŸ” SSH access to the remote device (e.g., Raspberry Pi, Linux server)
  • πŸ“± Android device available via USB or ADB-over-WiFi
  • πŸ›  The app must be in debug mode (not release-signed)

πŸš€ Getting Started

  1. Clone the project:
git clone https://github.com/your-username/flutter-remote-debug-ui.git
cd flutter-remote-debug-ui
  1. Install dependencies:
flutter pub get
  1. Run on your platform:
flutter run -d macos      # or windows, linux

πŸ”Œ Usage

  1. Enter SSH credentials, ports, and remote host
  2. Select a saved host from the dropdown
  3. Click Connect & Attach
  4. Optionally use Flutter Run (Remote), ADB Forward, or DevTools

πŸ“‚ Project Structure

lib/
β”œβ”€β”€ main.dart             # Main UI with SSH and Attach logic
β”œβ”€β”€ widgets/              # (optional) reusable UI components
assets/
β”œβ”€β”€ screenshot1.png       # UI screenshots for the README
README.md

🧠 Possible Enhancements

  • βœ… Load host configs from a local file
  • ⌨️ Hotkey support for quick commands
  • πŸ’Ύ SSH/attach session history
  • πŸ›  SSH key picker + advanced auth options

πŸ“œ License

MIT License – free to use, share, and contribute.


πŸ™Œ Contributions

Pull requests and issues are welcome!
If you have tips for remote Flutter workflows (e.g., ADB tricks, SSH aliases), share them in the discussions!

About

A lightweight Flutter Desktop tool to manage remote debugging sessions via SSH, ADB, and `flutter attach`. Perfect for developers working with remote Android devices, embedded boards, or LAN-connected iOS simulators.

Topics

Resources

Stars

Watchers

Forks

Languages