opus-nt

A Windows performance and usability improvement project for oldschool users and enthusiasts

Go to file

Fierelier cc712eeace Add description to mods-online		2022-06-22 07:29:50 +02:00
api	Fix up online application	2022-06-10 20:16:02 +02:00
docgen	Add """markdown""" docs	2022-01-02 20:07:01 +01:00
docs	Update docs	2022-06-22 06:34:48 +02:00
mods	Update version	2022-06-22 06:35:21 +02:00
mods-online	Add description to mods-online	2022-06-22 07:29:50 +02:00
mods-trustedInstaller	Add documentation	2022-01-02 19:59:57 +01:00
path	Example file in path\, so the folder is added.	2021-03-22 00:24:28 +01:00
.gitignore	Hide hmods-* folders	2022-06-06 10:54:12 +02:00
README.md	Add link to new documentation	2022-01-02 20:11:55 +01:00
run.bat	Example fix	2021-06-20 16:29:55 +02:00
run.py	Actually add the online parts to the main script jesus christ	2022-06-22 07:19:47 +02:00

README.md

Opus-NT

A windows homebrew kit and collection of mods. Can mod .WIM (this is where main-support is) and offline windows installations. Mods are written for 7 and up, but are likely to work with Vista and up. Certain parts are still untested, so bear with me.

DON'T RUN MULTIPLE INSTANCES OF THIS SCRIPT.

Mods

View mod documentation - Can also be viewed locally, in a browser (index.html).

Prerequisites

Python: https://www.python.org/downloads/ (Get 3.8.* if you're on 7, devs are soy)
colorama (optional): py -m pip install colorama
wimlib: https://wimlib.net/ (if working with .WIMs)
Something to run the script as SYSTEM and TrustedInstaller: There isn't much good software to do this with, especially the TrustedInstaller part. This is okay: https://www.nirsoft.net/utils/advanced_run.html -- But it's not open source (*1)

How to use - Simple

Extract both wimlib and AdvancedRun to Path\ (the folder is only added to %path% if you use run.bat). Both AdvancedRun.exe and wimlib-imagex.exe should be in the main Path\ folder, alongside their libraries.

Run run.bat. It will use AdvancedRun to execute run.py, and apply all mods to your wished for wim file. It will do two runs, one as SYSTEM, and another as TrustedInstaller. Both runs have different mods. If you want to know how it works, edit the .bat file.

If Python shows no exceptions, the script likely ran successfully.

If you want to edit offline media, or batch-process .WIMs, move on to How to use - Advanced.

Arguments:

run.bat "wimpath" 1

Replace wimpath with the path to your .wim, and 1 with the index you want to modify, * for all. Both arguments are optional, though you cannot define an index without a wim. If you run the batch without any arguments, you will be asked for some.

How to use - Advanced

Run run.py with some arguments, as SYSTEM or TrustedInstaller. Arguments work like this: arg="value". If working with .WIMs, make sure wimlib is in your %path%.

Arguments - .WIM:

wim: Point to a wim file (required)
index: Choose the index to apply to. Starts at 1, use * for all (required)
tmp: Set temporary folder

Example: run.py wim="E:\sources\install.wim" index=* - Applies tweaks to all indexes of E:\sources\install.wim.

Arguments - Offline media:

path: Point to a Windows install, likely a drive with a Windows folder (required)

Example: run.py path="D:" - Applies tweaks to D:\.

Arguments - General:

modpath: Folder to source mods from.

Example: run.py modpath="mods-trustedInstaller" wim="E:\sources\install.wim" index=* - Apply mods that require to be executed by TrustedInstaller to all indexes of E:\sources\install.wim.

Notes

*1: Blame M$. Terry said something amongst the lines of "File permissions don't belong in a user operating system" - I think it's good enough if you have a user that has permissions over everything. Vista and up do not have this, for some reason.