TV Randshow - App to choose a random TV show episode

About the project

TV Randshow was created to help choose a random episode from your favorites TV shows. The TV shows database comes from the TMDB and the app saves them in a database on the device. With the list of favorites, you can roll the dice of a TV show to get a random episode.

This project has been built using the Flutter framework, which allows to build an multiplatform app from a single codebase.

Features

• Save your favorites TV shows with available streamings links
• Choose a random episode from a single TV show
• Choose a random episode from all saved TV shows
• Choose a random TV show from trending TMDB
• Support to Android and Web
• Export saved TV shows to json
• Dark mode
• Material Design 3

Build and run

Requirements

1. Clone repository with 'git clone' command or just download the zip. git clone git@github.com:deandreamatias/tv-randshow.git
2. Prepare your develop enviroment
   1. Flutter (see version in .fvmrc). Use FVM 3.0 to install Flutter versions
   2. When build to iOS, follow this steps
   3. When build to Android, follow this steps
3. Install dependencies and generate code
   1. Only use sh tool/setup.sh
   2. If don't have just, can do manual proccess
      1. Run flutter pub get from the project root (see using packages documentation for details and how to do this in the editor).
      2. Run flutter pub run build_runner build
4. Get your own API keys
   1. Get your API Key from TMDB (see this FAQ for more details).
   2. Get your API Key from Streaming Availabilty (on RapidApi)
   3. Paste your API keys values in .env/dev.json or .env/prod.json files. Take .env/dev.example.json like example.
5. (Optional) If you want build to web, do you need follow this steps

Run

Run sh tool/run.sh dev command or copy the command from tool/run.sh.

Tests

• Integration tests (only mobile): run sh tool/integration-test.sh command or copy the command from tool/integration-test.sh.
• Unit tests: run sh tool/unit-test.sh unit command or copy the command from tool/unit-test.sh.

Build

• Android APK: Run sh tool/build-android.sh apk command or copy the command from tool/build-android.sh.

Author

• Matias de Andrea - Mobile developer: Website

Contributing

If you want to take the time to make this project better, please read the contributing guides first. Then, you can open an new issue, of a pull request.

Powered by

TV information and images are provided by TMDb, but we are not endorsed or certified by TMDb.com or its affiliates.