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.
- 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
- Support to deeplink
- Roadmap in public Trello
Build and run
- Clone repository with 'git clone' command or just download the zip.
git clone [email protected]:deandreamatias/tv-randshow.git
- Prepare your develop enviroment
- Install dependencies and generate code
- Only use
- If don't have just, can do manual proccess
flutter pub getfrom the project root (see using packages documentation for details and how to do this in the editor).
flutter pub run build_runner build
- Only use
- Get your API Key from TMDB (see this FAQ for more details) and paste in file
- Get your APi Key from Streaming Availabilty (on RapidApi) and paste in file
- (Optional) If you want build to web, do you need follow this steps
just run dev DEVICE_ID TMDB_API_KEY STREAMING_API_KEY command or copy the command from
- Integration tests (only mobile): run
just integration-test TMDB_API_KEY STREAMING_API_KEY DEVICE_IDcommand or copy the command from
- Unit tests: run
just unit-test TMDB_API_KEY STREAMING_API_KEYcommand or copy the command from
- Android APK: Run
just run prod TMDB_API_KEY STREAMING_API_KEYcommand or copy the command from `./justfile
Replace screaming snake case with your values
This project is licensed under the GNU GPL v3 License - see the LICENSE file for details.
TV information and images are provided by TMDb, but we are not endorsed or certified by TMDb.com or its affiliates.