Movie Collection Visualizer

A modern Tauri-based application to visualize and manage your movie collection. This project allows users to index movie files from their local directories, fetch high-quality metadata from the OMDb API, and manage their collection with a premium, card-based interface.

Features

• Local Directory Indexing: Automatically scan and watch folders for movie files.
• Automated Metadata Fetching: Retrieve posters, ratings, and plot summaries via OMDb API.
• Modern UI: Clean, card-based interface using Vue 3 and CSS.
• Smart Title Parsing: Advanced filename parsing to identify movie titles and years accurately.
• Offline Capability: Indexed data and posters are stored locally for fast, offline access.
• Collection Management: Search, filter, and manually update movie information.
• Privacy Focused: No data leaves your machine except for API metadata requests.

Table of Contents

• Getting Started
  • Prerequisites
  • Installation
• Usage
  • OMDb API Configuration
  • Setting up Library
• Development
  • Running Locally
  • Building the Application
• Project Architecture
• Contributing
• Attribution
• License

Getting Started

Prerequisites

• Node.js (Latest LTS recommended)
• Rust and Cargo (For Tauri backend)
• System dependencies for Tauri (Refer to the Tauri Setup Guide)

Installation

1. Clone the repository:

   git clone https://github.com/ISO53/Movie-Collection-Visualizer.git

2. Navigate to the project directory:

   cd Movie-Collection-Visualizer

3. Install dependencies:

   npm install

Usage

OMDb API Configuration

A valid OMDb API key is required to fetch movie information. You can obtain a free or supporter key from the OMDb API website. Once obtained, enter it in the Settings panel within the application.

Setting up Library

1. Open the Settings panel.
2. Select a "Collection Directory" where your movie files are located.
3. The application will automatically begin parsing filenames and syncing metadata.

Development

Running Locally

To start the application in development mode with hot-reloading:

npm run tauri dev

Building the Application

To generate a production installer for your current platform:

npm run tauri:build

Project Architecture

• Frontend: Vue 3, Pinia (State Management), Vue Router.
• Backend: Rust (Tauri), SQLite (Local Database).
• Styling: Vanilla CSS with modern cards and glassmorphism effects.
• Icons: Lucide Vue Next.

Contributing

Contributions are welcome. Please review the Contributing Guidelines before opening a pull request or issue.

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.

---