🚀 Overview

The Football Videos ODDs Comparison & Live Score App is built for publishers, fan communities, and sports startups who need a fast, reliable
way to aggregate fixtures, tables, odds, and short video highlights in one polished mobile experience.
Users can browse matches by league, check pre-match and in-play prices, and watch curated clips or embeds when available.

Experience-led design: The app mirrors real betting-desk workflows (odds movements, market depth, line changes) and live-blog patterns used by major sports sites,
with resilient caching for peak traffic and graceful fallbacks when feeds degrade.

✨ Key Features

• Live Scores & Match Center — fixtures, kick-off times, H2H, standings, live timelines.
• Odds Comparison — pre-match & in-play prices from multiple bookmakers (1X2, O/U, BTTS, AH; depends on API plan).
• Video Highlights & Clips — curated links/embeds for post-match recaps and key moments (rights-respecting).
• Leagues & Filters — top EU leagues, internationals, cups; quick search & team follow.
• Favourites & Alerts — goal, HT/FT, kickoff, odds change notifications.
• AdMob Monetization — banner, interstitial, rewarded (placements configurable).
• Offline Caching — Room/SQLite to browse recent data without network.
• Dark/Light Theme and dynamic typography for readability.
• Localization — strings ready for multi-language UI.
• Analytics Hooks — screen & event tracking (optional).

⚙️ Technical Stack

• Language: Kotlin (primary) / Java compatible.
• UI: Jetpack Compose or XML Views (build-variant selectable).
• Networking: Retrofit/OkHttp + Kotlin Coroutines; WebSocket for live events (if supported by provider).
• Data: Room/SQLite, DataStore (preferences), Paging3.
• Architecture: MVVM + Repository; Hilt for DI; Clean modules.
• Notifications: Firebase Cloud Messaging.
• APIs (choose your provider): football data & odds via services such as SportMonks, The Odds API, RapidAPI endpoints, or custom feeds
  (keys not included; abide by each provider’s T&Cs).
• Minimum Android: 5.0 Lollipop (API 21) — tested up to Android 14.
• Monetization: Google AdMob SDK.

🧩 Installation Guide

1. Open the project in Android Studio (latest stable).
2. Run Gradle Sync; ensure SDK/NDK versions match the build.gradle.
3. Insert your API keys & base URLs in local.properties or secure .env gradle fields.
4. Add your AdMob app/unit IDs in the config file; enable test devices while developing.
5. Customize branding (app name, colors, icons, splash).
6. Build & run on device (⌘/Ctrl + R); verify scores, odds, and video modules.
7. Configure FCM for push alerts; test goal/odds notifications.
8. Create release keystore; generate APK/AAB for Google Play.

📦 Deliverables

• Full Android Studio source code (GPL).
• Modular UI for Scores, Odds, Match Detail, and Video tabs.
• Repository layer with API mappers & caching.
• AdMob integration & sample placements.
• Notification topics & sample FCM payloads.
• Localization template, theming, and assets.
• Documentation (setup, environment, troubleshooting) + changelog.

📱 Supported Platforms

• Devices: Android phones & tablets.
• OS: Android 5.0 → 14.
• Networks: Wi-Fi, 4G/5G; adaptive requests and retry policy.

🧠 Notes

• License: Distributed under the GPL — you may use, modify, and redistribute under the same license.
• Customization Tips:
  • Add more markets (Corners, Cards, Player Props) if your API tier supports them.
  • Implement odds-movement charts and value alerts.
  • Enable league-specific push topics and quiet hours.
  • Cache highlight URLs and add a native player for permitted sources.
  • Ship white-label themes per league or club.
• Compliance & Rights: Use only licensed data/video sources. Respect bookmaker and league T&Cs, geo-restrictions, and robots policies.
  The app does not facilitate betting; it displays informational odds only.
• SEO Assurance: Structured headings, schema.org metadata, and targeted keywords
  (“football odds comparison app”, “live score Android”, “match highlights source code”) improve discoverability.

👨‍💻 Original Developer Credit

Credit is due to the original author of this football scores & odds project.
For official support, commercial licensing, and updates, please refer to the original marketplace listing on
CodeCanyon (or the developer’s website).

🔒 Disclaimer

This download is a GPL redistribution provided for educational and archival purposes.
We are not the original vendor and do not supply paid data feeds, streaming rights, or commercial support.
All league names, club badges, bookmaker marks, and video assets are the property of their respective owners.
If you need production-grade data, media rights, or support, purchase directly from the original developer and licensed data providers.