Repository navigation
Releases
Finalarr v0.4.0
The first release. Finalarr learns what you actually watch, and it includes everything
listed under 0.3.0 below, which was never released on its own.
Added
- Emby, Jellyfin and Plex: connect one or more media servers (connection test, token
stored encrypted) and pick whose viewing counts — family members and Plex Home managed
users included. Finalarr reads which episodes they watched every 30 minutes and matches
the series to Sonarr by TVDB id. - Follow automatically: a series someone watched at least 2 episodes of within 30 days
is followed on its own (both numbers adjustable, can be switched off). Each series has a
follow mode: automatic, always (followed by hand) or never; what you followed before
stays followed. Finalarr never unfollows on its own. - Watched state in the UI: who watched how much of a series and when, which episodes
in the grid are watched and by whom, how many episodes on disk are still unwatched and
which one is next; list filters for started, behind and caught-up series and by follow
mode; a "Weiterschauen" list on the dashboard. Without a media server none of this shows.
Security
- Changing the address of a Sonarr instance or media server now needs the key again, so
a stored key can never be sent to a new host.
Privacy
- Stored per selected user: which episodes were watched and on which day. No viewing
history, playback positions, devices or IP addresses; deselecting a user deletes their
data.
Finalarr v0.4.0-rc.1
The first release. Finalarr learns what you actually watch, and it includes everything
listed under 0.3.0 below, which was never released on its own.
Added
- Emby, Jellyfin and Plex: connect one or more media servers (connection test, token
stored encrypted) and pick whose viewing counts — family members and Plex Home managed
users included. Finalarr reads which episodes they watched every 30 minutes and matches
the series to Sonarr by TVDB id. - Follow automatically: a series someone watched at least 2 episodes of within 30 days
is followed on its own (both numbers adjustable, can be switched off). Each series has a
follow mode: automatic, always (followed by hand) or never; what you followed before
stays followed. Finalarr never unfollows on its own. - Watched state in the UI: who watched how much of a series and when, which episodes
in the grid are watched and by whom, how many episodes on disk are still unwatched and
which one is next; list filters for started, behind and caught-up series and by follow
mode; a "Weiterschauen" list on the dashboard. Without a media server none of this shows.
Security
- Changing the address of a Sonarr instance or media server now needs the key again, so
a stored key can never be sent to a new host.
Privacy
- Stored per selected user: which episodes were watched and on which day. No viewing
history, playback positions, devices or IP addresses; deselecting a user deletes their
data.
Finalarr v0.3.0-rc.18
The first version that does the whole job: it watches Sonarr, knows how many episodes a
season will have, and tells you once — when new episodes are on disk, when the finale has
landed and when a season is complete.
Added
- Sonarr: connect one or more instances (connection test, encrypted API key), webhook
URL to paste into Sonarr (optional Basic auth, IP allowlist), sync every 30 minutes and
right after each webhook. The webhook only triggers a sync; nothing in its body is trusted. - Series: follow series one by one or all monitored ones at once; search and filter;
per series you decide whether specials count and whether unmonitored episodes are ignored. - Season logic: expected episode count from Sonarr, cross-checked with AniList for anime
(split cours included). When the two disagree the season shows "Folgenzahl unklar" and
waits; one click takes either number. Seasons Sonarr does not list yet are announced from
AniList. "Jetzt prüfen" shows what Finalarr would report right now without sending anything. - Reports: "verfügbar" (as episode ranges, one message per batch), "Finale", "Teil
komplett" for split cours, "Staffel komplett" and "angekündigt" — each at most once, never
for what was already on disk when you started following. - Channels: Telegram, Discord, Pushover, generic webhook or any Apprise URL; message
language, event filter and quiet hours per channel; test message; failed sends are
retried twice and then shown with the reason; resend from the event log. - UI in English and German (follows the browser, switchable): overview, series, events,
settings, setup wizard, dark and light theme, with Finalarr's own look — a tally mark,
dusk rose for what is running and gold for what is finished (docs/DESIGN.md). - Sequels announced early: when AniList lists a sequel of a season you follow that has
not started yet (e.g. a 2027 continuation), Finalarr reports it once as "Fortsetzung
angekündigt", before TheTVDB or Sonarr know the season. Anime typed "Standard" in Sonarr
now get AniList data too. - News on every series page: Finalarr's own announcements and matched headlines,
then the latest web headlines about the series — only season and episode news that name
the series in the headline (no merchandise, films, manga, games, listicles or reviews) (Google News, in your UI language,
cached for 6 hours; can be switched off in the rules). - Calendar: a month view of what you are waiting for and a subscribable iCal feed
(Google, Apple, Outlook). Choose season finales only, premieres and finales, or every
episode; hide what is already on disk; show announced start dates; switch single series
off. The feed address is secret, can be renewed and switched off. - More sources: TVmaze (no key) and, with a free key each, TMDB and Trakt announce
renewed TV seasons early; MyAnimeList (Jikan) backs up AniList for anime sequels;
LiveChart.me and Anime News Network headlines that name a followed series arrive as
"In den News" hints with a link. One message per season or sequel, whatever the source. - What you are waiting for, on every series page in one sentence ("Staffel 3 ist
angekündigt, der Termin ist noch offen", "2 ausgestrahlte Folgen fehlen noch", …), plus
the next episode with a countdown and its exact time (Sonarr, AniList or TVmaze), the
channel, "where to watch" links (AniList; per country from TMDB/JustWatch with a key), a
trailer that loads from YouTube only after a click, and Sonarr's overview, network,
runtime, genres and fanart. The dashboard counts down to the next episode too. - Postponed episodes: when an upcoming episode's air date moves back by a day or more
(or disappears), Finalarr reports "verschoben" with the old and new date and marks the
episode in the grid and the calendar. - Typed news: headlines are sorted into renewal, announcement, cancellation, delay,
date and trailer, with the sentence that carries the news; Anime2You (DE) and Crunchyroll
News (EN) join the news feeds. - English dub dates from AnimeSchedule.net with an optional app token
(FINALARR_ANIMESCHEDULE_TOKEN). FINALARR_AUTH=local: no login from your home network; the API key is still needed from
anywhere else.- Data sources page (Einstellungen → Datenquellen): every outside service Finalarr
asks, what for and under which terms, each with an on/off switch. The About page credits
the sources (TMDB logo and notice, TVmaze under CC BY-SA, JustWatch), and the series page
links back to the source of each piece of data. - Setup shows that it works: the first sync with Sonarr and the first webhook call
(Sonarr's "Test" button) are confirmed live. - Backups while running:
docker exec finalarr python -m finalarr.backup. - Open source on GitHub: CI, release images on GHCR (amd64; arm64 too for final
releases; published only after CI and a start test, with SBOM, provenance and a cosign
signature), Unraid Community Applications template, issue templates, private security
reporting, licence notices in the image (/licenses/INDEX.txt). - Runs as one Docker container (non-root, PUID/PGID, healthcheck, data in
/config);
refuses to start withoutFINALARR_API_KEYandFINALARR_SECRET_KEY.
Security
FINALARR_AUTH=localno longer trusts forwarded requests unless
FINALARR_TRUSTED_PROXIESis set; behind an unconfigured proxy every visitor looked local.- Logs strip bot tokens, webhook secrets, passwords and token parameters from HTTP(S)
URLs that Apprise prints.
Finalarr v0.3.0-rc.17
The first version that does the whole job: it watches Sonarr, knows how many episodes a
season will have, and tells you once — when new episodes are on disk, when the finale has
landed and when a season is complete.
Added
- Sonarr: connect one or more instances (connection test, encrypted API key), webhook
URL to paste into Sonarr (optional Basic auth, IP allowlist), sync every 30 minutes and
right after each webhook. The webhook only triggers a sync; nothing in its body is trusted. - Series: follow series one by one or all monitored ones at once; search and filter;
per series you decide whether specials count and whether unmonitored episodes are ignored. - Season logic: expected episode count from Sonarr, cross-checked with AniList for anime
(split cours included). When the two disagree the season shows "Folgenzahl unklar" and
waits; one click takes either number. Seasons Sonarr does not list yet are announced from
AniList. "Jetzt prüfen" shows what Finalarr would report right now without sending anything. - Reports: "verfügbar" (as episode ranges, one message per batch), "Finale", "Teil
komplett" for split cours, "Staffel komplett" and "angekündigt" — each at most once, never
for what was already on disk when you started following. - Channels: Telegram, Discord, Pushover, generic webhook or any Apprise URL; message
language, event filter and quiet hours per channel; test message; failed sends are
retried twice and then shown with the reason; resend from the event log. - UI in English and German (follows the browser, switchable): overview, series, events,
settings, setup wizard, dark and light theme, with Finalarr's own look — a tally mark,
dusk rose for what is running and gold for what is finished (docs/DESIGN.md). - Sequels announced early: when AniList lists a sequel of a season you follow that has
not started yet (e.g. a 2027 continuation), Finalarr reports it once as "Fortsetzung
angekündigt", before TheTVDB or Sonarr know the season. Anime typed "Standard" in Sonarr
now get AniList data too. - News on every series page: Finalarr's own announcements and matched headlines,
then the latest web headlines about the series — only season and episode news that name
the series in the headline (no merchandise, films, manga, games, listicles or reviews) (Google News, in your UI language,
cached for 6 hours; can be switched off in the rules). - Calendar: a month view of what you are waiting for and a subscribable iCal feed
(Google, Apple, Outlook). Choose season finales only, premieres and finales, or every
episode; hide what is already on disk; show announced start dates; switch single series
off. The feed address is secret, can be renewed and switched off. - More sources: TVmaze (no key) and, with a free key each, TMDB and Trakt announce
renewed TV seasons early; MyAnimeList (Jikan) backs up AniList for anime sequels;
LiveChart.me and Anime News Network headlines that name a followed series arrive as
"In den News" hints with a link. One message per season or sequel, whatever the source. - What you are waiting for, on every series page in one sentence ("Staffel 3 ist
angekündigt, der Termin ist noch offen", "2 ausgestrahlte Folgen fehlen noch", …), plus
the next episode with a countdown and its exact time (Sonarr, AniList or TVmaze), the
channel, "where to watch" links (AniList; per country from TMDB/JustWatch with a key), a
trailer that loads from YouTube only after a click, and Sonarr's overview, network,
runtime, genres and fanart. The dashboard counts down to the next episode too. - Postponed episodes: when an upcoming episode's air date moves back by a day or more
(or disappears), Finalarr reports "verschoben" with the old and new date and marks the
episode in the grid and the calendar. - Typed news: headlines are sorted into renewal, announcement, cancellation, delay,
date and trailer, with the sentence that carries the news; Anime2You (DE) and Crunchyroll
News (EN) join the news feeds. - English dub dates from AnimeSchedule.net with an optional app token
(FINALARR_ANIMESCHEDULE_TOKEN). FINALARR_AUTH=local: no login from your home network; the API key is still needed from
anywhere else.- Data sources page (Einstellungen → Datenquellen): every outside service Finalarr
asks, what for and under which terms, each with an on/off switch. The About page credits
the sources (TMDB logo and notice, TVmaze under CC BY-SA, JustWatch), and the series page
links back to the source of each piece of data. - Setup shows that it works: the first sync with Sonarr and the first webhook call
(Sonarr's "Test" button) are confirmed live. - Backups while running:
docker exec finalarr python -m finalarr.backup. - Open source on GitHub: CI, release images on GHCR (amd64; arm64 too for final
releases; published only after CI and a start test, with SBOM, provenance and a cosign
signature), Unraid Community Applications template, issue templates, private security
reporting, licence notices in the image (/licenses/INDEX.txt). - Runs as one Docker container (non-root, PUID/PGID, healthcheck, data in
/config);
refuses to start withoutFINALARR_API_KEYandFINALARR_SECRET_KEY.
Security
FINALARR_AUTH=localno longer trusts forwarded requests unless
FINALARR_TRUSTED_PROXIESis set; behind an unconfigured proxy every visitor looked local.- Logs strip bot tokens, webhook secrets, passwords and token parameters from HTTP(S)
URLs that Apprise prints.
Finalarr v0.3.0-rc.16
The first version that does the whole job: it watches Sonarr, knows how many episodes a
season will have, and tells you once — when new episodes are on disk, when the finale has
landed and when a season is complete.
Added
- Sonarr: connect one or more instances (connection test, encrypted API key), webhook
URL to paste into Sonarr (optional Basic auth, IP allowlist), sync every 30 minutes and
right after each webhook. The webhook only triggers a sync; nothing in its body is trusted. - Series: follow series one by one or all monitored ones at once; search and filter;
per series you decide whether specials count and whether unmonitored episodes are ignored. - Season logic: expected episode count from Sonarr, cross-checked with AniList for anime
(split cours included). When the two disagree the season shows "Folgenzahl unklar" and
waits; one click takes either number. Seasons Sonarr does not list yet are announced from
AniList. "Jetzt prüfen" shows what Finalarr would report right now without sending anything. - Reports: "verfügbar" (as episode ranges, one message per batch), "Finale", "Teil
komplett" for split cours, "Staffel komplett" and "angekündigt" — each at most once, never
for what was already on disk when you started following. - Channels: Telegram, Discord, Pushover, generic webhook or any Apprise URL; message
language, event filter and quiet hours per channel; test message; failed sends are
retried twice and then shown with the reason; resend from the event log. - UI in English and German (follows the browser, switchable): overview, series, events,
settings, setup wizard, dark and light theme, with Finalarr's own look — a tally mark,
dusk rose for what is running and gold for what is finished (docs/DESIGN.md). - Sequels announced early: when AniList lists a sequel of a season you follow that has
not started yet (e.g. a 2027 continuation), Finalarr reports it once as "Fortsetzung
angekündigt", before TheTVDB or Sonarr know the season. Anime typed "Standard" in Sonarr
now get AniList data too. - News on every series page: Finalarr's own announcements and matched headlines,
then the latest web headlines about the series — only season and episode news that name
the series in the headline (no merchandise, films, manga, games, listicles or reviews) (Google News, in your UI language,
cached for 6 hours; can be switched off in the rules). - Calendar: a month view of what you are waiting for and a subscribable iCal feed
(Google, Apple, Outlook). Choose season finales only, premieres and finales, or every
episode; hide what is already on disk; show announced start dates; switch single series
off. The feed address is secret, can be renewed and switched off. - More sources: TVmaze (no key) and, with a free key each, TMDB and Trakt announce
renewed TV seasons early; MyAnimeList (Jikan) backs up AniList for anime sequels;
LiveChart.me and Anime News Network headlines that name a followed series arrive as
"In den News" hints with a link. One message per season or sequel, whatever the source. - What you are waiting for, on every series page in one sentence ("Staffel 3 ist
angekündigt, der Termin ist noch offen", "2 ausgestrahlte Folgen fehlen noch", …), plus
the next episode with a countdown and its exact time (Sonarr, AniList or TVmaze), the
channel, "where to watch" links (AniList; per country from TMDB/JustWatch with a key), a
trailer that loads from YouTube only after a click, and Sonarr's overview, network,
runtime, genres and fanart. The dashboard counts down to the next episode too. - Postponed episodes: when an upcoming episode's air date moves back by a day or more
(or disappears), Finalarr reports "verschoben" with the old and new date and marks the
episode in the grid and the calendar. - Typed news: headlines are sorted into renewal, announcement, cancellation, delay,
date and trailer, with the sentence that carries the news; Anime2You (DE) and Crunchyroll
News (EN) join the news feeds. - English dub dates from AnimeSchedule.net with an optional app token
(FINALARR_ANIMESCHEDULE_TOKEN). FINALARR_AUTH=local: no login from your home network; the API key is still needed from
anywhere else.- Data sources page (Einstellungen → Datenquellen): every outside service Finalarr
asks, what for and under which terms, each with an on/off switch. The About page credits
the sources (TMDB logo and notice, TVmaze under CC BY-SA, JustWatch), and the series page
links back to the source of each piece of data. - Setup shows that it works: the first sync with Sonarr and the first webhook call
(Sonarr's "Test" button) are confirmed live. - Backups while running:
docker exec finalarr python -m finalarr.backup. - Open source on GitHub: CI, release images on GHCR (amd64; arm64 too for final
releases; published only after CI and a start test, with SBOM, provenance and a cosign
signature), Unraid Community Applications template, issue templates, private security
reporting, licence notices in the image (/licenses/INDEX.txt). - Runs as one Docker container (non-root, PUID/PGID, healthcheck, data in
/config);
refuses to start withoutFINALARR_API_KEYandFINALARR_SECRET_KEY.
Security
FINALARR_AUTH=localno longer trusts forwarded requests unless
FINALARR_TRUSTED_PROXIESis set; behind an unconfigured proxy every visitor looked local.- Logs strip bot tokens, webhook secrets, passwords and token parameters from HTTP(S)
URLs that Apprise prints.
Finalarr v0.3.0-rc.15
The first version that does the whole job: it watches Sonarr, knows how many episodes a
season will have, and tells you once — when new episodes are on disk, when the finale has
landed and when a season is complete.
Added
- Sonarr: connect one or more instances (connection test, encrypted API key), webhook
URL to paste into Sonarr (optional Basic auth, IP allowlist), sync every 30 minutes and
right after each webhook. The webhook only triggers a sync; nothing in its body is trusted. - Series: follow series one by one or all monitored ones at once; search and filter;
per series you decide whether specials count and whether unmonitored episodes are ignored. - Season logic: expected episode count from Sonarr, cross-checked with AniList for anime
(split cours included). When the two disagree the season shows "Folgenzahl unklar" and
waits; one click takes either number. Seasons Sonarr does not list yet are announced from
AniList. "Jetzt prüfen" shows what Finalarr would report right now without sending anything. - Reports: "verfügbar" (as episode ranges, one message per batch), "Finale", "Teil
komplett" for split cours, "Staffel komplett" and "angekündigt" — each at most once, never
for what was already on disk when you started following. - Channels: Telegram, Discord, Pushover, generic webhook or any Apprise URL; message
language, event filter and quiet hours per channel; test message; failed sends are
retried twice and then shown with the reason; resend from the event log. - UI in English and German (follows the browser, switchable): overview, series, events,
settings, setup wizard, dark and light theme, with Finalarr's own look — a tally mark,
dusk rose for what is running and gold for what is finished (docs/DESIGN.md). - Sequels announced early: when AniList lists a sequel of a season you follow that has
not started yet (e.g. a 2027 continuation), Finalarr reports it once as "Fortsetzung
angekündigt", before TheTVDB or Sonarr know the season. Anime typed "Standard" in Sonarr
now get AniList data too. - News on every series page: Finalarr's own announcements and matched headlines,
then the latest web headlines about the series — only season and episode news that name
the series in the headline (no merchandise, films, manga, games, listicles or reviews) (Google News, in your UI language,
cached for 6 hours; can be switched off in the rules). - Calendar: a month view of what you are waiting for and a subscribable iCal feed
(Google, Apple, Outlook). Choose season finales only, premieres and finales, or every
episode; hide what is already on disk; show announced start dates; switch single series
off. The feed address is secret, can be renewed and switched off. - More sources: TVmaze (no key) and, with a free key each, TMDB and Trakt announce
renewed TV seasons early; MyAnimeList (Jikan) backs up AniList for anime sequels;
LiveChart.me and Anime News Network headlines that name a followed series arrive as
"In den News" hints with a link. One message per season or sequel, whatever the source. - What you are waiting for, on every series page in one sentence ("Staffel 3 ist
angekündigt, der Termin ist noch offen", "2 ausgestrahlte Folgen fehlen noch", …), plus
the next episode with a countdown and its exact time (Sonarr, AniList or TVmaze), the
channel, "where to watch" links (AniList; per country from TMDB/JustWatch with a key), a
trailer that loads from YouTube only after a click, and Sonarr's overview, network,
runtime, genres and fanart. The dashboard counts down to the next episode too. - Postponed episodes: when an upcoming episode's air date moves back by a day or more
(or disappears), Finalarr reports "verschoben" with the old and new date and marks the
episode in the grid and the calendar. - Typed news: headlines are sorted into renewal, announcement, cancellation, delay,
date and trailer, with the sentence that carries the news; Anime2You (DE) and Crunchyroll
News (EN) join the news feeds. - English dub dates from AnimeSchedule.net with an optional app token
(FINALARR_ANIMESCHEDULE_TOKEN). FINALARR_AUTH=local: no login from your home network; the API key is still needed from
anywhere else.- Open source on GitHub: CI, release images on GHCR (amd64; arm64 too for final
releases), Unraid Community Applications template, issue templates, private security
reporting, licence notices in the image (/licenses/INDEX.txt). - Runs as one Docker container (non-root, PUID/PGID, healthcheck, data in
/config);
refuses to start withoutFINALARR_API_KEYandFINALARR_SECRET_KEY.
Security
FINALARR_AUTH=localno longer trusts forwarded requests unless
FINALARR_TRUSTED_PROXIESis set; behind an unconfigured proxy every visitor looked local.- Logs strip bot tokens, webhook secrets, passwords and token parameters from HTTP(S)
URLs that Apprise prints.