This tutorial explains how to:

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

Optional :  One click link to the corresponding media local folder from the Jellyfin media information panel.

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

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

• Standalone and/or replace Steps 13. 14. 15. 16. 17. that are for manual installation of an older version of JellyfinServiceAutomation
• Start and stop the Jellyfin server automatically at launching the interface and closing it.
• 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

• Steps 1 to 6 are required.

Download PPJF.zip

• 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.

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

- Not tested with Chrome – using LibreWolf is recommended and easier for 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 fork that supporting ViolentMonkey/TamperMonkey extension). https://librewolf.net/installation/windows/
• Default path: C:\Program Files\LibreWolf
• if you want to use with your current browser or a different one, don't forget step 10

• In Librewolf, install ViolentMonkey extension https://addons.mozilla.org/fr/firefox/addon/violentmonkey/

• Librewolf → 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 :

  javascript
  // @match        http://localhost:8096/web/index.html
  
  

• 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.

• 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
  

• 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.
• Done !

• Your NAS/network drives must be mount with a letter like D:\ E:... in Windows.
• Edit "potplayer.ps1" located in C:\ProgramData\PotPlayerJellyfin
  • At the end of the file, just before : echo "Chemin normalisé : $path"
  • Add this line : $path = $path -replace "\\share\\SHAREFOLDER\\", "D:"
  • In this, change "\\share\\SHAREFOLDER\\" with the start of the the wrong path shown if you click on "more info" when Potplayer fail to launch the media from Jellyfin, It should be the part of the path that appear in "more info" but not in the Windows explorer path of your movies.
  • Add double backslash \\ instead of single backslash \ in your own path, they are essential
  • Replace "D:" with the drive letter of your NAS or drive in Windows.
  • For exemple $path = $path -replace "\\share\\_MEDIA\\", "D:" That works for everything located in my NAS mounted as the D: drive in Windows, so D:\FILMS, D:\SERIES etc. "\\share\\\_MEDIA\\" depends of your NAS/drives configuration (see "more info" in Potplayer when it fail to launch the media from Jellyfin to identify your issue)

• For the browser to remember your session settings and passwords.
• In Librewolf, go to settings, then Privacy & Security on the left side panel
• Cookies and Site Data, click on manage exeption
• In the new box, add http://localhost:8096/ (default) or your Jellyfin server URL
• Save changes
• Now go to LibreWolf on the left side panel
• Uncheck ResistFingerprinting

• Only if you want to use Jellyfin in Full-screen mod and still be able to see the Windows Task bar
• In LibreWolf
• Type about:config in the adress bar, agree if ask anything
• In the new page, search, type : full-screen-api.ignore-widgets
• It should be false
• Double click on it so you see it as true

  full-screen-api.ignore-widgets true
  

• Install Auto Fullscreen extension by tazeat. https://addons.mozilla.org/en-US/firefox/addon/autofullscreen/

• Edit Jellyfin.bat OpenMediaInfoPathScriptmonkey.js & OpenWithPotplayerUserscript.js

• Those files are set to LibreWolf default path and Jellyfin Server default URL : http://localhost:8096 and librewolf.exe path C:\Program Files\LibreWolf\librewolf.exe Potplayer path C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe

• If you use those settings, default settings, skip to 7.

• If not, edit the files.

• In Jellyfin.bat modify it for your LibreWolf/Firefox path, process name (Firefox.exe or LibreWolf.exe), and Jellyfin URL:

  curl -s http://localhost:8096 > nul
    if %errorlevel% neq 0 (ping -n 1 -w 100 127.0.0.1 > nul & goto waitForServer)
    start "" "C:\Program Files\LibreWolf\librewolf.exe" -url "http://localhost:8096/web/index.html#/home.html"
  
    tasklist | find /i "librewolf.exe" >nul
  

• If your Jellyfin Server is not set the default adress http://localhost:8096/ Edit the two .js scripts to replace http://localhost:8096/ with your Jellyfin web URL :

  javascript
  // @match        http://localhost:8096/web/index.html
  
  

Jellyfin.bat detects when there is no more "LibreWolf.exe" process running, then it stop Jellyfin server service process.

• potplayer.ps1 support all A-Z local drive, it may need edit if you use network drives
• If you use a different Potplayer installation path, modify the last line that is set to PotPlayer defaut installation folder C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe

--- Security Notice ---

• For the Optional local folder link, you need to install "native-app-setup.exe" and the firefox extension "Local Filesystem Links" by austrALIENsun, AWolf GitHub Repository

• If you have security concerns, feel free not to install it.

• I have no affiliation with this extension or its creators.

• Use a separate LibreWolf/Firefox installation to minimize risks.

• LibreWolf, Install Local Filesystem Links extension from:

  • https://addons.mozilla.org/fr/firefox/addon/local-filesystem-links/
  • Or GitHub Repository

• If not already done when asked during the addon installation, Install LienExplorerFirefoxnative-app-setup.exe (for local file explorer links). https://github.com/AWolf81/webextension_local_filesystem_links-native-host-binaries/raw/master/win32/native-app-setup.exe

• Go to Extensions settings in the settings page, then Local Filesystem Links, Option

• Uncheck the first box, check the second if you also want a folder icon next to the folder paths

• Check "Reveal link (open containing folder)"

• Install Jellyfin Server as a service
• Choose “Install as a Service” during the installation process
• Default path

If it don't work with your already saved Jellyfin settings, you can reset some settings by deleting files in C:\ProgramData\Jellyfin\Server\config like network.xml and maybe other files too idk. /!\ This will reset your server settings /!\

