Skip to content

Display Launcher v0.2 - Intent Support & Home Assistant Integration

Choose a tag to compare

View all tags
@mouldybread mouldybread released this 18 Oct 14:07
· 41 commits to master since this release
v0.2
a388f1d

Display Launcher v0.2 - Intent Support & Home Assistant Integration

🎯 What's New

This release adds intent-based launching capabilities and comprehensive Home Assistant integration.

✨ New Features

Intent-Based App Launching

  • New API Endpoint: /api/launch-intent for advanced app launching with Android intents
  • Deep Link Support: Open specific YouTube videos, URLs, or app-specific content
  • Intent Actions: Support for VIEW, MAIN, SEARCH, and custom intent actions
  • Data URIs: Pass data to apps (e.g., vnd.youtube://VIDEO_ID for YouTube)

Home Assistant Integration

  • Complete Integration Guide: New HOME_ASSISTANT.md documentation
  • REST Commands: Pre-configured YAML for easy setup
  • Input Selects: Device and app selection helpers
  • Scripts: Ready-to-use launcher scripts for single or multi-device control
  • Automation Examples: 6+ real-world automation examples included

🔧 Improvements

  • GitHub Actions: Fixed CI/CD workflow to only trigger on published releases
  • Better Error Handling: Improved error messages for intent launching
  • Documentation: Extensive API reference and troubleshooting guide

📦 API Changes

New Endpoint: POST /api/launch-intent

Request:

{
  "packageName": "com.google.android.youtube",
  "action": "android.intent.action.VIEW",
  "data": "vnd.youtube://dQw4w9WgXcQ"
}

Response:

{
  "success": true,
  "message": "App launched successfully with intent"
}

🏠 Home Assistant Examples

Open YouTube Video

service: rest_command.launch_app_with_intent
data:
  device_ip: "192.168.1.101"
  package_name: "com.google.android.youtube"
  action: "android.intent.action.VIEW"
  data: "vnd.youtube://{{ youtube_video_id }}"

Launch App on All Displays

service: script.launch_display_app
data:
  device: "All Devices"
  app: "YouTube (com.google.android.youtube.tv)"

📝 Use Cases

  • Digital Signage: Rotate content based on time of day or events
  • Smart Home: Launch apps when motion detected or doors open
  • Entertainment: Auto-start Netflix when "movie mode" activated
  • Live Streams: Open specific YouTube streams on schedule
  • URL Content: Display web content via browser intents

🚀 Upgrade Instructions

  1. Download the latest APK from this release
  2. Install over existing version (settings preserved)
  3. For Home Assistant users: Follow the HOME_ASSISTANT.md guide
  4. Test intent launching with curl or Home Assistant Developer Tools

📚 Documentation

  • Full Home Assistant Guide: See HOME_ASSISTANT.md
  • API Reference: Included in Home Assistant guide
  • Package Name Finder: Use adb shell pm list packages

🐛 Bug Fixes

  • Fixed GitHub Actions workflow triggering twice on release
  • Corrected release asset upload permissions

⚠️ Known Limitations

  • No HTTPS support (local network only)
  • No authentication (use on trusted networks)
  • System apps hidden by default
  • Requires Android 7.0+
Assets 3
Loading