LocalMovies

This repository is a Spring Boot video streaming service for my media collection.

Demo

You can view a brief demo of this project here.

User Interface

• Android Application
• ReactJS web application (located in the src/main/js directory).

APIs

This service exposes a set of endpoints that facilitate:

• Loading media at a given path ('/Movies', '/Series', etc).
• Streaming a media file.
• Loading media events (for persistent Android clients).

Media Management

When the service starts, configured directories are recursively scanned to locate media. Based on a naming convention, each file/folder is checked against the database. If any metadata is missing, it is downloaded from OMDB and stored. The directory naming convention is as follows:

• root-directory/Movies/The Matrix.mp4
• root-directory/Series/The Office/Season 1/S01E01.mp4

When new media is added to a monitored directory, the following process is triggered:

• Media is converted to H.264/AAC format (if necessary).
• Media metadata is downloaded from OMDB and stored in database.
• 'New Media' event is added to database for processing by Android clients.
• Push notifications are sent to Android devices to notify of new media.

Tech Stack

• Spring Boot
• Apache Camel
• Maven
• Postgresql
• Hashicorp Vault
• Keycloak

Monitoring

• Grafana
• Prometheus

CI/CD

• Kubernetes
• Jenkins
• Helm (chart located in helm/localmovies directory)

System Diagram