==============================================================================
NexusStack BETA v0.7 Public Preview - Installation & Setup Instructions
File date : January 1, 2026

See https://nexusstack.org/ for online help, resources and versions.
License : Not for commercial use! - Private use only, unless authorised by us
==============================================================================


REQUIREMENTS:
=============

=> PowerShell 7.x or later (download from: https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-windows?view=powershell-7.5)
- I used PowerShell-7.5.4-win-x64.msi

=> PSSQLite PowerShell module (Automated download and installation during first run)
=> FFmpeg (for video transcoding and album art extraction) - (Automated download and installation during first run)
=> Ghostscript (optional, for PDF thumbnail generation) - download from: https://ghostscript.com/releases/gsdnld.html
=> TMDB API key (optional, for movie poster fetching) - get free key at: https://www.themoviedb.org/settings/api
- Use the second set of key (The smaller set of keys down below) and paste it into your PSMediaLibrary.conf "TMDB_APIKey" section

INSTALLATION STEPS:
===================

Install PowerShell 7.x if not already installed

FIRST RUN SETUP:

1. Run the script once: .\PSMediaLibrary_v0.7.ps1
2. The script will create a PSMediaLibrary.conf file
3. Close the script (Ctrl+C)
4. Edit PSMediaLibrary.conf to configure:

- Media folder paths (MoviesFolder, MusicFolder, PicturesFolder, PDFFolder)
- ServerPort (default: 8182)
- TMDB_APIKey (if fetching movie posters, optional, but nice to have of course)

Save the configuration file

5. Run the script : PSML_OpenFirewall.ps1 to open your Windows firewall and access on the desired port

RUNNING THE APPLICATION:
========================
Interactive mode: .\PSMediaLibrary_v0.7.ps1
or Silent mode (just start server): .\PSMediaLibrary_v0.7.ps1 -Silent
or Auto-scan and start: .\PSMediaLibrary_v0.7.ps1 -AutoScan -StartServer
Access web interface at: http://YourServerIP:8182 (or your configured port)

NOTES:

- Run this in PowerShell if the script won't run for security reasons or if it prompts you to run this script as an admin
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process .\PSMediaLibrary_v0.7.ps1

- To force the first time the script to run in PS 7.x, use this command
pwsh -ExecutionPolicy Bypass -File .\PSMediaLibrary_v0.7.ps1

- The script must be installed in the root folder of a drive (C, D, E..) and the folder must be named : "PSMediaLibrary"
Music artwork will be exported as pictures
Videos temporally cache will copy files (It will delete them when videos are no longer streaming, but still)
Videos posters will be stored as images too
PDF preview images will also be stored locally
- First scan may take time depending on library size
- PDF thumbnails require Ghostscript or Windows 10+
- Video transcoding automatically handles MKV/AVI/MOV formats
- We recommend streaming MP4 videos files. As these do not have any performance impact of your computer running the NexusStack web server
- Converting MKV and other non stream able videos files will have a considerable impact on your CPU and electricity bill.
- We will release later a conversion script to transform MKV to MP4 videos.



