opus-nt/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.**

## Prerequisites
* **Python:** https://www.python.org/downloads/ (Get 3.8.* if you're on 7, devs are soy)
* **colorama:** `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](#notes))

## How to use - simple
Run `run.bat`. It will use AdvancedRun (make sure it's in %path%) to execute Python, 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.

The spawned Python windows will only stay open if there is an error. So if the windows don't close instantly and actually show some progress, it's likely fine. 

Note that you may have to edit run.bat depending on your configuration.

### 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/TrustedInstaller. Arguments work like this: `arg="value"`. If working with .WIMs, make sure [wimlib](https://wimlib.net/) 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:
(This entire mode is currently untested and unsupported)
* **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.