frabarz.cl / shotnshare
Android TV app to quickly take an screenshot and do something with it.
fork atom
shotnshare / SPECS.md
at main 2.9 kB view raw view code

ShotNShare: Android TV Screenshot & Share App#

Overview#

An Android TV app that enables users to quickly take a screenshot of their current screen and share it via Twitter, WhatsApp, or other supported platforms. The action is triggered by remapping a remote control button for seamless access.

User Flow#

  1. Trigger: User presses a remapped button on the Android TV remote.
  2. Screenshot: The app captures the current screen.
  3. Preview & Share:
    • A simple overlay appears with a preview of the screenshot and sharing options (Twitter, WhatsApp, Copy to Clipboard, etc.).
    • User selects the desired sharing method.
  4. Share: The app invokes the chosen sharing intent (e.g., opens Twitter/WhatsApp with the screenshot attached).
  5. Confirmation: Optional toast/notification confirming the action.

Technical Requirements#

  • Platform: Android TV (API 21+ recommended)
  • Screenshot Capture:
    • Use MediaProjection API for screen capture (requires user consent on first use).
    • Handle overlays and system UI appropriately.
  • Button Remapping:
    • Support for remapping a remote control button (e.g., via Button Mapper or custom accessibility service).
    • Provide instructions for users to set up remapping.
  • Sharing:
    • Integrate with Android's sharing intents for Twitter, WhatsApp, and others.
    • Support for direct sharing to specific apps.
  • UI/UX:
    • Minimal, TV-friendly overlay for preview and sharing options.
    • Large, easily navigable buttons.
  • Permissions:
    • FOREGROUND_SERVICE (for persistent capture service, if needed)
    • WRITE_EXTERNAL_STORAGE (for saving screenshots, if required)
    • INTERNET (for sharing via social media APIs, if direct integration is added)
    • CAPTURE_VIDEO_OUTPUT (if available)
    • SYSTEM_ALERT_WINDOW (for overlays, if needed)
    • BIND_ACCESSIBILITY_SERVICE (if using accessibility for button remapping)
  • Error Handling:
    • Graceful handling of permission denials.
    • User feedback for failed captures or shares.
    • Logging for debugging.

Extensibility & Future Features#

  • Add support for more sharing platforms (Telegram, Facebook, etc.).
  • Allow basic image editing (crop, annotate, blur).
  • Cloud upload (Google Drive, Dropbox, etc.).
  • History of recent screenshots.
  • Customizable overlay UI.

Notes#

  • Some Android TV models may restrict screen capture due to DRM or system limitations.
  • Button remapping may require third-party apps (such as Button Mapper) or accessibility services, as not all remotes are customizable by default. On some Android TVs, the Accessibility service is missing, but Button Mapper can still launch an exported activity or send a broadcast intent to trigger the screenshot action.
  • The app should be modular to allow easy addition of new sharing targets or features.