CinePlex: Your Media Universe on Steroids 🚀

🤔 What the Heck Is This? Prepare for Takeoff!

Let's be real. You love your Plex and Jellyfin servers. They're your own little corner of the digital universe, packed with your movies, shows, music, and photos. But... don't you ever feel like the interface could be... more? A little more ✨ magic and sparkle ✨?

Well, CinePlex is the answer to your digital prayers! It's like you bought your media server a superhero cape and sent it to a futuristic spa. It's a modern, fast, and stunningly designed interface that sits on top of your servers to give you a visually dazzling experience.

In short: CinePlex is not a streaming service. It's a radical transformation for the content you already own. It's your personal media universe, but with steroids and a lot more style!

---

✨ The Feature Loot Drop (What Makes It Awesome!)

Get ready to be amazed by everything CinePlex has under the hood. This isn't just an extension; it's an experience!

• 🎬 Pimped-Out Interface: Forget boring UIs. We use TheMovieDB's API to bring you high-res posters, spectacular backdrops, gripping synopses, ratings, cast info... all the juicy movie gossip you crave!
• 🌐 Universal Translator: Hola! Bonjour! Hallo! CinePlex speaks your language with full i18n support. No more getting lost in translation – your media, your language!
• **📡 Multi-Server Fusion Engine (Plex & Jellyfin!): CinePlex is no longer just for Plex! Now you can connect your Jellyfin servers too. It scans your Plex tokens and Jellyfin credentials, figures out what you actually have across all your servers, and unifies it all in one seamless interface. It's your personal librarian for a multi-platform media empire!
• **🤖 Your Personal AI Assistant (Powered by Gemini): This is the game-changer! CinePlex includes a built-in AI chat assistant. Ask it to find movies, play music, show you your stats, or even clean up your history. It's like having JARVIS for your media library.
• ✅ "Got It" Badge of Honor: See a movie you want to watch? CinePlex will let you know if you already have it on any of your connected servers with a neat "Local" badge. No more blind searching!
• 🎶 Music Jukebox 2077: It's not all about movies. We've built a full-fledged music player that connects to your Plex and Jellyfin music libraries. Browse artists, listen to albums, and rock out with a graphic equalizer and audio visualizer! Your personal party, guaranteed!
• 📊 The Nerd Stats Panel: Ever wondered how many 80s movies you have? Or what your most common genre is? Dive into the statistics panel and get a full breakdown of your media library with amazing charts. Unleash your inner nerd!
• 🖼️ Your Personal Photo Gallery: Connect to your Plex photo libraries and browse your albums and pictures with a beautiful, integrated lightbox viewer. Relive your memories in style!
• 📜 The Scroll of Power (M3U Generator): For the power users. Select any server (Plex or Jellyfin), pick the libraries you want, and generate an .m3u file with all the direct stream links. Perfect for use in other players like VLC or IPTV apps.
• 🔥 Stream Straight to Your Server: This is where it gets wild. Configure a simple PHP script on your server, and you can send streams from CinePlex directly to your M3U playlist file with a single click. We even give you a PHP script generator to make it foolproof!
• ❤️ Favorites & Goldfish Memory: Save your favorite movies and shows. Plus, we've got a "History" section so you can remember what you were watching last night before you fell asleep on the couch. Never lose track again!
• 🧠 AI-Powered Recommendations: Based on your viewing history and favorites, CinePlex will suggest new content you might love. It's like having a personal movie critic living in your browser.
• 🔧 Customization Tuning Shop: Don't like the dark theme? Switch to light mode! Don't want the giant hero banner? Hide it! Add your own TMDB and Google AI API keys. You're the boss, this is your extension!

---

🤖 Meet Your AI Assistant: Talk to Your Media!

Click the chat bubble and say hello to your new AI-powered copilot. It's integrated with Google's Gemini and can understand and execute commands within CinePlex. It's not just a search bar; it's a command center.

Here are a few things you can ask it to do:

• Navigate the App:

  • "Show me my favorite movies."
  • "Take me to the statistics page."
  • "Open the M3U generator."

• Find Content:

  • "Do I have the movie 'Inception' on my server?"
  • "Search for all the 'Star Wars' series."

• Control Your Media:

  • "Play music by Queen."
  • "Add 'The Matrix' to my favorites."
  • "I want to download a list of all James Bond movies I have, name the file 007.m3u"

• Manage the App:

  • "Clear my viewing history."
  • "I need to delete all my favorites."
  • "Update all my Plex servers."

Try it out! The possibilities are vast.

---

🛠️ Installation and First Steps: Liftoff in 3, 2, 1...!

