Install the NFLMetaCities Plex Agent

1) NFLMeta API Key

Request a key from the NFLMeta admin. This key is required for metadata lookups.

2) Plex Token

Find your Plex token in the Plex server preferences file.

Windows: %LOCALAPPDATA%\Plex Media Server\Preferences.xml
macOS: ~/Library/Application Support/Plex Media Server/Preferences.xml
Linux: /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Preferences.xml
Unraid: /mnt/user/appdata/plex/Library/Application Support/Plex Media Server/Preferences.xml
Synology: /volume1/Plex/Library/Application Support/Plex Media Server/Preferences.xml
QNAP: /share/CACHEDEV1_DATA/PlexMediaServer/Library/Application Support/Plex Media Server/Preferences.xml
TrueNAS: /mnt//PlexMediaServer/Library/Application Support/Plex Media Server/Preferences.xml

Search for PlexOnlineToken= in that file.

Tokens can rotate after re-login, app re-authorization, or server updates. If metadata stops refreshing, grab the latest token and retest.

Windows (common)

%LOCALAPPDATA%\Plex Media Server\Scanners\Series\NFLMetaCities.py
%LOCALAPPDATA%\Plex Media Server\Plug-ins\NFLMetaCities.bundle

Unraid

/mnt/user/appdata/plex/Library/Application Support/Plex Media Server/Scanners/Series/NFLMetaCities.py
/mnt/user/appdata/plex/Library/Application Support/Plex Media Server/Plug-ins/NFLMetaCities.bundle

Linux / macOS / Windows

.../Plex Media Server/Scanners/Series/NFLMetaCities.py
.../Plex Media Server/Plug-ins/NFLMetaCities.bundle

The base folder is the same as your Preferences.xml path.

Windows (PowerShell)

$pref = "$env:LOCALAPPDATA\Plex Media Server\Preferences.xml"
$envFile = "$env:LOCALAPPDATA\Plex Media Server\nflmeta.env"
$token = (Select-String -Path $pref -Pattern 'PlexOnlineToken="([^"]+)"').Matches[0].Groups[1].Value
if (Test-Path $envFile) {
  $content = Get-Content $envFile
  if ($content -match '^PLEX_TOKEN=') { $content = $content -replace '^PLEX_TOKEN=.*', "PLEX_TOKEN=$token" }
  else { $content += "PLEX_TOKEN=$token" }
  $content | Set-Content $envFile
} else {
  "PLEX_TOKEN=$token" | Set-Content $envFile
}

macOS

PREF="$HOME/Library/Application Support/Plex Media Server/Preferences.xml"
ENV_FILE="$HOME/Library/Application Support/Plex Media Server/nflmeta.env"
TOKEN="$(awk -F'"' '/PlexOnlineToken=/{print $2}' "$PREF")"
if [ -f "$ENV_FILE" ] && grep -q '^PLEX_TOKEN=' "$ENV_FILE"; then
  sed -i '' "s/^PLEX_TOKEN=.*/PLEX_TOKEN=$TOKEN/" "$ENV_FILE"
else
  printf '\nPLEX_TOKEN=%s\n' "$TOKEN" >> "$ENV_FILE"
fi

Linux / Unraid / NAS

PREF="/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Preferences.xml"
ENV_FILE="/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/nflmeta.env"
TOKEN="$(awk -F'"' '/PlexOnlineToken=/{print $2}' "$PREF")"
if [ -f "$ENV_FILE" ] && grep -q '^PLEX_TOKEN=' "$ENV_FILE"; then
  sed -i "s/^PLEX_TOKEN=.*/PLEX_TOKEN=$TOKEN/" "$ENV_FILE"
else
  printf '\nPLEX_TOKEN=%s\n' "$TOKEN" >> "$ENV_FILE"
fi

For Unraid, use /mnt/user/appdata/plex instead of /var/lib/plexmediaserver.

Docker

PREF="/config/Library/Application Support/Plex Media Server/Preferences.xml"
ENV_FILE="/config/nflmeta.env"
TOKEN="$(awk -F'"' '/PlexOnlineToken=/{print $2}' "$PREF")"
if [ -f "$ENV_FILE" ] && grep -q '^PLEX_TOKEN=' "$ENV_FILE"; then
  sed -i "s/^PLEX_TOKEN=.*/PLEX_TOKEN=$TOKEN/" "$ENV_FILE"
else
  printf '\nPLEX_TOKEN=%s\n' "$TOKEN" >> "$ENV_FILE"
fi