AdSpot TV – Digital Signage Player for Android TV (Flutter)

AdSpot TV is a professional digital signage and advertising display application built with Flutter for Android TV devices. It connects to a backend server to receive and manage advertising campaigns, plays image and video content in a continuous scheduled loop on TV screens, and reports detailed analytics back to the server. The application includes full offline support, real-time campaign updates via WebSocket, and a clean fullscreen TV-optimized interface.

Designed for out-of-home advertising networks, retail stores, restaurants, hotels, airports, and any environment where managed digital signage is required on Android TV or Amazon Fire TV hardware.

This project requires the AdSpot Pro backend for API endpoints, campaign management, and analytics. The backend is available separately on CodeCanyon: AdSpot Pro – Digital Signage and Advertising Platform.

Key Features

Device Management

Pair the TV device with a 6-character access code from the admin panel
Secure encrypted token storage for authentication persistence across reboots
Automatic device registration with hardware metadata (model, manufacturer, OS version)

Campaign Playback

Supports image campaigns (JPEG, PNG, WebP) and video campaigns (MP4)
Configurable display duration per campaign
Campaign scheduling with start and end time rules and timezone support
Automatic campaign rotation and looping
Smooth fade transitions between campaigns
Idle screen displayed when no campaigns are scheduled

Real-Time Updates and Connectivity

Live campaign updates delivered via WebSocket and Socket.IO with no manual refresh required
Automatic reconnection on network drop with exponential backoff
Offline media caching so playback continues without internet access
Connection status indicator overlay
Graceful degradation when the server is unreachable

Analytics and Reporting

Per-campaign view duration tracking
Heartbeat service sending device status to the server every 30 seconds
Batched analytics event upload to minimize network overhead
Local SQLite database for event queuing when offline

TV-Optimized Interface

Fullscreen immersive display with system UI hidden
Landscape-only orientation lock
Always-on screen wake lock for 24/7 signage operation
D-pad compatible navigation on the pairing screen
Dark theme with gradient design

Developer and Debug Tools

Hidden debug overlay activated by the Konami code sequence
Live display of playback state, current campaign index, and offline status
Structured logging system
Environment-based API configuration for production, staging, and local development

Tech Stack

Framework: Flutter 3.41 with Dart 3
State management: Riverpod 2 with code generation
Navigation: go_router
HTTP client: Dio
Real-time communication: Socket.IO client
Video playback: video_player
Media caching: flutter_cache_manager
Local database: sqflite
Secure storage: flutter_secure_storage
Network monitoring: connectivity_plus
Data models: Freezed and JSON serializable
Device info: device_info_plus
Wake lock: wakelock_plus

Requirements

Flutter SDK 3.41.0 or later
Dart 3.0.0 or later
Android SDK API level 21 or higher (Android 5.0+)
Target device: Android TV or Amazon Fire TV
Backend: AdSpot Pro REST API server with Socket.IO support (sold separately)

Use Cases

Digital advertising networks managing multiple TV screens remotely
Retail store digital signage and product promotion displays
Restaurant menu boards and promotional content
Hotel lobby and corridor advertising screens
Airport or transit lounge information and advertising displays
Corporate office digital notice boards

What is Included

Full Flutter source code (42 Dart files, clean MVVM-like architecture)
Riverpod state management with code generation
REST API and Socket.IO integration layer
Local SQLite analytics database
Media caching and offline playback system
Heartbeat and analytics sync services
Pairing screen, playback screen, idle screen, and debug overlay
HTML documentation file

Notes

A backend API server with REST and Socket.IO endpoints is required. The backend is not included in this item.
After purchase, set your server URL in lib/core/config/app_config.dart and run dart run build_runner build before building.
The application is designed exclusively for Android TV and Fire TV. It is not intended for use on phones or tablets.

AdSpot TV - Digital Signage Player for Android TV