Get ready for adventure! Getting this beast up and running is easier than finding popcorn at the movies. Follow these simple steps and you'll be navigating your media like a Starship captain.

1. Installing the Extension: The First Quantum Leap!

Since we're not yet on the Chrome Web Store (but we will be, oh yes!), you'll have to load it as an "unpacked" extension. Think of it as an exclusive beta launch just for you.

1. Download this repository: Click the green "Code" button and select "Download ZIP". Unzip the file somewhere you'll remember (perhaps your "Documents" folder or a secret place where you keep your digital treasures!).
2. Open Chrome Extensions: In a new tab, type chrome://extensions and press Enter. Welcome to the control center of your browser superpowers!
3. Enable Developer Mode: Find the "Developer mode" toggle in the top-right corner and switch it ON. It's like turning on your browser's turbo mode!
4. Load the Extension: You'll see some new buttons appear. Click on "Load unpacked".
5. Select the Folder: A file browser will open. Navigate to the folder where you unzipped the repository and select it. Don't pick the wrong folder, or the universe might collapse! (Well, maybe not, but it won't work).
6. Mission Ready! You should now see the CinePlex card in your extensions list. Congratulations, you've installed your first piece of space technology!

2. Initial Setup: Your Personal Operations Base!

When you first open CinePlex, it's like a newly built spaceship: impressive, but it needs fuel and coordinates. Let's bring it to life!

1. Get Your Credentials: The Keys to the Kingdom!

   • For Plex: You need your X-Plex-Token. The easiest way is to follow the official Plex guide: Finding an Authentication Token / X-Plex-Token.
   • For Jellyfin: You'll need your server URL, username, and password.

2. Open CinePlex Settings: The Control Panel!

   • Click the CinePlex icon in your browser's toolbar to open the application in a new tab.
   • Click the cogwheel icon (⚙️) in the top-right corner to open the Settings modal. This is where the magic happens!

3. Add Your Servers: Injecting the Fuel!

   • For Plex: Go to the Plex tab. Paste your X-Plex-Token(s) inside the code editor.

     {
         "tokens": [
             "YourPlexTokenGoesHere_abc123"
         ]
     }
     

   • For Jellyfin: Go to the Jellyfin tab. Enter your server URL, username, and password.
   • API Keys (Optional but Recommended): In the General tab, add your free API key from TheMovieDB for metadata and your Google AI Studio key to power the AI Assistant.

4. Start Your First Scan: The Great Exploration!

   • In the settings for Plex and/or Jellyfin, click the "Start Scan" or "Connect and Scan" button. It's time for CinePlex to discover all your treasures!
   • A console will appear at the bottom of the main page, showing you the scanner's progress. Be patient, the first scan can take a few minutes if you have a gigantic library.

5. Enjoy! Once the scan is complete, the app will automatically refresh. Go back to the main view and start exploring your newly supercharged media universe!

---

💡 Pro-Tip: Setting Up the "Add Stream" Feature - The Magic Button!

Want to take your experience to the next level and use the "Add Stream" button? It's like having a magic wand for your content!

1. In the CinePlex settings, go to the "PHP Gen" tab.
2. Configure the options (like the filename, save path, and security key) and click "Generate Script". Watch as the magic of code materializes!
3. Copy the generated PHP code. It's your secret recipe!
4. Save that code as a .php file (e.g., playlist.php) and upload it to a web server you control.
5. Go to the "General" tab in settings and paste the public URL to your new script in the "PHP Script URL" field.
6. Save, and you're ready! Now you can add streams with a single click. It's like teleporting your content wherever you need it!

---

🔒 Permissions: What Does CinePlex Need and Why?

CinePlex is designed to be as non-intrusive as possible, but it does need a few permissions to work its magic:

• storage: Allows CinePlex to store your server credentials, scanned library data, and your personalized settings directly in your browser's local storage. All your data stays on your machine, safe and sound!
• notifications: Used to send you helpful notifications, for example, when a scan is complete.
• host_permissions for https://*.plex.tv/*: This is crucial! It allows CinePlex to communicate with the main Plex API to find your servers associated with your token.
• host_permissions for http://*/* and https://*/*: This sounds scary, but it's necessary! Because your Plex and Jellyfin servers can be on any IP address (e.g., 192.168.1.100, my-server.local, a public domain), the extension needs this broad permission to be able to connect to your specific server addresses. CinePlex ONLY communicates with the server URLs you provide or that it discovers via the official Plex API. It does not read data from any other websites you visit. This permission is essential for the core functionality of connecting to your personal media servers.