Skip to content

Tv-Maniac is a personalized entertainment tracking and recommendation Multiplatform app (Android & iOS) for tracking TV Shows using TMDB API.

License

Notifications You must be signed in to change notification settings

thomaskioko/tv-maniac

Repository files navigation

TvManiac

Check android ios

TvManiac is a personalized entertainment tracking and recommendation Multiplatform app (Android & iOS). By utilizing Trakt, we are able to view shows, create a watchlist get statistics and much more. The aim of this project is do demonstrate KMM development capabilities.

You can Install and test latest android app from below 👇

TvManiac Debug

🚧 Under Heavy Development 🚧

This is my playground for learning Kotlin Multiplatform. With that said, I'm sure it's filled bugs are crawling everywhere, and I'm probably doing a couple of things wrong. So a lot is changing, but that shouldn't stop you from checking it out.

Android Screenshots

Home Screen Light

Home Screen Light

Episodes List Light

Show Details Dark

Show Details Dark

Episodes List Dark

🔆 iOS Screenshots

Home Screen Light

Home Screen Light

Home Screen Dark

Show Details Dark

🖥 Project Setup & Environment

API Keys

To use the Trakt API, you'll need to create a new API app. & for TMDb create an account and generate an API key if you don't have one.

Shared/Android Api Keys

You need to add API keys from Trakt.tv & TMDb. To do so:

  • Add the following keys to ~/.gradle/gradle.properties:

    TMDB_API_URL=https://api.themoviedb.org/3/
    TMDB_API_KEY=ENTER_URI
    TRAKT_CLIENT_ID=ENTER_KEY
    TRAKT_CLIENT_SECRET=ENTER_KEY
    TRAKT_REDIRECT_URI=ENTER_KEY
    
  • Run ./gradlew generateBuildKonfig

iOS Trakt Config Keys

Open config.json in the iOS project root directory and enter the correct values that your generated for your Trakt Applicaton.:

  • callbackURL
  • clientId
  • clientSecret

▶️ Building/Opening The Project

Android Requirements

Opening iOS Project

  • Navigate to ios directory & open .xcworkspace & not .xcodeproj

Genereating Swift Package Locally

In case you make changes to the shared module and want to test out the changes, you can generate the swift package locally by:

  1. Execute ./gradle createSwiftPackage. This will generate a swift package outside the root directory.
  2. Add the generated package in XCode.

Android Demo

screen-20230308-001558.mp4

Libraries Used

Android

Kmp - Common

iOS

Roadmap

Android

  • Implement Watchlist
  • Add More screen. Shows GridView
  • Recommended Shows
  • Implement pagination.
  • Add Settings panel.
    • Dynamic theme change.
  • Add Seasons UI
  • Implement trakt auth & sign in
  • Migrate to Material3
  • Add Episode detail screen
  • Add Watchlist
  • Implement Search

iOS

  • Add HomeScreen: Tabs & Empty UI
  • Implement Discover UI
  • Show Detail Screen
  • Add Settings panel.
  • Implement trakt auth & sign in
  • Add Seasons UI
  • Implement Search UI
  • Implement Watchlist UI
  • Implement Load more

Shared

  • Use SQLDelight extensions to consume queries as Flow
  • Refactor interactor implementation.
  • Use koin for injection
  • Modularize shared module
  • Try out Flow-Redux
  • Improve error handling, add retry.
  • Add test cases.
  • Fix paging
  • Observe Internet connection
    • Android
    • iOS

References

License

Copyright 2021 Thomas Kioko

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.