sbondCo/Watcharr v3.0.0 on GitHub

Note

The next release is finally here! Don't worry about the major version bump though, there's nothing for you to do, other than update your server as usual.

If you are using custom scripts, you may find that they need updating as a few endpoints have been removed and some now return a new data structure.

As always, it is highly recommended that you perform a backup before updating (https://watcharr.app/docs/server_config/backup)!

Deprecations

If you have any questions about the deprecations, I'm reachable on Matrix (or you can open an issue/discussion; more info at the bottom of these release notes).

Include Previously Watched setting no longer works for your main list and is due to be removed. The 'Last Finished' sort now acts as if this setting is set to 'true' (previously it defaulted to 'false').
The AddWatched api is now also used for Games (The separate AddPlayed api was removed).
The AddWatched api now accepts a tmdbId for movies/tv OR an igdbId for games.
- It still supports the old contentId field to ensure any custom scripts out there still work, but in one of the future releases, this will be removed. You will see a warning in your logs if you are still using this property.
All search endpoints have been replaced with a new central search endpoint that encompasses all behavior from the last endpoints.

New

Redesigned the top half of content pages.
Redesigned people pages.
- Added expandable biography (we are no longer limited to the first paragraph).
- Added age.
Your watched list is now delivered with pagination and infinite loading.
- Gets you to your data quicker.
- Reduces bandwidth usage.
- Sorting and filtering is now done server-side (saving your device).
Created a new centralized Search service.
- Search by (external) id now occurs on server.
Search: Support searching your own watched list for results before needing to go out to external db.
import: You can now provide your own api key when doing a Trakt import (incase our included api key ever stops working).
Games: Added providers (currently just: Steam, GOG & itch.io)
Discover: Overhauled the entire experience.
- Added games and people types.
- Added sorting options.
- Now with pagination so you can keep browsing past the top results for each media type and sort.
Nav: The main search bar is now truly centered on the page and no longer jumps around when navigating through different pages.
Added version log to server (with nice art if you are looking at cli output).

Changed

Games now use the normal Poster component (GamePoster has been deleted).
Game results now loads max 40 records at once (previously was 10).
Restyled the Error component that is shown when data fails to load for pages.

Fixed

Removed spammed duplicate styling being added to built styles (reducing wasted bandwidth on duplicate styling).
Trakt importing.
Replaced some log.Fatals with real error responses.
Improve twitch config by not writing empty time.

Documentation

Importing/Trakt: New section for optional api key field.
Update screenshots to match new UI and add a person page screenshot.

Maintenence

Watcharr is now licensed under GPLv3!
Server code has been completely redesigned/restructured.
Created Makefiles for server/client.
- For usual dev commands.
- Added a nice version job for updating app version.
Created a FEATURES.md.
Upgrade to go 1.25.
Dockerfile: Fix COPY requiring trailing slash on dest dir.
Upgrade all doc site dependencies.

A Note

I hope you all enjoy this release. Please feel free to provide any feedback and report any bugs you find!

🆘 Getting Help

If you need help, encounter an issue or find a bug please create an issue or join our space on Matrix for support. Always happy to help!

Package: https://github.com/sbondCo/Watcharr/pkgs/container/watcharr/716738135?tag=v3.0.0 or on docker hub.
Full Changelog: v2.1.1...v3.0.0