Initial commit

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+
+      - name: Create replacements.yml
+        run: |
+          echo "meta:" > replacements.yml
+          echo "  username: ${{ github.repository_owner }}" >> replacements.yml
+          echo "  repo_name: ${{ github.event.repository.name }}" >> replacements.yml
+          echo "  year: $(date +'%Y')" >> replacements.yml
+          echo "  full_repo: ${{ github.repository }}" >> replacements.yml
+          cat replacements.yml
+
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+
+      - uses: actions/cache@v4
+        with:
+          key: requirements-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            requirements-
+
+      - run: |
+          pip install -r requirements.txt
+          pip install git+https://github.com/SivagiriVisakan/mkdocs-replace-plugin.git
+
+      - run: mkdocs gh-deploy --force

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MisterCalvin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,3 @@
+# Plex Guide Template
+
+Built with Material for MKDocs, deployed and hosted via Github Pages. TODO: Fill out README with links to useful videos, add links to MKDocs plugins, other misc things

docs/changing-stream-quality/index.md

@@ -0,0 +1,13 @@
+# Changing Plex Streaming Quality
+
+By default, Plex sets video quality to 720p on all new devices. While this conservative setting ensures broad compatibility, it's not optimal for several reasons:
+
+1. Most devices today can handle higher quality streams
+2. Downscaling 1080p content to 720p reduces video quality
+3. [Transcoding](../faq/what-is-transcoding.md) (converting) video from 1080p to 720p creates unnecessary load on the server
+
+!!! tip
+    For the best viewing experience, you should adjust your quality settings to "Maximum" or at least "1080p" if your internet connection can support it. The sections in the table of contents to your left will show you how to do this on different devices.
+
+!!! note
+    You'll need to change this setting once for each new Plex app you use (phone, TV, web browser, etc.). After that, the setting will be remembered for that device.

docs/changing-stream-quality/ios-android.md

