Guide and tips for Jellyfin launcher & external player on Windows

=> New external player launcher version also compatible with Jellyfin Media Player desktop App, Potplayer or MPC : MPC-JF

---

[!NOTE]

<details> <summary><strong>(CLICK TO EXPAND) QUICK INSTALLATION - PPJF - PotPlayer launcher for Jellyfin Web </strong></summary>

0) Download

• Download PPJF for Jellyfin 10.7 or the latest for Jellyfin 10.11.+ : PPJF.10.11.6.zip

1) Place required files

• Extract and move the PotPlayerJellyfin folder to: C:\ProgramData\
  You should end up with: C:\ProgramData\PotPlayerJellyfin\ (with all files inside).

2) Install PotPlayer (default path)

• No need to reinstall if it’s already installed
• Default path: C:\Program Files\DAUM\PotPlayer

3) Install a browser + Violentmonkey, then add my userscript

• Standalone Firefox/LibreWolf is good (many tips for the best Jellyfin experience in the full README)
• Install Violentmonkey
  Firefox add-on: https://addons.mozilla.org/fr/firefox/addon/violentmonkey/
• Browser settings → Extensions → Violentmonkey → three dots → Options
• Go to Installed Scripts
• Click + → New
• The editor opens with default content: delete everything (don’t close the editor)
• Go to: C:\ProgramData\PotPlayerJellyfin\
• Open OpenWithPotplayerUserscript.js with Notepad, select all, copy
• Paste everything into the Violentmonkey editor
• Click Save & Exit (top right)
• If your Jellyfin server is not the default address http://localhost:8096/, edit the .js script and replace it with your Jellyfin Web URL
  Example: // @match http://192.168.1.10:8096/*
  Don’t forget the * at the end

Note : The .js userscript can be put in Jellyfin JavaScript Injector plugin instead, but every play buttons in Jellyfin Web won't work anywhere else without PPJF.

4) Enable PowerShell script execution (Windows)

• In Windows 11: Settings → System → For developers → PowerShell → allow local PowerShell scripts / unsigned scripts (wording may vary)
• If you can’t find it:
  • Search for PowerShell in the Start menu → right-click → Run as Administrator
  • Run:
    • Set-ExecutionPolicy RemoteSigned
  • Or:
    • Set-ExecutionPolicy RemoteSigned -Force

5) Apply PotPlayer registry settings

• Run potplayer.reg and confirm the changes
• You may need to re-run potplayer.reg after major PotPlayer updates
• Test it — done (if not, see workaround below)
• Check the full README on GitHub for extra quality-of-life improvements

6) Optionnal : Hide the Powerscript window at Potplayer launch

• Install-PPJF-HiddenProtocol.ps1 must be in your default PotPlayerJellyfin folder.
• It require VBScript installed (may not be installed by default on all Windows 11 installation)
• Run the file Install-PPJF-HiddenProtocol.ps1 (Right click and Run with PowerShell)

---

Workaround: PotPlayer starts but fails to open the media

• Your NAS / network drives / HDD must be mapped to a drive letter in Windows (e.g. D:\, E:\, etc.)
• Edit potplayer.ps1 located in: C:\ProgramData\PotPlayerJellyfin\
  • Near the end of the file, just below :
    • # YOUR NAS CONFIG, IF NEEDED, ADD YOUR OWN WORKAROUND JUST BELOW
  • Add this line:
    • $path = $path -replace "\\share\\SHAREFOLDER\\", "D:"
  • Replace "\\share\\SHAREFOLDER\\" with the beginning of the wrong path shown in PotPlayer “More info” when it fails
  • Use double backslashes \\ (single \ won't work)
  • Replace "D:" with your mapped drive letter
  • Example (works for everything on my NAS mapped as D:):
    • $path = $path -replace "\\share\\MEDIA\\", "D:"
  • The \\share\\MEDIA\\ part depends on your NAS setup (use PotPlayer “More info” to identify what needs replacing)
  • If you have other drives, do the same for them by adding lines below.
  • No need to do add lines for every library folder, just one line for each different drive should be enough.

</details>

---

Full guide and tips

This tutorial explains how to:

Launch medias from the Jellyfin web interface directly with PotPlayer. Steps 1 to 6 required.

Optional :  Clickable link to Windows File Explorer for the corresponding media (from the Jellyfin media information panel)

Optional : Jellyfin Service Automation, Start and stop the Jellyfin server automatically with the Jellyfin interface and closing it. 

Optional : Launch Jellyfin Web in fullscreen

Bonus : Select text and one click search selection on IMDB, YOUTUBE, or any websites

---

-Update- for Optional : Jellyfin Service Automation, Start and stop. Cleaner solution, no console popup window, multi browser auto-install, possibility for custom .bat at launch, notification etc.. :

• Start and stop the Jellyfin server automatically at launching the interface and closing it.
• Standalone and/or replace Steps 13. 14. 15. 16. 17. that are for manual installation of an older version of JellyfinServiceAutomation
• Add Custom scripts - Run additional .bat files at server startup (ex : MountNetworkDrives, SpinUpDrives)
• Works with Jellyfin Media Player, web browsers (recommended), or you can enter any executable path manually (for using Jellyfin MPV Shim or anything else)
• Download and follow the instruction from the Readme in : WIP.JellyfinServiceAutomation.zip

---

Installation Steps

• Steps 1 to 6 are required for PPJF PotPlayer launcher.

0. Download PPJF.zip

Download PPJF for Jellyfin 10.7 or the latest for Jellyfin 10.11.+ : PPJF.10.11.6.zip

1. Place Required Files

• Extract and move the PotPlayerJellyfin folder to :

  C:\ProgramData\
  

If you put it anywhere else, adapt any lines with your own path.

so you should have C:\ProgramData\PotPlayerJellyfin
With the files in it.

2. Install PotPlayer

• No need to reinstall if already installed
• Default path: C:\Program Files\DAUM\PotPlayer

3. Install LibreWolf (a lighter and Privacy optimised Firefox) or Firefox

- Not tested with Chrome – using LibreWolf is recommended and easier for the optionals in this setup.
- You can install multiple Firefox/LibreWolf/Nightly/Any fork on the same computer. I strongly recommend to install LibreWolf separately from your main browser.
This way you can launch Jellyfin directly in full-screen mode and/or hide the browser menu bar, as well as enabling separate configurations such as a default zoom of 120%, differents firefox addons for this browser etc...
This also allows to use the Optional feature to start Jellyfin server automatically while launching the web interface and to stop jellyfin server after closing the window.
"Local Filesystem Links extension" needed for the optional links feature have minors security flaws and display a notification in private mod, I recommend not to use your main browser with it.

• Install LibreWolf (or any Firefox fork that supporting ViolentMonkey/TamperMonkey extension). https://librewolf.net/installation/windows/
• Default path: C:\Program Files\LibreWolf
• if you want to use the optionals with your current browser or a different one, don't forget step 10

4. Install ViolentMonkey and my scripts

• In Librewolf or own browser, install ViolentMonkey extension https://addons.mozilla.org/fr/firefox/addon/violentmonkey/
• Settings → Extensions → ViolentMonkey → click on the three dot → click option
• Go to intalled Scripts
• Click on + , then click new
• The editor window will open with some default metadata for the script. Delete all the lines of the default code. Don't Close.
• Go to C:\ProgramData\PotPlayerJellyfin\
• Open OpenWithPotplayerUserscript.js with notepad to edit it, select all, copy
• Paste all into the ViolentMonkey editor page you just kept open in LibreWolf.
• Click Save and Exit on upper right corner
• If your Jellyfin Server is not set the default adress http://localhost:8096/ Edit the .js scripts to replace http://localhost:8096/ with your Jellyfin web URL, for exemple :

  // @match        http://192.168.1.10:8096/*
  

Don't forget the * at the end.

Note : The .js userscript can be put in Jellyfin JavaScript Injector plugin instead, but every play buttons in Jellyfin Web won't work anywhere else without PPJF.

• Optional : If you want Local Files Links in jellyfin media info
  • Do the same in ViolentMonkey, +, new, delete all the lines, but copy/paste from the file OpenMediaInfoPathScriptmonkey.js, save and exit.

5. Enable PowerShell Scripts Execution to allow potplayer.ps1 (Windows)

• In Windows 11, go to, Settings → Developers → PowerShell → Allow unsigned scripts
• Or if you can't find it :
  • Search for PowerShell in the Start menu, right-click it, and select Run as Administrator.
  • Type the following command and press Enter:

  Set-ExecutionPolicy RemoteSigned
  

• Or

  Set-ExecutionPolicy RemoteSigned -Force
  

6. Apply PotPlayer Registry Settings

• Run potplayer.reg and confirm changes.
• You may need to re-run potplayer.reg after major Potplayer Updates.
• The next steps are optional, but I recommend checking them out for quality-of-life improvements
• You can test if it works already. If not, see Workaround below.
• Done !

Optionnal : Hide the Powerscript window at Potplayer launch

• Install-PPJF-HiddenProtocol.ps1 must be in your default PotPlayerJellyfin folder.
• It require VBScript installed (may not be installed by default on all Windows 11 installation)
• Run the file `Install-PPJF-HiddenP