feat: filter out genres in discovery, default user settings

overseerr-api.yml

@@ -4263,6 +4263,11 @@ paths:
           schema:
             type: string
             example: 18
+        - in: query
+          name: filterGenre
+          schema:
+            type: string
+            example: 28
         - in: query
           name: studio
           schema:
@@ -4552,6 +4557,11 @@ paths:
           schema:
             type: string
             example: 18
+        - in: query
+          name: filterGenre
+          schema:
+            type: string
+            example: 28
         - in: query
           name: network
           schema:

server/api/themoviedb/index.ts

@@ -69,6 +69,7 @@ interface DiscoverMovieOptions {
   voteCountLte?: string;
   originalLanguage?: string;
   genre?: string;
+  filterGenre?: string;
   studio?: string;
   keywords?: string;
   sortBy?: SortOptions;
@@ -90,6 +91,7 @@ interface DiscoverTvOptions {
   includeEmptyReleaseDate?: boolean;
   originalLanguage?: string;
   genre?: string;
+  filterGenre?: string;
   network?: number;
   keywords?: string;
   sortBy?: SortOptions;
@@ -460,6 +462,7 @@ class TheMovieDb extends ExternalAPI {
     primaryReleaseDateLte,
     originalLanguage,
     genre,
+    filterGenre,
     studio,
     keywords,
     withRuntimeGte,
@@ -506,6 +509,7 @@ class TheMovieDb extends ExternalAPI {
               ? defaultFutureDate
               : primaryReleaseDateLte,
           with_genres: genre,
+          without_genres: filterGenre,
           with_companies: studio,
           with_keywords: keywords,
           'with_runtime.gte': withRuntimeGte,
@@ -534,6 +538,7 @@ class TheMovieDb extends ExternalAPI {
     includeEmptyReleaseDate = false,
     originalLanguage,
     genre,
+    filterGenre,
     network,
     keywords,
     withRuntimeGte,
@@ -580,6 +585,7 @@ class TheMovieDb extends ExternalAPI {
               : this.originalLanguage,
           include_null_first_air_dates: includeEmptyReleaseDate,
           with_genres: genre,
+          without_genres: filterGenre,
           with_networks: network,
           with_keywords: keywords,
           'with_runtime.gte': withRuntimeGte,

server/entity/UserSettings.ts

@@ -36,6 +36,12 @@ export class UserSettings {
   @Column({ nullable: true })
   public originalLanguage?: string;
 
+  @Column({ nullable: true })
+  public filterTvGenresDefault?: string;
+
+  @Column({ nullable: true })
+  public filterMovieGenresDefault?: string;
+
   @Column({ nullable: true })
   public pgpKey?: string;
 

server/interfaces/api/settingsInterfaces.ts

@@ -30,6 +30,8 @@ export interface PublicSettingsResponse {
   series4kEnabled: boolean;
   region: string;
   originalLanguage: string;
+  filterMovieGenresDefault: string;
+  filterTvGenresDefault: string;
   partialRequestsEnabled: boolean;
   cacheImages: boolean;
   vapidPublic: string;

server/interfaces/api/userSettingsInterfaces.ts

@@ -6,6 +6,8 @@ export interface UserSettingsGeneralResponse {
   locale?: string;
   region?: string;
   originalLanguage?: string;
+  filterMovieGenresDefault?: string;
+  filterTvGenresDefault?: string;
   movieQuotaLimit?: number;
   movieQuotaDays?: number;
   tvQuotaLimit?: number;

server/lib/settings.ts

@@ -101,6 +101,8 @@ export interface MainSettings {
   newPlexLogin: boolean;
   region: string;
   originalLanguage: string;
+  filterTvGenresDefault: string;
+  filterMovieGenresDefault: string;
   trustProxy: boolean;
   partialRequestsEnabled: boolean;
   locale: string;
@@ -298,6 +300,8 @@ class Settings {
         newPlexLogin: true,
         region: '',
         originalLanguage: '',
+        filterTvGenresDefault: '',
+        filterMovieGenresDefault: '',
         trustProxy: false,
         partialRequestsEnabled: true,
         locale: 'en',

server/routes/discover.ts

@@ -59,6 +59,7 @@ const QueryFilterOptions = z.object({
   firstAirDateLte: z.coerce.string().optional(),
   studio: z.coerce.string().optional(),
   genre: z.coerce.string().optional(),
+  filterGenre: z.coerce.string().optional(),
   keywords: z.coerce.string().optional(),
   language: z.coerce.string().optional(),
   withRuntimeGte: z.coerce.string().optional(),
@@ -80,12 +81,38 @@ discoverRoutes.get('/movies', async (req, res, next) => {
   try {
     const query = QueryFilterOptions.parse(req.query);
     const keywords = query.keywords;
+
+    // Handle user default excluded genres
+    let filterGenre = query.filterGenre;
+    if (filterGenre === 'none') {
+      filterGenre = undefined;
+    } else if (
+      filterGenre === undefined &&
+      req.user?.settings?.filterMovieGenresDefault
+    ) {
+      filterGenre = req.user.settings.filterMovieGenresDefault;
+    }
+
+    // Resolve conflicts: when explicit genres are present, remove them from exclusions
+    if (query.genre && filterGenre) {
+      const explicitGenres = query.genre.split(',');
+      const excludedGenres = filterGenre.split(',');
+      const resolvedExclusions = excludedGenres.filter(
+        (id) => !explicitGenres.includes(id)
+      );
+      filterGenre =
+        resolvedExclusions.length > 0
+          ? resolvedExclusions.join(',')
+          : undefined;
+    }
+
     const data = await tmdb.getDiscoverMovies({
       page: Number(query.page),
       sortBy: query.sortBy as SortOptions,
       language: req.locale ?? query.language,
       originalLanguage: query.language,
       genre: query.genre,
+      filterGenre,
       studio: query.studio,
       primaryReleaseDateLte: query.primaryReleaseDateLte
         ? new Date(query.primaryReleaseDateLte).toISOString().split('T')[0]
@@ -357,11 +384,38 @@ discoverRoutes.get('/tv', async (req, res, next) => {
   try {
     const query = QueryFilterOptions.parse(req.query);
     const keywords = query.keywords;
+
+    // Handle user default excluded genres
+    let filterGenre = query.filterGenre;
+    if (filterGenre === 'none') {
+      filterGenre = undefined;
+    } else if (
+      filterGenre === undefined &&
+      req.user?.settings?.filterTvGenresDefault
+    ) {
+      filterGenre = req.user.settings.filterTvGenresDefault;
+    }
+
+    // Always resolve conflicts between explicit genres and exclusions
+    if (query.genre && filterGenre) {
+      const explicitGenres = query.genre.split(',');
+      const excludedGenres = filterGenre.split(',');
+      const resolvedExclusions = excludedGenres.filter(
+        (id) => !explicitGenres.includes(id)
+      );
+
+      filterGenre =
+        resolvedExclusions.length > 0
+          ? resolvedExclusions.join(',')
+          : undefined;
+    }
+
     const data = await tmdb.getDiscoverTv({
       page: Number(query.page),
       sortBy: query.sortBy as SortOptions,
       language: req.locale ?? query.language,
       genre: query.genre,
+      filterGenre,
       network: query.network ? Number(query.network) : undefined,
       firstAirDateLte: query.firstAirDateLte
         ? new Date(query.firstAirDateLte).toISOString().split('T')[0]

server/routes/user/usersettings.ts

@@ -55,6 +55,8 @@ userSettingsRoutes.get<{ id: string }, UserSettingsGeneralResponse>(
         locale: user.settings?.locale,
         region: user.settings?.region,
         originalLanguage: user.settings?.originalLanguage,
+        filterTvGenresDefault: user.settings?.filterTvGenresDefault,
+        filterMovieGenresDefault: user.settings?.filterMovieGenresDefault,
         movieQuotaLimit: user.movieQuotaLimit,
         movieQuotaDays: user.movieQuotaDays,
         tvQuotaLimit: user.tvQuotaLimit,
@@ -116,6 +118,8 @@ userSettingsRoutes.post<
         locale: req.body.locale,
         region: req.body.region,
         originalLanguage: req.body.originalLanguage,
+        filterMovieGenresDefault: req.body.filterMovieGenresDefault,
+        filterTvGenresDefault: req.body.filterTvGenresDefault,
         watchlistSyncMovies: req.body.watchlistSyncMovies,
         watchlistSyncTv: req.body.watchlistSyncTv,
       });
@@ -124,6 +128,9 @@ userSettingsRoutes.post<
       user.settings.locale = req.body.locale;
       user.settings.region = req.body.region;
       user.settings.originalLanguage = req.body.originalLanguage;
+      user.settings.filterMovieGenresDefault =
+        req.body.filterMovieGenresDefault;
+      user.settings.filterTvGenresDefault = req.body.filterTvGenresDefault;
       user.settings.watchlistSyncMovies = req.body.watchlistSyncMovies;
       user.settings.watchlistSyncTv = req.body.watchlistSyncTv;
     }
@@ -136,6 +143,8 @@ userSettingsRoutes.post<
       locale: user.settings.locale,
       region: user.settings.region,
       originalLanguage: user.settings.originalLanguage,
+      filterMovieGenresDefault: user.settings.filterMovieGenresDefault,
+      filterTvGenresDefault: user.settings.filterTvGenresDefault,
       watchlistSyncMovies: user.settings.watchlistSyncMovies,
       watchlistSyncTv: user.settings.watchlistSyncTv,
     });

src/components/Discover/DiscoverMovies/index.tsx

@@ -10,6 +10,7 @@ import {
 import FilterSlideover from '@app/components/Discover/FilterSlideover';
 import useDiscover from '@app/hooks/useDiscover';
 import { useUpdateQueryParams } from '@app/hooks/useUpdateQueryParams';
+import { useUser } from '@app/hooks/useUser';
 import Error from '@app/pages/_error';
 import { BarsArrowDownIcon, FunnelIcon } from '@heroicons/react/24/solid';
 import type { SortOptions as TMDBSortOptions } from '@server/api/themoviedb';
@@ -47,9 +48,9 @@ const DiscoverMovies = () => {
   const intl = useIntl();
   const router = useRouter();
   const updateQueryParams = useUpdateQueryParams({});
+  const { user } = useUser();
 
   const preparedFilters = prepareFilterValues(router.query);
-
   const {
     isLoadingInitialData,
     isEmpty,
@@ -124,7 +125,10 @@ const DiscoverMovies = () => {
               <FunnelIcon />
               <span>
                 {intl.formatMessage(messages.activefilters, {
-                  count: countActiveFilters(preparedFilters),
+                  count: countActiveFilters(
+                    preparedFilters,
+                    !!user?.settings?.filterMovieGenresDefault
+                  ),
                 })}
               </span>
             </Button>

src/components/Discover/DiscoverTv/index.tsx

@@ -10,6 +10,7 @@ import {
 import FilterSlideover from '@app/components/Discover/FilterSlideover';
 import useDiscover from '@app/hooks/useDiscover';
 import { useUpdateQueryParams } from '@app/hooks/useUpdateQueryParams';
+import { useUser } from '@app/hooks/useUser';
 import Error from '@app/pages/_error';
 import { BarsArrowDownIcon, FunnelIcon } from '@heroicons/react/24/solid';
 import type { SortOptions as TMDBSortOptions } from '@server/api/themoviedb';
@@ -46,6 +47,7 @@ const SortOptions: Record<string, TMDBSortOptions> = {
 const DiscoverTv = () => {
   const intl = useIntl();
   const router = useRouter();
+  const { user } = useUser();
   const [showFilters, setShowFilters] = useState(false);
   const preparedFilters = prepareFilterValues(router.query);
   const updateQueryParams = useUpdateQueryParams({});
@@ -122,7 +124,10 @@ const DiscoverTv = () => {
               <FunnelIcon />
               <span>
                 {intl.formatMessage(messages.activefilters, {
-                  count: countActiveFilters(preparedFilters),
+                  count: countActiveFilters(
+                    preparedFilters,
+                    !!user?.settings?.filterTvGenresDefault
+                  ),
                 })}
               </span>
             </Button>