# Plex Homepage Item ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MibFAV79cRxzOnNJYi8%2F-MibFEBMWlF-ZWmRAHmf%2Fimage.png?alt=media\&token=ccc16578-1fac-425e-9cc5-5edab1122c3c) ## Summary The Plex homepage item allows you to have the following Plex items displayed on the homepage: * Current playing streams (Active Streams) * Recently Added items * Media search functionality * Playlists ## Setting up ### Enable Tab When setting up the Plex homepage item, the first option is to enable it, do that by toggling the `Enable` Switch. After that you need to set the `Minimum Authentication` group that will be able to use this item. {% hint style="info" %} Please make sure not to set the `Minimum Authentication` to at least the same or lower than the homepage's `Tab Group` {% endhint %} | **Field** | **Value** | | ---------------------------------- | ----------------------------------------- | | Enable | Enable the Plex Module | | Main Module Minimum Authentication | Minimum Group needed to see Entire Module | ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZD1y2N2gIGrCLHta6%2Fimage.png?alt=media\&token=391c230a-3f0d-4355-b933-078fa797a7dd) ### Connection If you already went through the [Plex SSO](https://docs.organizr.app/books/setup-features/page/sso) or [Plex Authentication](https://docs.organizr.app/books/setup-features/page/plex-authentication) setup you will have these next fields already saved, if not, you can hit set those values using the provided buttons. | **Field** | **Value** | | ------------------------- | --------------------------------------------------------------------------- | | URL | URL to your Plex Server - LAN preferred | | Disable Certificate Check | Disables the Certificate of the URL provided if https | | Use Custom Certificate | Uses a Custom Certificate for the verification of the URL provided if https | | Token | Plex Token (Use button to retrieve) | | Plex Machine | Plex Machine ID (Use button to retrieve) | ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZDoeJI1GNG9AeUIJE%2Fimage.png?alt=media\&token=ae3eeb77-a8d2-47d4-8d67-f8836039f4d2) ### Active Streams With this module, you will be able to show the current streams that are active on your Plex server live. | **Field** | **Value** | | --------------------------------------- | -------------------------------------------------- | | Enable | Enable the Plex Active Stream Module | | Module Minimum Authentication | Minimum Group needed to see Module | | User Information | Show Plex User name | | User Information Minimum Authentication | Minimum Group needed to see Plex User name | | Refresh Seconds | How many seconds to refresh the Module | | Libraries to Exclude | Drop down of libraries to exclude from this Module | {% tabs %} {% tab title="Settings" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZEuCDlR_f1FqAFpvl%2Fimage.png?alt=media\&token=27041183-fed2-4aeb-bf08-315533df4dee) {% endtab %} {% tab title="Preview" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MibFAV79cRxzOnNJYi8%2F-MibGDVL0JA2ti1S9ar7%2Fimage.png?alt=media\&token=bf9e1435-7d2b-4dc1-acd4-06fa999b6803) {% endtab %} {% endtabs %} ### Recent Items With this module, you will be able to display all recent items that were added to your Plex server. | **Field** | **Value** | | ----------------------------- | -------------------------------------------------- | | Enable | Enable the Plex Recent Items Module | | Module Minimum Authentication | Minimum Group needed to see Module | | Libraries to Exclude | Drop down of libraries to exclude from this Module | | Item Limit | Limit the total # of items to display | | Refresh Seconds | How many seconds to refresh the Module | {% tabs %} {% tab title="Settings" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZFdTlhtXRoINyG2vK%2Fimage.png?alt=media\&token=41a72ecb-8605-45db-8ffd-14f494f0ae2b) {% endtab %} {% tab title="Preview" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MibFAV79cRxzOnNJYi8%2F-MibGVBBHln2X7Ne_w-p%2Fimage.png?alt=media\&token=50d2ea5f-4cc6-4682-84cd-bc840d6c9345) {% endtab %} {% endtabs %} ### Media Search With this module, you will be able to show a search button on your Organizr so users may search your library. | **Field** | **Value** | | ----------------------------- | -------------------------------------------------- | | Enable | Enable the Plex Media Search Module | | Module Minimum Authentication | Minimum Group needed to see Module | | Libraries to Exclude | Drop down of libraries to exclude from this Module | | Media Server | Choose Plex | {% tabs %} {% tab title="Settings" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZG1dzuuLCiG5dP1NM%2Fimage.png?alt=media\&token=cf774888-4352-4b2b-90ec-4caeb4428953) {% endtab %} {% tab title="Preview" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MibFAV79cRxzOnNJYi8%2F-MibGrtt4lHTddUViC6D%2Fimage.png?alt=media\&token=349bb9c6-cba1-4c36-b4fa-ff3002ad76ca) {% endtab %} {% endtabs %} ### Playlists With this module, you will be able to show your curated playlists from your Plex server. | **Field** | **Value** | | ----------------------------- | ---------------------------------- | | Enable | Enable the Plex Playlist Module | | Module Minimum Authentication | Minimum Group needed to see Module | {% tabs %} {% tab title="Settings" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZGdAFftEtQGowAgEc%2Fimage.png?alt=media\&token=4fc5a07d-dd3b-49be-84a8-39a01b6e6400) {% endtab %} {% tab title="Preview" %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MibFAV79cRxzOnNJYi8%2F-MibH6MHxOQfxM_jpaB-%2Fimage.png?alt=media\&token=7e2b8655-f9a9-4ae8-97a9-946ec52ffb7e) {% endtab %} {% endtabs %} ### Misc Options | **Field** | **Value** | | ----------------------------------- | -------------------------------------------------- | | Plex Tab Name | The Plex Tab name if you have one configured | | Plex Tab WAN URL | The WAN facing URL i.e. | | Image Cache Size | Cache Image quality | | Use Tautulli custom names for users | Grab custom names from Tautulli | {% hint style="info" %} The `Plex Tab Name` and `Plex Tab WAN URL` are used to configure the homepage items to open up inside the Plex Tab you have setup. To enable`Use Tautulli custom names for users` You must setup the Tautulli Homepage item. {% endhint %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZGwyTRodvifDWQxFf%2Fimage.png?alt=media\&token=8da18597-7946-49f2-9011-b4a6b01d591d) ### Test Connection {% hint style="info" %} Make sure to save before hitting the `Test Connection` button {% endhint %} ![](https://4256712066-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MhZdNSL6M8X_fZlyG10%2F-MiZBgkaJIyvw7an5Ls5%2F-MiZHl3q7PELg48j5ONP%2Fimage.png?alt=media\&token=ff484d67-5b79-4d30-8128-fee3fd3e193e) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.organizr.app/features/homepage/plex-homepage-item.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.