@@ -0,0 +1,7 @@
+# Changing Plex streaming quality: iOS & Android
+
+!!! example "iOS & Android"
+
+    ![Example](../assets/images/change-stream-quality-ios-android.webp)
+
+    **Source**: [plxplainers.xyz](https://www.plxplainers.xyz/)

docs/changing-stream-quality/streaming-devices.md

@@ -0,0 +1,7 @@
+# Changing Plex streaming quality:  Amazon Fire TV, Android TV, PlayStation 4/5, Xbox, Roku, Smart TV (LG, Samsung, VIZIO)
+
+!!! example "Amazon Fire TV, Android TV, PlayStation 4/5, Xbox, Roku, Smart TV (LG, Samsung, VIZIO)"
+
+    ![Example](../assets/images/change-stream-quality-stream-boxes.webp)
+
+    **Source**: [plxplainers.xyz](https://www.plxplainers.xyz/)

docs/changing-stream-quality/tv-os.md

@@ -0,0 +1,7 @@
+# Changing Plex streaming quality: tvOS (Apple TV)
+
+!!! example "tvOS (Apple TV)"
+
+    ![Example](../assets/images/change-stream-quality-apple-tv.webp)
+
+    **Source**: [plxplainers.xyz](https://www.plxplainers.xyz/)

docs/changing-stream-quality/web-browser.md

@@ -0,0 +1,7 @@
+# Changing Plex streaming quality: Web Browser
+
+!!! example "Web Browser"
+
+    ![Example](../assets/images/change-stream-quality-web-browser.webp)
+
+    **Source**: [plxplainers.xyz](https://www.plxplainers.xyz/)

docs/disabling-online-media-sources.md

@@ -0,0 +1,9 @@
+# Disabling Online Media Sources
+
+Plex offers additional services like Live TV, Music, and Web Shows that you may see in your sidebar. If you're only interested in accessing my Movie and TV Show libraries, you can disable or unpin these extra services to keep your interface clean and focused. This can be done through your Plex application settings and helps prevent confusion between my content and Plex's online services.
+
+!!! example "How-to: Disabling Online Media Sources"
+
+    ![Example](assets/images/disable-online-media-sources.webp)
+
+    **Source**: [plxplainers.xyz](https://www.plxplainers.xyz/)

docs/faq/adding-to-universal-watchlist.md

@@ -0,0 +1,22 @@
+# How do I add items to my Plex Universal Watchlist?
+
+!!! quote
+    It’s easy to add content to your Universal Watchlist from a number of places:
+
+    - Movies or TV shows in a Plex Media Server library (not individual seasons or episodes)
+    - Plex’s free Movies & Shows streaming content
+    - Content you find in the Discover source
+    - Via the player when watching trailers
+
+    From any of those sources:
+
+    - On Movie and TV show library or universal detail screens, you click on the Add to Watchlist button
+    - On mobile and TV grid views you can long press on a Movie or show poster to see the Add to Watchlist option
+    - In the web app click on the options menu on the bottom right of a trailer, show or movie poster/thumb
+    - From search results menu in the desktop/web app click the menu to the right of each result
+    - During trailer playback from the Discover source an Add to Watchlist button is located on near the playback controls
+    - If you select a non-Plex streaming service to watch a TV show from the universal details page, when you return to Plex it will ask you if you want to add that show to your Watchlist so you can quickly access the show in the future to watch more episodes. Plex can automatically remove shows and movies from the Watchlist if played within Plex Movies & Shows. Items watched on other services will need to be managed manually.
+
+    If an item is already on your Watchlist, the option will be displayed as Remove from Watchlist.
+
+    **Source**: [Plex: Universal Watchlist](https://support.plex.tv/articles/universal-watchlist/#:~:text=On%20Movie%20and%20TV%20show,show%20or%20movie%20poster%2Fthumb)

docs/faq/can-i-share-your-plex.md

@@ -0,0 +1,8 @@
+# Sharing Access to the Server
+
+!!! important
+    Please do not share my Plex server or your account with others, with one exception:
+
+    - You may share with your spouse or significant other
+
+If you know someone who would like access to the server, please speak with me directly.

docs/faq/content-issues.md

@@ -0,0 +1,29 @@
+# I'm having a problem with a Movie or TV Show
+
+If you encounter any problems with content (such as distorted video, incorrect media, double images, or misaligned subtitles), you have two ways to report it:
+
+## Using Overseerr (Preferred Method)
+
+   1. Visit [request.mydomain.com](https://request.mydomain.com)
+   2. Find the problematic Movie or TV Show
+   3. Click the yellow exclamation point icon in the top right
+   4. Enter the details of the issue
+
+   While this method isn't required, it helps me track and resolve issues more effectively by creating a searchable history of reported problems.
+
+!!! example "Reporting issues within Overseerr"
+    <center><video style="width:65%" controls="true" alt="type:video">
+        <source src="../../assets/video/overseerr-reporting-issues.webm" type="video/webm">
+    </video></center>
+
+## Why use Overseerr for reporting?
+
+- Creates a documented history of the issue
+- Helps me track problems I can't fix immediately
+- Makes it easier to identify patterns in content issues
+- Provides all the necessary details in one place
+
+## Direct Contact
+
+   - You can always contact me directly about any issues
+   - This is perfectly fine and works too!

docs/faq/forgot-password.md

@@ -0,0 +1,16 @@
+# Help, I forgot my Plex password!
+
+!!! quote
+    If you’ve forgotten your password and need to have it reset, you can find a Forgot? link on email sign-in form.
+
+    ![Forgot password](../assets/images/forgot-password.webp){ width="498" }
+    /// caption
+    Forgot password?
+    ///
+
+    Enter your email address and submit the form. If the address matches an existing, active Plex account, an email will be sent that contains instructions on resetting the account password.
+
+    !!! note
+        If there is no Plex account matching the submitted address or if you have deleted your Plex account, then no email will be sent.
+
+    **Related Page**: [Plex: Forgot Password?](https://app.plex.tv/auth#?resetPassword)

docs/faq/how-can-i-support-you.md

@@ -0,0 +1,22 @@
+# Supporting the Server
+
+## Donations
+My Plex server is and will always be completely free. No donations or payments will ever be accepted - just enjoy the content!
+
+## Plex Pass (Optional)
+If you're enjoying Plex, you might want to consider getting a [Plex Pass](https://www.plex.tv/plex-pass/). While I don't receive any compensation, it offers several premium features:
+
+* Download content for offline viewing
+* Auto-skip intros and credits
+* Access to Live TV
+* And more!
+
+### Plex Pass Subscription Options
+- Monthly: Around $5
+- **Recommended:** Lifetime subscription
+    - Usually $120
+    - Often discounted to $80-90 during Black Friday sales
+    - Best value if you plan to use Plex long-term
+
+!!! note
+    Plex Pass is completely optional - you don't need it to access and enjoy my server's content.

docs/faq/i-dont-want-to-use-overseerr.md

@@ -0,0 +1,6 @@
+# I don't want to use this request thingy, can't I just tell you what I want?
+
+!!! tip
+    <center><video style="width:50%" controls="true" alt="type:video">
+      <source src="../../assets/video/dale-go-to-hell.webm" type="video/webm">
+    </video></center>

docs/faq/missing-emails.md

@@ -0,0 +1,29 @@
+# Missing Confirmation Emails
+
+## Expected Notifications
+When you request content, you should receive two automated emails:
+
+1. Request approval confirmation
+2. Content availability notification when ready to stream
+
+## Troubleshooting Missing Emails
+If you're not receiving these notifications, it's likely because:
+
+- You may have signed up for Plex using an old or inactive email address
+- Your email settings in Plex need to be updated
+
+## How to Update Your Email
+To fix this, you'll need to update the email address associated with your Plex account.
+
+!!! quote
+    Once signed in to your Plex account, you can manage your account information at any time from Plex Web App. Click the top right user menu and then choose Account. Here, you’ll be able to edit and manage various aspects of your Plex account.
+
+    ![Plex Email](../assets/images/change-email.webp){ width="800" }
+    /// caption
+    Plex account email
+    ///
+
+    **Related Page**: [Plex Web App: Account Page](https://app.plex.tv/desktop#!/settings/account)
+
+!!! note
+    After updating your email, new request notifications will be sent to your updated address.

docs/faq/missing-requests.md

@@ -0,0 +1,17 @@
+# I requested something an hour ago but it hasn't shown up yet. Why?
+
+When requesting content at [request.sbotnas.io](https://request.sbotnas.io), you'll see three important dates:
+
+![Overseerr Release Dates](../assets/images/overseerr-release-dates.webp){ width="320" }
+/// caption
+Release dates within request.sbotnas.io
+///
+
+1. Theatrical Release - When it hits theaters
+2. Digital Release - When it's available to stream/purchase digitally
+3. Physical Release - When DVDs/Blu-rays are available
+
+!!! important
+    Content typically won't be available on Plex until after its Digital Release date. When requesting new content, always check the Digital Release date in Overseerr's "Release Dates" column to know when it will be available.
+
+There are rare exceptions to this rule, but generally, if your requested content isn't showing up in Plex, verify that its Digital Release date has passed.

docs/faq/responsible-content-requests.md

@@ -0,0 +1,26 @@
+# Responsible Content Requesting
+
+## Understanding How Plex Works
+Unlike streaming services like Netflix or Disney+, my Plex server runs on physical hardware at my home. Every Movie and TV Show you request is stored on hard drives that I maintain and pay for. While I'm happy to provide this service, it's important to understand that storage space isn't infinite!
+
+## Request Guidelines
+I encourage you to request content you're genuinely interested in watching. Here are some tips for responsible requesting:
+
+* Try to watch content you've requested
+* Consider pacing your requests with your viewing habits
+* Feel free to request whatever interests you, but be mindful of requesting large amounts of content you may not get to
+
+## Life Happens
+I completely understand that:
+
+* You might lose interest in something you requested
+* Life gets busy and you can't watch everything
+* Your viewing preferences might change
+
+This is all perfectly normal! These guidelines aren't strict rules - they're just to help everyone understand how the server works and to make the most of our shared resource.
+
+## Questions?
+If you're unsure about requesting something or have questions about how much to request, feel free to reach out to me. I'm always happy to help!
+
+!!! note
+    Remember: This is a free service I provide because I enjoy sharing content with friends and family. Being mindful of your requests helps me maintain the server effectively for everyone.

docs/faq/special-requests.md

@@ -0,0 +1,20 @@
+# Content Quality and Language Options
+
+## Default Settings
+By default, all content on my Plex server has:
+
+- 1080p resolution
+- English audio track
+- English subtitles (when available)
+
+## Special Requests
+If you need any of the following, please contact me privately:
+
+- 4K versions
+- Specific audio languages
+- Additional subtitle languages
+- Alternate cuts or versions
+- Additional features such as DVD commentaries or extras
+
+!!! note
+    Special requests may take additional time to process and could require additional storage space. I'll do my best to accommodate your needs.

docs/faq/what-is-transcoding.md

@@ -0,0 +1,12 @@
+# What is Transcoding?
+
+!!! quote "What is transcoding?"
+    Great question, Transcoding is Plex's secret sauce. It makes sure that whatever the device you are on, it will transcode the tiny bits that make up a video into a format that your client can understand and display. This is true for both video and audio formats.
+
+    ## Why is Transcoding not preferred?
+    Another great question. Transcoding effects picture quality while also taking adverse effects on the server that is sending the digital bits. It has to shrink the bits and then send them to your client. Imagine if it didn't have to change the bits? It just sent them.
+
+    ## What's in it for me?
+    Quicker loading times, you press play and the video will start sooner than if the server had to change all the bits. Faster video scrubbing (Fast FWD/RWD), meaning skipping ahead and rewinding will be quicker. More people can enjoy the server if the server doesn't have to work as hard and you get the highest quality picture you can. Hence this site was created to educate users on the optimal settings for Plex for the best experience.
+
+    **Source**: [mediaclients.wiki/Plex](https://mediaclients.wiki/Plex)

docs/faq/why-bitrate-matters.md

@@ -0,0 +1,7 @@
+# Why Bitrate Matters
+
+!!! info "Technical Guide: Why Bitrate Matters"
+
+    ![Example](../assets/images/why-bitrate-matters.webp)
+
+    **Source**: [plxplainers.xyz](https://www.plxplainers.xyz/)

docs/faq/why-do-i-to-buy-plex-app.md

@@ -0,0 +1,7 @@
+# Why do I need to buy the Plex app on my phone?
+
+!!! quote
+
+    Our mobile apps (Android and iOS) can be used for free, but have limitations. Until the mobile app is unlocked (through an in-app purchase or a Plex Pass subscription), video and music streamed from a Plex Media Server has a 1 minute playback limit, and photos will be watermarked.
+
+    **Source**: [Plex: Free vs Paid](https://support.plex.tv/articles/202526943-plex-free-vs-paid/)

docs/faq/wont-stop-buffering.md

@@ -0,0 +1,21 @@
+# My video won't stop buffering
+
+If you're experiencing constant buffering, there are two common solutions:
+
+### 1. Lower Your Streaming Quality {: .no-toc }
+
+Your internet connection might need a lower quality setting:
+
+* Your internet speed might not support maximum resolution streaming
+* Try reducing the quality to 1080p or 720p
+* See the [Changing Plex streaming quality](../changing-stream-quality/index.md) page for detailed instructions on changing the streaming quality for different devices
+
+### 2. Check Your Subtitles {: .no-toc }
+
+Subtitle processing can cause buffering:
+
+* Plex can sometimes struggle with subtitle processing
+* If you have subtitles enabled, try disabling them temporarily
+* This often resolves buffering issues immediately
+
+Still having trouble? Feel free to reach out to me privately for help troubleshooting the issue.

docs/index.md

@@ -0,0 +1,11 @@
+---
+title: Preamble
+---
+#
+
+![Logo](assets/images/guide-logo-dark.webp#only-dark)
+![Logo](assets/images/guide-logo-light.webp#only-light)
+
+This guide details common tasks you'll need to perform when joining my Plex server for the first time. The content herein should answer 99% of your questions, though you're always welcome to ask me directly. While this guide primarily shows screenshots from a web browser, you can make these changes from any Plex app (mobile, smart TV, or game console). If you have trouble finding a particular setting, I recommend switching to a web browser to make the changes. All settings in this guide will sync across your devices and only need to be configured once, with one important exception: Plex streaming quality must be set separately the first time you log into each new Plex application.
+<br><br>
+While you don't need to read this guide from start to finish, new Plex users should at least review the essential sections on [Pinning Libraries](pinning-libraries.md) and [Changing Plex streaming quality](changing-stream-quality/index.md).