"Recently-added" episode №X of Y(episodes in season)

[MAPTblHOB]

Hello, @smtdev !
Is it possible somehow to add in Telegram notification the number of final episode in season?

E.g.:
A new episode of {show_name} has been added!
Season {season_num}, Episode {episode_num00} of {last_episode_num00} - "{episode_name}".

It could be looks like:
A new episode of SHOW has been added!
Season 3, Episode 6 of 10 - "Last hope".

Or Plex does not providing such "meta"?

[smtdev]

Hey @MAPTblHOB ,

Short answer: Plex/Tautulli don’t expose a “total episodes in season” token in notification templates, so {last_episode_num00} isn’t available.
Good news: you can achieve “Episode 6 of 10” via a Script notification agent that looks up the season in Plex and reads its leafCount attribute.

I’ve been testing some scripts, and it works as expected with Telegram.

How to set it up

1. Tautulli → Settings → Notification Agents → Add → Script

2. Trigger: "Recently Added", in your case

3. Script arguments (exactly in this order):

   <episode>{show_name} {season_num} {episode_num00} {episode_name} {parent_rating_key}</episode>
   

   parent_rating_key is the Plex season ID; we’ll use it to fetch the total episode count.

4. Use this Python script (adjust PLEX_URL, PLEX_TOKEN, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID with your own info).

#!/usr/bin/env python3
import sys, requests, html

# ======= CONFIG =======
PLEX_URL = "http://YOUR_PLEX_IP:32400"
PLEX_TOKEN = "YOUR_PLEX_TOKEN"
TELEGRAM_BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
TELEGRAM_CHAT_ID = "YOUR_CHAT_ID"
# ======================

def get_leaf_count_for_season(parent_rating_key: str) -> int:
    url = f"{PLEX_URL}/library/metadata/{parent_rating_key}/children"
    params = {"X-Plex-Token": PLEX_TOKEN}
    r = requests.get(url, params=params, timeout=10)
    r.raise_for_status()
    return r.text.count("<Video ")

def send_telegram(text: str):
    api = f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage"
    payload = {
        "chat_id": TELEGRAM_CHAT_ID,
        "text": text,
        "parse_mode": "HTML",
        "disable_web_page_preview": True,
    }
    r = requests.post(api, data=payload, timeout=10)
    r.raise_for_status()

def main():
    if len(sys.argv) < 6:
        # show_name season_num episode_num00 episode_name parent_rating_key
        sys.exit(0)

    show_name        = sys.argv[1]
    season_num       = sys.argv[2]
    episode_num00    = sys.argv[3]
    episode_name     = sys.argv[4]
    parent_rating_key= sys.argv[5]

    try:
        total_eps = get_leaf_count_for_season(parent_rating_key)
    except Exception as e:
        total_eps = None

    # Scape special characters
    show_name_e   = html.escape(show_name)
    episode_name_e= html.escape(episode_name)

    if total_eps:
        text = (f"A new episode of <b>{show_name_e}</b> has been added!\n"
                f"Season {season_num}, Episode {episode_num00} of {total_eps} — “{episode_name_e}”.")
    else:
        # Fallback
        text = (f"A new episode of <b>{show_name_e}</b> has been added!\n"
                f"Season {season_num}, Episode {episode_num00} — “{episode_name_e}”.")

    send_telegram(text)

if __name__ == "__main__":
    main()       

Notes

• PLEX_TOKEN can be obtained from the PlexOnlineToken attribute in the Preferences.xml Plex file, which is located in /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Preferences.xml.

Output screenshot from Telegram:

[MAPTblHOB]

Hey, @smtdev ,

Thanks a lot for your answer!

I've modifided a bit your script to fit my needs in notifications format:

#!/usr/bin/env python3
import sys, requests, html

# ======= CONFIG =======
PLEX_URL = "****"
PLEX_TOKEN = "****"
TELEGRAM_BOT_TOKEN = "****"
TELEGRAM_GROUP_ID = "****"
# ======================

def get_leaf_count_for_season(parent_rating_key: str) -> int:
    url = f"{PLEX_URL}/library/metadata/{parent_rating_key}/children"
    params = {"X-Plex-Token": PLEX_TOKEN}
    r = requests.get(url, params=params, timeout=10)
    r.raise_for_status()
    return r.text.count("<Video ")

def send_telegram(text: str):
    api = f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage"
    payload = {
        "chat_id": TELEGRAM_GROUP_ID,
        "text": text,
        "parse_mode": "HTML",
        "disable_web_page_preview": True,
    }
    r = requests.post(api, data=payload, timeout=10)
    r.raise_for_status()

def main():
    if len(sys.argv) < 10:
        # args used in notification
        sys.exit(0)

    show_name        = sys.argv[1]
    season_num       = sys.argv[2]
    episode_num00    = sys.argv[3]
    episode_name     = sys.argv[4]
    parent_rating_key= sys.argv[5]
    show_year        = sys.argv[6]
    duration         = sys.argv[7]
    video_resolution = sys.argv[8]
    plex_url         = sys.argv[9]

    try:
        total_eps = get_leaf_count_for_season(parent_rating_key)
    except Exception as e:
        total_eps = None

    # Scape special characters
    show_name_e   = html.escape(show_name)
    episode_name_e= html.escape(episode_name)

    if total_eps:
        text = (f"<b>New episode</b>\n"
                f"📺 <b>{show_name_e} ({show_year})</b>\n"
                f"\n"
                f'🔢 Season {season_num}, <a href="{plex_url}">Episode {episode_num00}</a> of {total_eps}\n'
                f'"{episode_name_e}"\n'
                f"\n"
                f"🕓 {duration} min.\n"
                f"⚙️ {video_resolution}")
    else:
        # Fallback
        text = (f"<b>New episode</b>\n"
                f"📺 <b>{show_name_e} ({show_year})</b>\n"
                f"\n"
                f'🔢 Season {season_num}, <a href="{plex_url}">Episode {episode_num00}</a>\n'
                f'"{episode_name_e}"\n'
                f"\n"
                f"🕓 {duration} min.\n"
                f"⚙️ {video_resolution}")

    send_telegram(text)

if __name__ == "__main__":
    main()

So, "Test test" with args:
"Game ot thrones" "2" "2" "Pilot" "12345" "2019" "138" "1080" "https://l.plex.tv/rnDLLmbz"
returns notification with "Fallback" result from script.

"Production test" with args:
<episode>{show_name} {season_num} {episode_num00} {episode_name} {parent_rating_key} {show_year} {duration} {video_resolution} {plex_url}</episode>
returns notification without {total_eps} and {episode_num00} zero-padded for some reason...

Can you give me an advice how to put Poster of Season in the begining of notification and make {episode_num00} non-zero-padded to acheave same result like in Tautulli Telegram notification?
E.g.: