Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

MMM-UpcomingMovies

A MagicMirror² module that displays upcoming movies using The Movie Database (TMDb) API. It cycles through posters, titles, release dates, and overviews in a slideshow-style interface.


Screenshot

Movie Demo


Features

  • Fetches upcoming movies from TMDb.
  • Displays poster, title, release date, and short overview.
  • Automatic slideshow rotation between movies.
  • Configurable region, update frequency, and slideshow speed.
  • Smooth fade and slide animations.

Installation

  1. Navigate to your MagicMirror modules folder:
    cd ~/MagicMirror/modules
  2. Clone this repository:
    git clone https://github.com/PakshalGada/MMM-UpcomingMovies.git
  3. Install dependencies (if any are listed in package.json):
    cd MMM-UpcomingMovies
    npm install
  4. Get a free API key from The Movie Database.

Configuration

Add the module to your MagicMirror config.js:

{
  module: "MMM-UpcomingMovies",
  position: "middle_center",   // or any region
  config: {
    apiKey: "YOUR_TMDB_API_KEY",   // Required
    region: "US",                  // Optional: default 'US'
    maxResults: 10,                 // Number of movies to show
    updateInterval: 1000 * 60 * 60, // Refresh every 1 hour
    rotateInterval: 15000           // Switch movie every 15s
  }
}

Options

Option Type Default Description
apiKey String null Required. Your TMDb API key.
region String "US" Region code (ISO 3166-1). Determines which country’s upcoming movies to fetch.
maxResults Number 10 Max number of movies to keep in rotation.
updateInterval Number 1000*60*60 (1 hr) Time (ms) between API fetches.
rotateInterval Number 15000 (15 sec) Time (ms) before rotating to the next movie.

Styling

This module comes with a CSS file (MMM-UpcomingMovies.css):

  • Movie posters have a shadow and hover zoom effect.
  • Text is centered with clean spacing.
  • Fade-in and slide-in animations for smooth transitions.

You can override styles in your global custom.css.


Notes

  • Requires an active internet connection to fetch data.
  • If apiKey is missing or invalid, the module will show an error in logs and display no movies.
  • If no results are found, you’ll see “No upcoming movies found.” on screen.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages