Menu
Launch and drive the Airo TV Flutter app (main_tv.dart entrypoint) on a target device — macOS desktop, Chrome, Android/Fire TV, or phone. Use whenever asked to run, start, or preview Airo TV.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when building or reviewing leanback TV UI — Android TV, Google TV, or Fire TV apps — including D-pad navigation, focus states, TV screen layouts/grids, TV component design (buttons, cards, carousels, nav drawers, tabs, lists), TV color/typography, or TV app icons and banners.
Launch and drive the Airo TV Flutter app (main_tv.dart entrypoint) on a target device — macOS desktop, Chrome, Android/Fire TV, or phone. Use whenever asked to run, start, or preview Airo TV.
Refresh Airo public branding, GitHub Pages content, device guides, screenshots, release links, and public roadmap from verified release evidence. Use for every Airo or Airo TV release, public website refresh, tutorial update, community-voice summary, or approved Airo TV Pro capability announcement.
Guidelines and topological execution order for running local release qualification, preflight checks, and merge-readiness tests to avoid expensive remote CI runs.
| name | run-airo-tv |
| description | Launch and drive the Airo TV Flutter app (main_tv.dart entrypoint) on a target device — macOS desktop, Chrome, Android/Fire TV, or phone. Use whenever asked to run, start, or preview Airo TV. |
Airo TV is the TV-flavored Flutter entrypoint at app/lib/main_tv.dart (distinct from
main.dart, main_airo_iptv.dart, main_mobile_streaming.dart, main_qualification.dart).
cd app && flutter devices
Typical targets seen in this repo: macos (desktop), chrome (web), an Android device/emulator
(android-arm64), Fire TV/Android TV over adb.
Run from the app/ directory, targeting main_tv.dart explicitly — the bare flutter run
defaults to main.dart, which is the wrong entrypoint for the TV experience.
cd /Users/udaychauhan/workspace/airo/app
flutter run -d macos -t lib/main_tv.dart
Swap -d macos for -d chrome, -d <android-device-id>, etc. as needed.
pod install for the macOS Runner — can take 30-90s before
"Building macOS application..." appears.flutter_image_compress_macos, flutter_tts, and pdfx don't
support Swift Package Manager on macOS yet — this is a non-fatal deprecation warning, not
a build failure. Ignore it.flutter run is long-lived (hot-reload session) and never "completes," so launch it
detached and tail the log rather than blocking on it:
nohup flutter run -d macos -t lib/main_tv.dart > /tmp/airo_tv_macos_run.log 2>&1 &
Poll/monitor for one of the terminal signals:
Flutter run key commands (the hot-reload prompt) or a line like
🔥 To hot reload changes / An Observatory debugger and profiler on macOS is available at.Error, error:, Exception, or Failed.until grep -qE "Flutter run key commands|Error|error:|Exception|Failed" /tmp/airo_tv_macos_run.log; do sleep 3; done
tail -60 /tmp/airo_tv_macos_run.log
Once the macOS window appears, it's a normal desktop app window — screenshot it to confirm
it rendered rather than just checking the process launched. The TV UI expects an authorized
M3U playlist to be added before channels appear (see
docs/features/airo-tv/AIRO_TV_DEVICE_GUIDE.md
for expected user flow / feature status if you need to sanity-check behavior against spec).
pkill -f "flutter run -d macos -t lib/main_tv.dart"
or kill the specific dart_tools PID from ps aux | grep main_tv.