• For auto-install, cleaner solution, no console popup window, all major browsers support, possibility for custom .bat at launch, notifications : Download and follow the instructions from the Readme in : WIP.JellyfinServiceAutomation.zip
• Next Steps 13. 14. 15. 16. 17. are for manual installation of an older version of JellyfinServiceAutomation
• Search and Open for Services. in the windows start menu. Or Press Win + R, type services.msc, and press Enter.
  • Scroll down to find Jellyfin in the list.
  • Right-click it and select Properties.
  • In the Startup type dropdown, select Manual. (so it will start only via shortcut and not at the system boot)
  • Click Apply and then OK.
  • This should be done again after each Jellyfin Server Updates

Everytime you launch Jellyfin service with a shorcut, there is an admin window, to prevent that :

• Go to C:\ProgramData\PotPlayerJellyfin
• Right-click the shortcut "Jellyfin" and select Properties.
• Click Advanced... and check Run as administrator.
• Apply and save changes.

• Run Windows Task Scheduler
• On the right panel, click import a task
• In the window, select the XML file JellyfinUAC.xml located in C:\ProgramData\PotPlayerJellyfin\
• In the new windows, click Users or groups, then find your UserName, you can type your windows Username in the box then click Verify, then OK
• You can customize other settings if you want but it should work like that.
• Save & exit

• Go to C:\ProgramData\PotPlayerJellyfin
• JellyfinUAC is the main shorcut, DO NOT MOVE IT.
• Right click on it, copy, then go to C:\ProgramData\Microsoft\Windows\Start Menu\Programs
• There, right click and "paste as shorcut"
• Now, you can right click on it and Send to Desktop (Create a shortcut)
• Or Right click on it, copy, then "paste as shorcut" anywhere you want, rename it and change the icon.
• if you want to make it looks like an app, without any tabs and firefox bars edit the .bat and add -kiosk at the line 16 next to -url
  • -kiosk don't work with local file links and prevent from using new tabs or 18. Bonus, and need ALT+F4 or right click close to exit, use Step 8 and 9 instead

• On your desktop, right click, new shortcut, enter : "C:\Program Files\LibreWolf\librewolf.exe" http://localhost:8096/web/index.html#/home.html
• Or if you want to make it looks like an app, without any tabs and firefox bars, add -kiosk : "C:\Program Files\LibreWolf\librewolf.exe" -kiosk http://localhost:8096/web/index.html#/home.html
  • -kiosk don't work with local file links and prevent from using new tabs or 18. Bonus, use Step 8 and 9 instead
• Name it Jellyfin, on the new icon shortcut, right click, change icon, Browser... , C:\Program Files\Jellyfin\Server, select the icon
• For having jellyfin icon instead of LibreWolf in the Windows taskbar, go C:\Program Files\LibreWolf and do the same with LibreWolf.exe
• Or you can just Bookmark Jellyfin or make it the start page of Librewolf

• Swift Selection Search by Daniel Lobo https://addons.mozilla.org/fr/firefox/addon/swift-selection-search/ With this extension, when you select a text in the browser, like a movie title or the name of an actor, a box appear with the logo of websites.
• Click on it and it automatically go to a new tab and search on the website the selected text You can Add IMDB, Youtube, Wikipedia, Steam, Google Maps, translators, lots of legal websites, or you can customize to any website search you want in the extension settings...

• potplayer.ps1 : Do not delete. Main Script.
• potplayer.reg : Do not delete. You may need to run it again, especially after a Potplayer Update.
• OpenWithPotplayerUserscript.js : backup file of the main browser script, it's in ViolentMonkey in your browser
• OpenMediaInfoPathScriptmonkey.js : backup file, it's in ViolentMonkey in your browser, only needed for local links
• Jellyfin.bat, Jellyfin, JellyfinUAC, JellyfinUAC.xml : Only needed for the server start and stop and and shortcuts without WIP.JellyfinServiceAutomation.zip

• Sometimes if it stop working, because of idk, PotPlayer updates or some specific settings change, just re-run potplayer.reg . Should be fine but if it happens too often, you can add a line or create .bat to run PotPlayerMini64.reg everytime or at system startup.
• Workaround for some NAS and network drives : Edit "potplayer.ps1" located in "C:\ProgramData\PotPlayerJellyfin"
  • At the end of the file, just before : echo "Chemin normalisé : $path"
  • Add this line : $path = $path -replace "\\share\\SHAREFOLDER\\", "D:"
  • In this, change "\\share\\SHAREFOLDER\\" with the start of the the wrong path shown if you click on "more info" when Potplayer fail to launch the media from Jellyfin, It should be the part of the path that appear in "more info" but not in the Windows explorer path of your movies
  • Add double backslash \\ instead of single backslash \ in your own path, they are essential
  • Replace "D:" with the drive letter of your NAS or drive in Windows
  • Your NAS/network drives must be mount with a letter like D:\ E:\ ... in Windows.
  • For exemple $path = $path -replace "\\share\\_MEDIA\\", "D:" That works for everything located in my NAS mounted as the D: drive in Windows, so D:\FILMS, D:\SERIES etc. "\\share\\\_MEDIA\\" depends of your NAS/drives configuration (see "more info" in Potplayer when it fail to launch the media from Jellyfin to identify your issue)
• [Start and stop the Jellyfin server] Go to Windows services.msc Jellyfin Startup type Manual after each Jellyfin Server updates.
• If you use the Firefox extension Dark Reader , it breaks Jellyfin pictrures loading in browsers, desactivate it only for jellyfin : Go into Dark Reader settings while you have the Jellyfin page open (firefox menu bar), click to uncheck Jellyfin URL.

• Visit: Jellyfin Forum Thread or DM me https://forum.jellyfin.org/u-damocles
• GitHub https://github.com/Damocles-fr/PPJF/