Skip to content

ISO53/Movie-Collection-Visualizer

Movie Collection Visualizer

GitHub Release License GitHub code size in bytes

An Electron-based application to visualize and manage your movie collection. This project allows users to import movie information from the file explorer or a TXT file, fetch details from the OMDB API, and view and manage their movie collection with a user-friendly interface. Check out the website!

App GUI

Features

  • Import movies from the file explorer or a TXT file.
  • Fetch movie details from the OMDB API.
  • View and manage your movie collection.
  • Interactive filtering based on movie genres.
  • Movie searching with movie names, genres, actor names etc.
  • Simple and intuitive user interface.
  • View additional movie informations by clicking on movie poster.

Table of Contents

Getting Started

Prerequisites

Make sure you have Node.js installed on your machine.

Installation

  1. Clone the repository:
    git clone https://github.com/ISO53/Movie-Collection-Visualizer.git
  2. Locate the project directory
    cd Movie-Collection-Visualizer
  3. Install dependencies
    npm install
    

Usage

OMDB API Key

You must have an OMDB API key to use this program. You can get it from omdbapi for free! Then set your OMDB API key by clicking on "OMDB Api" in the Settings menu.

Importing Movies

Click on "Import Movies" in the File menu to import movies from the file system or a TXT file.

Managing Movies

Use the interface to view and manage your movie collection. You can delete movies or update details if needed.

Development

Running Locally

npm start

This will launch the Electron application.

Building the Application

npm run dist

This will create a build of the application for your platform.

Contributing

Your contributions are valued! Before opening an issue, please review our guideline on how to contribute. We appreciate your cooperation in making our project better.

Attribution

Movie data provided by OMDb API. This data is licensed under CC BY-NC 4.0 DEED.

License

This project is licensed under the GNU General Public License v3.0. Feel free to modify the content and structure based on your preferences and project specifics.

Follow me on GitHub