Script to assist in grabbing the GUID for use in PlexAniSync, specifically, for contribution to the custom mappings project.
Also check out PlexAniSync-Mapping-Assistant to help you map shows for the custom mappings project.

Table of Contents

• Features
• Installation
• Configuration
• Usage
• Repositories
• Issues
• Credits
• License

Features

• Copy Plex GUID: Easily copy the GUID of Plex entries for use in other applications.
• Open External Links: Quickly open related entries on IMDb, TMDB, TVDB, MusicBrainz, AniDB, and YouTube.
• User-Friendly Interface: Buttons are added directly to the Plex interface for easy access.
• Compatibility: Works with movies, shows, episodes, albums, and artists.

Installation

1. Install a Userscript manager like Violentmonkey or Tampermonkey.
2. Click on the following link to install the script: Plex GUID Grabber.

Configuration

To customize the script's behavior, you can modify these settings in your userscript manager:

1. Open your userscript manager:
   • For Violentmonkey: Click the extension icon → Manage → Find "Plex GUID Grabber" → Settings → Values
   • For Tampermonkey: Click the extension icon → Dashboard → Find "Plex GUID Grabber" → Edit → Storage
2. Available settings:
   • SOCIAL_BUTTON_SEPARATION: Set to true (default) to separate social media buttons to the left side, or false to keep all buttons on the right
   • USE_SOCIAL_BUTTONS: Set to true (default) to show social media buttons (IMDb, TMDB, etc.), or false to only show the GUID button
   • USE_PAS: Set to true to enable PlexAniSync support
   • TMDB_API_READ_ACCESS_TOKEN: Your TMDB Read Access Token
   • TMDB_LANGUAGE: Set the language for TMDB API requests, default is en-US
   • TVDB_API_KEY: Your TVDB V4 API key
   • TVDB_SUBSCRIBER_PIN: Your TVDB Subscriber PIN
   • TVDB_LANGUAGE: Set the language for TVDB API requests, default is eng

PlexAniSync Support

The script includes support for generating YAML mappings for PlexAniSync. To enable this feature, ensure the following settings are configured:

• USE_PAS: Set to true to enable PlexAniSync support
• TMDB_API_READ_ACCESS_TOKEN: Your TMDB Read Access Token
  • Find your "Read Access Token" here: TMDB API Settings
• TVDB_API_KEY: Your TVDB V4 API key
  • Get your API key here: TVDB Dashboard
  • Or here: TVDB API Information
• TVDB_SUBSCRIBER_PIN (optional): Your TVDB Subscriber PIN
  • Find your Subscriber PIN in your TVDB account settings: TVDB Subscription

Refresh your Plex page to see the new YAML copy buttons. Once enabled, you'll see additional buttons for copying TMDB and TVDB YAML mappings directly to your clipboard, ready to use with PlexAniSync.

Usage

Once installed, the script will add buttons to the top-right of your screen inside movies/series. If it doesn't, check that the URL matches what this script uses.

Repositories

Issues

If you have any issues, please open a new issue in the Issues section of the GitHub repository.

Credits

Thank you to all the people who have contributed!

License

Copyright © 2025 Soitora
This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/.