# 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)