Emby Merge Versions

Introduction

The Emby Webhook Automation is a Python script that serves as a webhook listener for the Emby media server. It's designed to automate the merging of movies in your Emby library based on Tmdb ID received through webhooks.

Features

• Automatically merge two movies in the Emby library based on matching Tmdb ID.
• Logs the merge results, including successful and unsuccessful merges.
• Supports an ignore list to exclude specific libraries from the merge process.

Prerequisites

Before using this script, ensure you have the following:

• Python 3.12 installed
• Required Python libraries: Flask, requests
• Docker (optional, for Docker installation)

Installation

Traditional Installation

1. Clone the repository.
2. Install the requirements using pip install -r requirements.txt.
3. Set up your configuration variables directly in the Python file or pass them as environment variables when running the script.
4. Run the application using python3 main.py.

Docker Installation

If you have Docker and Docker Compose installed, you can use the provided docker-compose.yml file.

To run the application: docker-compose up

Usage

Setting up Emby Webhook

For Emby Server 4.7 or Lower:

1. Go to Emby settings.
2. Choose Webhook and add a new webhook.
3. Set the server to the Flask application's endpoint (e.g., http://192.168.1.1:5000/emby-webhook).
4. Under Library, select New Media Added.

For Emby Server 4.8 or Higher:

1. Go to Emby settings.
2. Choose Notification and add a new notification.
3. Select Webhooks as the notification type.
4. Set the server to the Flask application's endpoint (e.g., http://192.168.1.5:5000/emby-webhook).
5. You can set Request content type to either multipart/form-data or application/json.
6. Under Library, select New Media Added.

Configuring the Ignore Library Feature

To exclude specific movie libraries from the merge process, use the IGNORE_LIBRARY variable in the docker-compose.yml file. This is particularly useful if you have separate libraries for different types of content that you do not wish to merge.

For example, to ignore libraries named "trending" and "other_library": IGNORE_LIBRARY="trending,other_library"

If your library path is /data/media/trending, set: IGNORE_LIBRARY="trending"

Configuring the Merge on Start Feature

To automatically merge all movies at startup, set the MERGE_ON_START variable in the docker-compose.yml file to yes. After the initial merge has completed, you can set it back to no to prevent unnecessary merges on subsequent restarts.

For example:

environment:

• MERGE_ON_START=yes

Once done, you can revert it:

environment:

• MERGE_ON_START=no

Logs

Logs are stored in the directory you mapped in the docker-compose.yml. In the example above, logs will be stored at: /mnt/cache/appdata/merge-versions/logs

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests for new features, bug fixes, or improvements.

License

This project is licensed under the MIT License. See the LICENSE file for details.