Search

Search Box

Movies, Shows, Episodes, Artists and Music Videos can be searched using the search box next to the ErsatzTV logo.

Search Fields

The title field of all media types is searched by default if no other field is specified.

Movies

The following fields are available for searching movies:

• title: The movie title
• genre: The movie genre
• tag: The movie tag (not available with Plex metadata)
• plot: The movie plot
• studio: The movie studio
• actor: An actor from the movie
• director: A director from the movie
• writer: A writer from the movie
• library_name: The name of the library that contains the movie
• content_rating: The movie content rating (case-sensitive)
• language: The movie audio stream language
• language_tag: The movie audio stream language tag
• release_date: The movie release date (YYYYMMDD)
• added_date: The date the movie was added to ErsatzTV (YYYYMMDD)
• minutes: The rounded-up whole number duration of the movie in minutes
• seconds: The rounded-up whole number duration of the movie in seconds
• height: The movie height
• width: The movie width
• video_codec: The video codec
• video_bit_depth: The number of bits in the movie's pixel format
• video_dynamic_range: The movie's dynamic range (sdr or hdr)
• type: Always movie

Shows

The following fields are available for searching shows:

• title: The show title
• genre: The show genre
• tag: The show tag (not available with Plex metadata)
• plot: The show plot
• studio: The show studio
• actor: An actor from the show
• library_name: The name of the library that contains the show
• content_rating: The show content rating (case-sensitive)
• language: The show audio stream language
• language_tag: The show audio stream language tag
• release_date: The show release date (YYYYMMDD)
• added_date: The date the show was added to ErsatzTV (YYYYMMDD)
• type: Always show

Seasons

The following fields are available for searching seasons:

• title: The season title
• library_name: The name of the library that contains the season
• season_number: The season number
• show_title: The title of the show that contains the season
• show_genre: The genre of the show that contains the season
• show_studio: The studio of the show that contains the season
• show_tag: The tag of the show that contains the season
• type: Always season

Episodes

The following fields are available for searching episodes:

• title: The episode title
• plot: The episode plot
• director: A director from the episode
• writer: A writer from the episode
• library_name: The name of the library that contains the episode
• language: The episode audio stream language
• language_tag: The episode audio stream language tag
• release_date: The episode release date (YYYYMMDD)
• added_date: The date the episode was added to ErsatzTV (YYYYMMDD)
• minutes: The rounded-up whole number duration of the episode in minutes
• seconds: The rounded-up whole number duration of the episode in seconds
• height: The episode height
• width: The episode width
• season_number: The episode season number
• episode_number: The episode number
• show_title: The title of the show that contains the episode
• show_genre: The genre of the show that contains the episode
• show_studio: The studio of the show that contains the episode
• show_tag: The tag of the show that contains the episode
• video_codec: The video codec
• video_bit_depth: The number of bits in the episode's pixel format
• video_dynamic_range: The episode's dynamic range (sdr or hdr)
• type: Always episode

Artists

The following fields are available for searching artists:

• title: The artist name
• genre: The artist genre
• style: The artist style
• mood: The artist mood
• added_date: The date the artist was added to ErsatzTV (YYYYMMDD)
• library_name: The name of the library that contains the artist
• type: Always artist

Music Videos

The following fields are available for searching music videos:

• title: The music video title
• artist: The music video artist
• album: The music video album
• genre: The music video genre
• library_name: The name of the library that contains the music video
• language: The music video audio stream language
• language_tag: The music video audio stream language tag
• release_date: The music video release date (YYYYMMDD)
• added_date: The date the music video was added to ErsatzTV (YYYYMMDD)
• minutes: The rounded-up whole number duration of the music video in minutes
• seconds: The rounded-up whole number duration of the music video in seconds
• height: The music video height
• width: The music video width
• video_codec: The video codec
• video_bit_depth: The number of bits in the music video's pixel format
• video_dynamic_range: The music video's dynamic range (sdr or hdr)
• type: Always music_video

Other Videos

The following fields are available for searching other videos:

• title: The NFO title or the filename of the video (without extension)
• genre: The video genre
• tag: The video tag
• plot: The video plot
• studio: The video studio
• actor: An actor from the video
• director: A director from the video
• writer: A writer from the video
• library_name: The name of the library that contains the video
• content_rating: The video content rating (case-sensitive)
• language: The video audio stream language
• language_tag: The video audio stream language tag
• release_date: The video release date (YYYYMMDD)
• added_date: The date the video was added to ErsatzTV (YYYYMMDD)
• minutes: The rounded-up whole number duration of the video in minutes
• seconds: The rounded-up whole number duration of the video in seconds
• height: The video height
• width: The video width
• video_codec: The video codec
• video_bit_depth: The number of bits in the other video's pixel format
• video_dynamic_range: The other video's dynamic range (sdr or hdr)
• type: Always other_video

Songs

The following fields are available for searching songs:

• title: The song title, or the filename of the song (without extension)
• album: The song album
• artist: The song/track artist
• album_artist: The album artist
• genre: The song genre
• tag: All of the song's parent folders
• minutes: the rounded-up whole number duration of the song in minutes
• seconds: the rounded-up whole number duration of the song in seconds
• added_date: The date the song was added to ErsatzTV (YYYYMMDD)
• type: Always song

Special Search Fields

• released_inthelast: For any media type that supports release_date, released_inthelast takes a number and a unit (days, weeks, months, years) and returns items released between the specified time ago and now
• released_notinthelast: For any media type that supports release_date, released_notinthelast takes a number and a unit (days, weeks, months, years) and returns items released before the specified time ago
• released_onthisday: For any media type that supports release_date, released_onthisday takes any value (ignored) and will return items released on this month number and day number in previous years
• added_inthelast: For any media type that supports added_date, added_inthelast takes a number and a unit (days, weeks, months, years) and returns items added to ErsatzTV between the specified time ago and now
• added_notinthelast: For any media type that supports added_date, added_notinthelast takes a number and a unit (days, weeks, months, years) and returns items added to ErsatzTV before the specified time ago

Sample Searches

Christmas

plot:christmas

Christmas without Horror

plot:christmas NOT genre:horror

1970's Movies

type:movie AND release_date:197*

1970's-1980's Comedies

genre:comedy AND (release_date:197* OR release_date:198*)

Lush Music (Artists)

mood:lush

Episodes from the past week

type:episode AND released_inthelast:"1 week"

Episodes older than the past week

type:episode AND released_notinthelast:"1 week"

Episodes released on this day

type:episode AND released_onthisday:1