Jellyfin-Newsletter

Jellyfin-Newsletter

Docker app from guniv's Repository

Overview

A newsletter for Jellyfin to notify your users of your latest additions. Jellyfin Newsletter connects to the Jellyfin API to retrieve recently added items and send them to your users. It is fully customizable and can be run on a schedule using a cron job or a task scheduler.

Jellyfin Newsletter - keep your users updated

GitHub stars GHCR pulls

A newsletter for Jellyfin to notify your users of your latest additions. Jellyfin Newsletter connects to the Jellyfin API to retrieve recently added items and send them to your users.

It is fully customizable and can be run on a schedule using a cron job or a task scheduler.

Official documentation

Jellyfin version support:

Jellyfin version Jellyfin-Newsletter compatible version
< 12.0 <= 1.3.0
>= 12.0 >= 2.0

Table of Contents

  1. What it looks like
  2. Features
  3. Getting started
  4. License
  5. Contribution

What it looks like

Features

  • Retrieve the last added movies and TV shows from your Jellyfin server
  • Send a newsletter to your users with the last added items
  • Retrieve the movie details from TMDB, including poster
  • Group TV shows by seasons
  • Fully customizable and responsive email template
  • Easy to maintain, extend, setup and run
  • Support many languages (see below)
  • Configure the list of recipients
  • Configure specific folders to watch for new items
  • Support themes

Supported languages

You can contribute to the translation of Jellyfin-Newsletter on Crowdin

State of localization

Getting started

Follow the official documentation to get started.

License

This project is licensed under the AGPLv3 License—see the LICENSE file for details.

Contribution

Feel free to contribute to this project by opening an issue or a pull request.

A contribution guide is available in the CONTRIBUTING.md file.

If you like this project, consider giving it a ⭐️.

If you encounter any issues, please let me know by opening an issue.

Media gallery

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/seaweedbraincy/jellyfin-newsletter:latest
Last Updated2026-10-16
First Seen2025-07-01

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

ConfigurationPathrw

This is where the config file for Jellyfin Newsletter is stored. Edit the config.yml in this folder.

Target
/app/config
Default
/mnt/user/appdata/jellyfin-newsletter/
Value
/mnt/user/appdata/jellyfin-newsletter/
Time zoneVariable

The time zone that will be used for the built in scheduler. See time zone examples here: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Target
TZ
Default
America/New_York
Value
America/New_York
User UIDVariable

The user ID that the container will run Jellyfin Newsletter as.

Target
USER_UID
Default
1000
Value
1000
Group GIDVariable

The group ID that the container will run Jellyfin Newsletter as.

Target
GROUP_GID
Default
1000
Value
1000