Table of Contents

TV Show Finder 📺

Name: Moroiu Alexandra-Maria
Group: SSA1-C
Github repo: Project link

Introduction

A simple and intuitive Android application built with Jetpack Compose that helps users discover TV shows. The app uses the TV Maze API to fetch show information and provides a clean interface for browsing shows and their details.

Main Features

  1. Search for TV shows by name
  2. View detailed show information including:
    • Show image and title
    • Summary
    • List of episodes organized by season
  3. Dark/Light theme support

TV Maze API Endpoints

GET https://api.tvmaze.com/search/shows?q={query}
→ Search for TV shows by name. Returns matching show results.

GET https://api.tvmaze.com/shows/{id}
→ Get detailed information about a specific show.

GET https://api.tvmaze.com/shows/{id}/episodes
→ Get all episodes for a show, grouped by season.

How to Use

  1. Home Screen
    • The app starts with a welcome screen
  2. Search Screen
    • Enter a show name in the search bar
    • Results appear as you type
    • Each result displays the show's image and title
    • Tap on a show to view its details
  3. Details Screen
    • View the show's full information
    • Browse episodes by season using the tab row
    • Each episode shows:
      • Episode number and title
      • Summary
  4. Settings Screen
    • Toggle between light and dark theme

Architecture

The app follows the MVVM (Model-View-ViewModel) architecture pattern:

The app also uses a manual dependency injection approach with an Application Container to manage dependencies.

Resources