Skip to content

lui5fl/movies-and-tv-shows

Repository files navigation

Movies And TV Shows

Movies And TV Shows1 is a movie and TV show tracking app for iPhone. Add movies and TV shows to your backlog and mark them as "watching" or watched later on: it's as simple as it gets! The app is built using UIKit with some SwiftUI sprinkled here and there.

video.mp4

Motivation

I was on the lookout for a movie and TV show tracking app but the ones I tried were either too complicated or had a user interface that I didn't like, so I set out to build my own following the next three principles:

  • Flexibility: allow the user to export all data if they want to
  • Simplicity: no menu diving, just long-press an item to move it from one list to another
  • Strikingness: give the gorgeous movie and TV show posters the screen real estate they deserve

Installation

An API key is required to retrieve movie and TV show metadata from TMDB. Read the TMDB API documentation for more information on how to apply for one.

Once you've got an API key, you must create a Key.plist file inside the Resources folder of the Xcode project. This property list must have a TMDB_API_KEY property with your API key as its value.

Technologies

Apple

  • Combine
  • Core Data
  • SwiftUI
  • UIKit

Third-party

Architecture

The app follows the MVVM and Coordinator architectural patterns. The SceneCoordinator class is responsible for directing the scene's behaviour and flow, initializing the views and its view models. The view models' properties are bound to the views using Combine.

Roadmap

Attribution

All movie and TV show metadata used in this application is supplied by The Movie Database (TMDB). This application uses the TMDB API but is not endorsed or certified by TMDB.

License

Released under GPL-3.0 license. See LICENSE for details.

Footnotes

  1. Still got to think of a proper name...