Classic Template

Modern Template

Screenshots captured using the Element Matrix client.

Server URL

• The server url of your jellyfin. This will be used for direct link in discord webhook.

Community Rating Decimal Places

• Configure the number of decimal places to display for community ratings in newsletters (0-4 places, default: 1)

Poster Type

• TMDB Poster - Uses image URLs from TheMovieDB (default, smallest emails).
• Local Poster Images - Embeds local poster images directly in the email/discord embed (larger messages).

Radarr / Sonarr Configuration

You can configure multiple Radarr and Sonarr instances. Each instance has its own URL, API key, and instance name. The plugin uses these to fetch upcoming media via the Radarr/Sonarr calendar APIs.

Instance Name

• A name for this Radarr/Sonarr instance. This name appears as the section header in the upcoming media portion of your newsletter.

URL

• The base URL of your Radarr/Sonarr instance (e.g., http://localhost:7878 for Radarr, http://localhost:8989 for Sonarr).

API Key

• The API key for your Radarr/Sonarr instance. Found under Settings → General → API Key in the respective application.

Test Connection

• Use the "Test" button to verify connectivity to your Radarr/Sonarr instance before saving.

Upcoming Days Ahead

• Configure how many days ahead to look for upcoming content (default: 7 days). This is a global setting shared across all Radarr/Sonarr instances.

The "Preview" tab shows everything currently queued for the next newsletter, so you can review and curate it before it is sent.

• Entries are grouped by event section (Added, Updated, Removed) and, within each section, by library. Series entries are summarised by season/episode.
• Removing an entry excludes it from every client. Excluded entries stay listed and can be restored at any time until the newsletter is sent.
• Changes take effect immediately — you do not need to press Save.
• Upcoming items from Radarr/Sonarr are fetched live when the newsletter is built, so they are not listed here.
• Use the "Refresh" button to reload the queue.

The "Featured" tab lets you pin hand-picked titles to the top of the next newsletter.

• Anything in your library can be featured, whether or not it was added recently. Featured items are read live from the library when the newsletter is built, so they do not depend on the queue.
• All featured titles appear under a single "Featured" section that spans every library, pinned above the other sections.
• The featured list is cleared once a newsletter is sent, so each issue is curated deliberately.
• Each client has its own Featured event toggle (default: enabled), so you can include the section for some clients and not others.

Featured Emoji

• The emoji shown beside the "Featured" heading (default: ⭐). Available in the header template as the {FeaturedEmoji} placeholder.

Add a title

• Search your Jellyfin library and click a result to pin it. Pinned titles are listed below the search box and can be reordered by removing and re-adding, or removed with the "Remove" button.
• Press Save to store the featured list.

You can configure Multiple Email Clients. Each client instance has its own SMTP settings, recipients, library selection, event triggers, template settings, and an enable/disable toggle.

To Addresses:

• Recipients of the newsletter. Add as many emails as you'd like, separated by commas.
  • All emails will be sent out via BCC

From Address

• The address recipients will see on emails as the sender
  • Defaults to JellyfinNewsletter@donotreply.com

Subject

• The subject of the email

Newsletter Title

• The heading shown at the top of the newsletter body
  • Defaults to Jellyfin Newsletter
  • Also available as the {NewsletterTitle} tag in the Body HTML

Smtp Server Address

• The email server address you want to use.
  • Defaults to smtp.gmail.com

Smtp Port

• The port number used by the email server above
  • Defaults to gmail's port (587)

Enable SSL

• Toggle SSL/TLS encryption for the SMTP connection (default: enabled). Disable this if your SMTP server does not support or require SSL.

Smtp Username

• Your username/email to authenticate to the SMTP server above

Smtp Password

• Your password to authenticate to the SMTP server above
  • I'm not sure about other email servers, but Google requires a Dev password to be created.
    • For gmail specific instructions, you can visit https://support.google.com/mail/answer/185833?hl=en for details

Library Selection

• Choose specific libraries within each item type (Movies/Series) to include in newsletters for this email client.

Newsletter Event Settings

• Configure which library events (Add/Update/Delete/Upcoming/Featured) should trigger the newsletters for this email client:
  • Add: Enable newly added items section in the newsletter (default: enabled).
  • Update: Enable updated items section in the newsletter. Updates are detected when media files are upgraded (e.g., by tools like Radarr/Sonarr), where the old file is deleted and a new one is added with the same title/season/episode information (default: disabled).
  • Delete: Enable deleted items section in the newsletter (default: enabled).
  • Upcoming: Enable upcoming media section in the newsletter, sourced from Radarr/Sonarr (default: disabled).
  • Featured: Enable the Featured section, pinned to the top of the newsletter and populated from the Featured tab (default: enabled).

Max Items Per Section

• Limit how many items are shown in each section of the newsletter (for example, "Added to Movies"). Items beyond the limit are left out of the newsletter entirely (they are not sent, just skipped), and a small "…" note is shown at the end of the section. Set to 0 to show all items (default).

Newsletter Template Category

You can select between different email templates:

• Modern: A sleek, card-based design. Fully compatible for mobile view.
• Classic: A more traditional list-based layout.

Body HTML

• Define custom HTML structure for the main email body. If left empty, the default HTML from the selected Newsletter Template Category will be used.

EntryData HTML

• Define custom HTML formatting for each individual media item (Movies/Series) in the newsletter. If left empty, the default HTML from the selected Newsletter Template Category will be used.

Header HTML

• Define custom HTML for section headers (e.g., "Added to Movies", "Removed from Series"). The template uses <template> tags with IDs to define all event-type headers in a single file:
  • <template id="header-featured"> - Header for the Featured section
  • <template id="header-add"> - Header for newly added items
  • <template id="header-update"> - Header for updated items
  • <template id="header-delete"> - Header for deleted items
  • <template id="header-upcoming"> - Header for upcoming items
• Placeholders:
  • {LibraryName} - replaced with the library name (e.g., "Movies", "TV Shows")
  • {FeaturedEmoji} - replaced with the emoji configured on the Featured tab (only used in header-featured)
• If a custom Header HTML was saved before the Featured section existed and has no header-featured template, the Featured section is skipped for that client and a warning is logged.
• If left empty, the default header template from the selected Newsletter Template Category will be used.

You can now configure Multiple Discord Clients. Each client instance can have its own Webhook URL(s), library selection, event triggers, and an enable/disable toggle.

Webhook URL

• Your discord webhook url. Supports multiple webhooks: You can enter multiple webhook URLs separated by commas , to send the same notification to multiple channels.

Webhook Name

• Name for your discord webhook, defaults to "Jellyfin Newsletter"

Mentions

• Who to ping when the newsletter is posted. Separate multiple entries with commas ,, for example: @everyone, @here, <@&ROLE_ID>, <@USER_ID>.
• Enable Developer Mode in Discord to copy role and user IDs.
• The mention is posted once per webhook, on the first message of the newsletter, so a multi-part newsletter does not ping members repeatedly.
• Leave empty to post without pinging.

Library Selection

• Choose specific libraries within each item type (Movies/Series) to include in newsletters for this Discord client.

Newsletter Event Settings

• Configure which library events (Add/Update/Delete/Upcoming/Featured) should trigger Discord notifications:
  • Add: Enable newly added items section in the newsletter (default: enabled).
  • Update: Enable updated items section in the newsletter. Updates are detected when media files are upgraded (e.g., by tools like Radarr/Sonarr), where the old file is deleted and a new one is added with the same title/season/episode information (default: disabled).
  • Delete: Enable deleted items section in the newsletter (default: enabled).
  • Upcoming: Enable upcoming media section in the newsletter, sourced from Radarr/Sonarr (default: disabled).
  • Featured: Enable the Featured section, pinned to the top of the newsletter and populated from the Featured tab (default: enabled).

Max Items Per Section

• Limit how many items are shown in each section of the newsletter (for example, "Added to Movies"). Items beyond the limit are left out of the newsletter entirely (they are not sent, just skipped). Set to 0 to show all items (default).

Fields & Color selection

• Select the fields that you want as part of your embed.
• Select the embed color for each event type (Add, Update, Delete, Upcoming, Featured) and item type (Series, Movies).

You can now configure Multiple Telegram Clients. Each client instance can have its own Bot Token/Chat IDs, library selection, event configurations, and an enable/disable toggle.

Bot Token:

• Your Telegram bot token obtained from BotFather

Chat ID:

• The chat ID(can be a user ID, group ID, or channel ID) where you want to send the newsletters. Supports multiple Chat IDs: You can enter multiple Chat IDs separated by commas ,.

Library Selection

• Choose specific libraries within each item type (Movies/Series) to include in newsletters for this Telegram client.

Newsletter Event Settings

• Configure which library events (Add/Update/Delete/Upcoming/Featured) should trigger Telegram notifications:
  • Add: Enable newly added items section in the newsletter (default: enabled).
  • Update: Enable updated items section in the newsletter. Updates are detected when media files are upgraded (e.g., by tools like Radarr/Sonarr), where the old file is deleted and a new one is added with the same title/season/episode information (default: disabled).
  • Delete: Enable deleted items section in the newsletter (default: enabled).
  • Upcoming: Enable upcoming media section in the newsletter, sourced from Radarr/Sonarr (default: disabled).
  • Featured: Enable the Featured section, pinned to the top of the newsletter and populated from the Featured tab (default: enabled).

Max Items Per Section

• Limit how many items are shown in each section of the newsletter (for example, "Added to Movies"). Items beyond the limit are left out of the newsletter entirely (they are not sent, just skipped). Set to 0 to show all items (default).

Fields selection

• Select the fields that you want as part of your message.

You can configure Multiple Matrix Clients. Each client instance can have its own Homeserver URL, Access Token, Room ID(s), library selection, event configurations, and an enable/disable toggle.

Homeserver URL

• The URL of your Matrix homeserver (e.g., https://matrix.org or your self-hosted instance URL).

Access Token

• The access token for your Matrix bot/user account. This is used to authenticate API requests to the homeserver.

Room ID

• The Room ID where newsletters will be sent (e.g., !roomid:matrix.org). You can find this in your Matrix client's room settings. Supports multiple Room IDs: You can enter multiple Room IDs separated by commas ,.

Newsletter Title

• The heading shown at the top of the newsletter body
  • Defaults to Jellyfin Newsletter
  • Also available as the {NewsletterTitle} tag in the Body HTML

Test Message

• Use the "Test" button to send a test message and verify your Matrix configuration before saving.

Library Selection

• Choose specific libraries within each item type (Movies/Series) to include in newsletters for this Matrix client.

Newsletter Event Settings

• Configure which library events (Add/Update/Delete/Upcoming/Featured) should trigger Matrix notifications:
  • Add: Enable newly added items section in the newsletter (default: enabled).
  • Update: Enable updated items section in the newsletter. Updates are detected when media files are upgraded (e.g., by tools like Radarr/Sonarr), where the old file is deleted and a new one is added with the same title/season/episode information (default: disabled).
  • Delete: Enable deleted items section in the newsletter (default: enabled).
  • Upcoming: Enable upcoming media section in the newsletter, sourced from Radarr/Sonarr (default: disabled).
  • Featured: Enable the Featured section, pinned to the top of the newsletter and populated from the Featured tab (default: enabled).

Max Items Per Section

• Limit how many items are shown in each section of the newsletter (for example, "Added to Movies"). Items beyond the limit are skipped and a small "…" note is shown at the end of the section. Set to 0 to show all items (default).

Newsletter Template Category

• Currently, one template is available:
  • Matrix: An HTML-based template designed for Matrix clients with HTML rendering support (e.g., Element).

Body HTML

• Define custom HTML structure for the main message body. If left empty, the default HTML from the selected Newsletter Template Category will be used.

EntryData HTML

• Define custom HTML formatting for each individual media item (Movies/Series) in the newsletter. If left empty, the default HTML from the selected Newsletter Template Category will be used.

Header HTML

• Define custom HTML for section headers (e.g., "Added to Movies", "Removed from Series"). The template uses <template> tags with IDs to define all event-type headers in a single file:
  • <template id="header-featured"> - Header for the Featured section
  • <template id="header-add"> - Header for newly added items
  • <template id="header-update"> - Header for updated items
  • <template id="header-delete"> - Header for deleted items
  • <template id="header-upcoming"> - Header for upcoming items
• Placeholders:
  • {LibraryName} - replaced with the library name (e.g., "Movies", "TV Shows")
  • {FeaturedEmoji} - replaced with the emoji configured on the Featured tab (only used in header-featured)
• If a custom Header HTML was saved before the Featured section existed and has no header-featured template, the Featured section is skipped for that client and a warning is logged.
• If left empty, the default header template from the selected Newsletter Template Category will be used.

- {Date} - Auto-generated date (yyyy-MM-dd format)
- {d} - Day of the month (e.g. 9, 23)
- {dd} - Zero-padded day of the month (e.g. 09, 23)
- {day} - Full day name (e.g. Wednesday)
- {dy} - Short day name (e.g. Wed)
- {m} - Month of the year (e.g. 4, 11)
- {mm} - Zero-padded month (e.g. 04, 11)
- {month} - Full month name (e.g. April)
- {mon} - Short month name (e.g. Apr)
- {yy} - Two-digit year (e.g. 26)
- {yyyy} - Four-digit year (e.g. 2026)

- {prevDate} - Date of previous newsletter (legacy yyyy-MM-dd format)
- {prevd} - Day of the month of previous newsletter (e.g. 9, 23)
- {prevdd} - Zero-padded day of the month of previous newsletter (e.g. 09, 23)
- {prevday} - Full day name of previous newsletter (e.g. Wednesday)
- {prevdy} - Short day name of previous newsletter (e.g. Wed)
- {prevm} - Month of the year of previous newsletter (e.g. 4, 11)
- {prevmm} - Zero-padded month of previous newsletter (e.g. 04, 11)
- {prevmonth} - Full month name of previous newsletter (e.g. April)
- {prevmon} - Short month name of previous newsletter (e.g. Apr)
- {prevyy} - Two-digit year of previous newsletter (e.g. 26)
- {prevyyyy} - Four-digit year of previous newsletter (e.g. 2026)

Counts cover only the libraries selected on the configuration that is sending the newsletter, so two configurations pointed at different libraries will legitimately show different numbers.

Current library size:

- {MovieCount} - Number of movies (e.g. 14)
- {SeriesCount} - Number of series (e.g. 7)
- {EpisodeCount} - Number of episodes (e.g. 213)
- {ItemCount} - Movies plus episodes (series are containers, so they are not counted here)

Library size when the previous newsletter was sent:

- {prevMovieCount} - Number of movies at the previous newsletter
- {prevSeriesCount} - Number of series at the previous newsletter
- {prevEpisodeCount} - Number of episodes at the previous newsletter
- {prevItemCount} - Movies plus episodes at the previous newsletter

Change since the previous newsletter. These always render with a sign - +2 when items were added, -3 when items were deleted, 0 when nothing changed:

- {newMovieCount} - Change in movie count (e.g. +2)
- {newSeriesCount} - Change in series count (e.g. +1)
- {newEpisodeCount} - Change in episode count (e.g. -3)
- {newItemCount} - Change in movies plus episodes

Do not put your own + in front of these tags. The sign is already included, so a hardcoded plus would read as +-3 once media is deleted. Example usage:

Now with {MovieCount} movies and {SeriesCount} shows! ({newMovieCount} since last newsletter!)

On the very first newsletter there is nothing to compare against, so the {prev*} tags equal the current counts and every {new*} tag reads 0. The comparison becomes meaningful from the second newsletter onwards.