Plex-Meta-Manager/docs/files/builders/overview.md

# Builders

Builders use third-party services to source items to be added to the collection. Multiple builders can be used in the same collection from a variety of sources listed below.

!!! builder

    ![Smart Plex logo](../../../assets/icons/plex.png){ align=right }

    **[Plex (Smart)](../smart)** builders create Smart Collections based on the metadata inside your Plex Server. Results are dynamic and will update as your library updates without the need to re-run PMM.

    [:octicons-home-16: View Builder](../smart){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Cannot be used for Overlays unless utilizing Smart Labels" }

    ??? quicklink "Popular Builders"

        - [:simple-plex: Smart Label](../smart/#smart-label) - Create a Smart Collection based on a specific label. The label can be generated by PMM based on criteria.
        - [:simple-plex: Smart Filter](../smart/#smart-filter) - Create a Smart Collection based on the filter parameters provided.

!!! builder

    ![Dumb Plex logo](../../../assets/icons/plex_dumb.png){ align=right }

    **[Plex (Dumb)](../smart)** builders grab items based on the metadata inside your Plex Server. Results are static and require PMM to re-run to update.

    [:octicons-home-16: View Builder](../plex){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:simple-plex: Plex All](../plex/#plex-all) - Gets every movie/show in your library.
        - [:simple-plex: Plex Search](../plex/#plex-search) - Gets every movie/show based on the search parameters provided.
        - [:simple-plex: Plex Collectionless](../plex/#plex-collectionless) - Gets every movie/show that is not in a collection.

!!! builder

    ![TMDb logo](../../../assets/icons/tmdb.png){ align=right }

    **[TMDb](../tmdb)** builders grab items based on metadata and lists on TheMovieDb.org

    [:octicons-home-16: View Builder](../tmdb){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:simple-themoviedatabase: TMDb Collection](../tmdb/#tmdb-collection) - Gets every movie/show in your library.
        - [:simple-themoviedatabase: TMDb List](../tmdb/#tmdb-list) - Gets every movie/show in your Watchlist.
        - [:simple-themoviedatabase: TMDb Company](../tmdb/#tmdb-company) - Gets the first episode of every show in your library.
        - [:simple-themoviedatabase: TMDb Network](../tmdb/#tmdb-network) - Gets the first episode of every show in your library.

!!! builder

    ![Trakt logo](../../../assets/icons/trakt.png){ align=right }

    **[Trakt](../trakt)** builders grab items based on metadata and lists on Trakt.tv

    [:octicons-home-16: View Builder](../trakt){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:simple-trakt: Trakt List](../trakt/#trakt-list) - Gets  every movie/show in the Trakt List
        - [:simple-trakt: Trakt Chart](../trakt/#trakt-chart) - Gets every movie/show in the Trakt Chart
        - [:simple-trakt: Trakt Recommendations](../trakt/#trakt-recommendations) - Gets every movie/show in Trakt's Personal Recommendations for your User

!!! builder

    ![MdbList logo](../../../assets/icons/mdblist.png){ align=right }

    **[MdbList](../mdblist)** builders grab items based on lists on MdbList.com

    [:octicons-home-16: View Builder](../mdblist){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:octicons-list-ordered-16: MdbList List](../mdblist/#mdblist-list) - Gets every movie/show in a MDbList List.

!!! builder

    ![IMDb logo](../../../assets/icons/imdb.png){ align=right }

    **[IMDb](../imdb)** builders grab items based on metadata and lists on IMDb.com

    [:octicons-home-16: View Builder](../imdb){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:simple-imdb: IMDb Chart](../imdb/#imdb-chart) - Gets every movie/show in an IMDb Chart like IMDb Top 250 Movies.
        - [:simple-imdb: IMDb List](../imdb/#imdb-list) - Gets every movie/show in an IMDb List.
        - [:simple-imdb: IMDb Award](../imdb/#imdb-award) - Gets every movie/show in an IMDb Event.
        - [:simple-imdb: IMDb Search](../imdb/#imdb-award) - Gets every movie/show in an IMDb Search. Can also be used for Keyword searches.

!!! builder

    ![TVDb logo](../../../assets/icons/tvdb.png){ align=right }

    **[TVDb](../tvdb)** builders grab items based on metadata and lists on TheTVDb.com

    [:octicons-home-16: View Builder](../tvdb){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:material-television-guide: TVDb Show](../tvdb/#tvdb-show) - Grabs the specified series.
        - [:material-television-guide: TVDb Movie](../tvdb/#tvdb-movie) - Gets the specified movies.
        - [:material-television-guide: TVDb List](../tvdb/#tvdb-list) - Gets every item in a TVDb List or TVDb Userlist.

!!! builder

    ![BoxOfficeMojo logo](../../../assets/icons/boxofficemojo.png){ align=right }

    **[BoxOfficeMojo](../mojo)** builders grab items based on metadata and lists on Boxofficemojo.com

    [:octicons-home-16: View Builder](../mojo){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Movie libraries" }

    ??? quicklink "Popular Builders"

        - [:material-ticket: Mojo World](../mojo/#mojo-world) - Grabs items in the Worldwide Box Office chart.
        - [:material-ticket: Mojo Domestic](../mojo/#mojo-movie) - Grabs items in the Domestic Box Office chart.
        - [:material-ticket: Mojo Record](../mojo/#mojo-record) - Grabs items in miscellaneous lists such as Weekend Records and Daily Records.

!!! builder

    ![Tautulli logo](../../../assets/icons/tautulli.png){ align=right }

    **[Tautulli](../tautulli)** builders grab items based on lists on Tautulli

    [:octicons-home-16: View Builder](../tautulli){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:material-movie-search: Tautulli Popular](../tautulli/#tautulli-popular) - Gets  every movie/show in the Tautulli Most Popular List
        - [:material-movie-search: Tautulli Watched](../tautulli/#tautulli-watched) - Gets every movie/show in the Tautulli Most Watched List

!!! builder

    ![Radarr logo](../../../assets/icons/radarr.png){ align=right }

    **[Radarr](../radarr)** builders grab items based on tags in Radarr

    [:octicons-home-16: View Builder](../radarr){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Movie libraries" }

    ??? quicklink "Popular Builders"

        - [:octicons-tag-16: Radarr All](../radarr/#radarr-all) - Gets every movie in Radarr
        - [:octicons-tag-16: Radarr Taglist](../radarr/#radarr-taglist) - Gets every movie with the specified tags

!!! builder

    ![Sonarr logo](../../../assets/icons/sonarr.png){ align=right }

    **[Sonarr](../sonarr)** builders grab items based on tags in Sonarr

    [:octicons-home-16: View Builder](../sonarr){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Show libraries" }

    ??? quicklink "Popular Builders"

        - [:octicons-tag-16: Sonarr All](../sonarr/#sonarr-all) - Gets every show in Sonarr
        - [:octicons-tag-16: Sonarr Taglist](../sonarr/#sonarr-taglist) - Gets every show with the specified tags

!!! builder

    ![Letterboxd logo](../../../assets/icons/letterboxd.png){ align=right }

    **[Letterboxd](../letterboxd)** builders grab items based on lists on Letterboxd.com

    [:octicons-home-16: View Builder](../letterboxd){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Movie libraries" }

    ??? quicklink "Popular Builders"

        - [:simple-letterboxd: Letterboxd List](../letterboxd/#letterboxd-list) - Gets every movie in the Letterboxd list

!!! builder

    ![ICheckMovies logo](../../../assets/icons/icheckmovies.png){ align=right }

    **[ICheckMovies](../icheckmovies)** builders grab items based on lists on ICheckMovies.com

    [:octicons-home-16: View Builder](../icheckmovies){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Movie libraries" }

    ??? quicklink "Popular Builders"

        - [:material-check: ICheckMovies List](../icheckmovies/#icheckmovies-list) - Gets every show in the ICheckMovies list

!!! builder

    ![AniDB logo](../../../assets/icons/anidb.png){ align=right }

    **[AniDB](../anidb)** builders grab items based on metadata and lists on AniDB.com

    [:octicons-home-16: View Builder](../anidb){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:octicons-database-16: AniDB ID](../anidb/#anidb-id) - Finds the anime specified by the AniDB ID
        - [:octicons-database-16: AniDB Popular](../anidb/#anidb-popular) - Finds every anime in AniDB's Popular Anime list
        - [:octicons-database-16: AniDB Tags](../anidb/#anidb-tags) - Finds every anime with the specified AniDB Tag

!!! builder

    ![AniList logo](../../../assets/icons/anilist.png){ align=right }

    **[AniList](../anilist)** builders grab items based on metadata and lists on AniList.com

    [:octicons-home-16: View Builder](../anilist){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:simple-anilist: AniList Top Rated](../anilist/#anilist-top-rated) - Gets every anime in AniList's Top Rated Anime list
        - [:simple-anilist: AniList Popular](../anilist/#anilist-popular) - Gets every anime in AniList's Popular Anime list
        - [:simple-anilist: AniList Trending](../anilist/#anilist-trending) - Gets every anime in AniList's Trending Anime list
        - [:simple-anilist: AniList Search](../anilist/#anilist-search) - Gets every anime specified by the AniList search parameters provided

!!! builder

    ![MyAnimeList logo](../../../assets/icons/myanimelist.png){ align=right }

    **[MyAnimeList](../myanimelist)** builders grab items based on metadata and lists on MyAnimeList.com

    [:octicons-home-16: View Builder](../myanimelist){ .md-button .md-button--primary }

    ??? quicklink "Popular Builders"

        - [:simple-myanimelist: MyAnimeList Popular](../myanimelist/#myanimelist-most-popular) - Gets every anime in MyAnimeList's Most Popular Anime list
        - [:simple-myanimelist: MyAnimeList Top All](../myanimelist/#myanimelist-top-all) - Gets every anime in MyAnimeList's Top All Anime list
        - [:simple-myanimelist: MyAnimeList Top Airing](../myanimelist/#myanimelist-top-airing) - Gets every anime in MyAnimeList's Top Airing Anime list
        - [:simple-myanimelist: MyAnimeList Suggested](../myanimelist/#myanimelist-suggested) - Gets every suggested anime in by MyAnimeList for the authorized user

!!! builder

    ![Reciperr logo](../../../assets/icons/reciperr.png){ align=right }

    **[Reciperr](../reciperr)** builders grab items based on lists on Reciperr.com

    [:octicons-home-16: View Builder](../reciperr){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Movie libraries" }

    ??? quicklink "Popular Builders"

        - [:material-chef-hat: Reciperr List](../reciperr/#reciperr-list) - Gets every movie returned by the Reciperr JSON data URL.

!!! builder

    ![StevenLu logo](../../../assets/icons/stevenlu.png){ align=right }

    **[StevenLu](../stevenlu)** builders grab items based on lists on StevenLu.com

    [:octicons-home-16: View Builder](../stevenlu){ .md-button .md-button--primary }
    [:octicons-alert-24:](""){ .card-link title="Only works with Movie libraries" }

    ??? quicklink "Popular Builders"

        - [:material-pirate: StevenLu Popular](../stevenlu/#stevenlus-popular-movie-list) - Gets every movie on StevenLu's Popular Movies List.