1 files changed, 130 insertions, 0 deletions
diff --git a/Src/installer/winamp/Readme.txt b/Src/installer/winamp/Readme.txt
new file mode 100644
index 00000000..a7f90550
--- /dev/null
+++ b/Src/installer/winamp/Readme.txt
@@ -0,0 +1,130 @@
+Winamp Installer (NSIS)
+
+Author: Eddy Richman
+Date: 9 June 2022
+Revised: 26 June 2022
+Copyright: Winamp SA, c. 1997-2022
+
+
+Compilation instructions
+========================
+
+The easiest way to achieve success is to ensure all required Winamp files/folders are in the same parent directory.
+
+
+1. Copy the required files from Winamp-Desktop
+
+Copy the following folders/files to the Output Dir, which in the case of the Winamp 32-bit release package is:
+
+..\..\..\..\Winamp_x86_Release
+
+
+All the files must be in the correct subfolders!
+
+(maybe we can create a batch file or add this process to e.g. winampAll PostBuildEvent?)
+
+
+- installer\winamp
+- installer\shared
+- resources\data
+- resources\license
+- resources\skins
+		- Note: "Nokia" subfolder is not required
+- resources\libraries
+		- All files are required, EXCEPT:
+		- atl90.dll, msvcp90.dll, msvcr90.dll, Microsoft.VC90.ATL.manifest, Microsoft.VC90.CRT.manifest
+- resources\plugins\dsp_sps.dll
+- resources\media\demo.mp3
+- resources\media\winamp.m3u
+
+_________________________________________________________________________
+
+Note:
+=====
+
+resources\languages dir is only required for running specific international builds.
+
+With a couple of exceptions (en-us & pl-pl), all the lang packs need updating.
+So we are currently only providing the en-us version (for v5.8 and v5.9).
+
+To create e.g. Winamp59_final_full_all.exe or Winamp59_final_full_fr-fr.exe,
+the scripts in the Mastering folder need updating accordingly first...
+which is something I'm currently working on... *gulp*
+
+_________________________________________________________________________
+
+
+2. Make sure the required NSIS plugins are present
+
+Extract the dll files from: %GitHub%\Radionomy\Nullsoft\nsis\nsis_plugins.zip
+into the NSIS plugins folder, which by default will be found at:
+%ProgramFiles%\NSIS\Unicode\Plugins\x86-unicode
+
+_________________________________________________________________________
+
+
+3. Digital Signing
+
+winamp.exe, winampa.exe, Elevator.exe & reporter.exe
+all need to be digitally signed before we create the final public distribution package.
+
+The scripts in Mastering\Winamp would normally do this, but they need updating first.
+Note that the Mastering scripts were written by previous devs (iirc, Justin, Francis, Benski, Maksim), and not by me.
+
+Codesign\sign.cmd can be used (and would be used by any mastering script),
+but for manual signing, it's much easier to use DigiCertUtil.exe
+
+If you've already run DigiCertUtil.exe from Winamp-Desktop\codesign, then (unless you hack the registry), afaict, that's where it will always run from!
+
+a) Copy winamp.exe, winampa.exe, Elevator.exe & reporter.exe from the "Winamp_x86_Release" root folder to the "Winamp-Desktop\codesign" folder
+b) Open Winamp-Desktop\Codesign\DigiCertUtil.exe
+c) Select: "Code Signing" on the left - and the valid cert (Winamp SA, 13-Jun-2024, 08d4bf5a529c725997e0f6c526495d2f, DigiCert)
+d) Note: If not already done so, you might need to install the cert first, so click the Install Cert button
+e) Click the "Sign Files" button
+f) Checkmark "Add a timestamp to the sig" if not already checked.
+g) Click "Add Files" and use ctrl+click to add the 4 x *.exe files in a)
+h) Click "Sign"
+i) When done, close DigiCertUtil
+j) cut+paste the 4 signed .exe files back into the "Winamp_x86_Release" root folder
+
+k) Repeat the above process for the installer file after step 5.
+
+So this is a bit of a shemozzle, but again, the updated scripts in Mastering will (eventually) automate the process.
+
+_________________________________________________________________________
+
+
+4. Create .wbm files
+
+   Copy "Mastering\Winamp\build_wbm_2022.cmd" to the root of Winamp_x86_Release
+   Run "build_wbm_2022.cmd" to generate the System\*.wbm files
+
+   - Note: .wbm = Lazy-load Wasabi Manifests
+   - This makes the respective .w5s files only load when required and not at Winamp startup.
+
+   IMPORTANT
+   =========
+
+   The .wbm files need to be recreated every time new .w5s files are built!
+
+_________________________________________________________________________
+
+
+5. Create the installer
+
+   - Open in Notepad or similar: Winamp_x86_Release\installer\winamp\make_full_installer_2022.bat
+   - Make sure the path to NSIS\makensis is correct
+   - Run: make_full_installer_2022.bat
+
+
+Notes
+=====
+
+The generated filename will be: Winamp_x86_Release\installer\winamp\$%INSTALL_NAME%_full.exe
+Rename to e.g. Winamp59_9999_beta_rc1_en-us.exe or Winamp59_9999_final_full_en-us.exe, etc.
+
+Again, this is something the updated scripts in Mastering will do automatically...
+
+_________________________________________________________________________
+
+END