2. Install the app
- Extract the zip anywhere you can write:
C:\Games\Nimby, a second drive, a USB stick. - Run
Nimby.exefrom that folder. - The first launch creates
data\config.jsonnext to the executable.
| Item | What it is |
|---|---|
Nimby.exe | The window you use. |
bin\nimby.exe | The command-line tool the GUI drives for every action. |
data\ | Portable configuration; holds the hash cache too. |
assets\branding\ | Logos and marks, also used by the About page. |
docs\ | This tutorial, the repository format notes, the screenshots. |
LICENSES\ | Licence texts of the third-party components. |
README.md, CHANGELOG.md | Project summary and release notes. |
LICENSE, LICENSE-ADDITIONAL-TERMS.md, NOTICE, THIRD-PARTY-NOTICES.md | Licence, attribution terms and third-party notices. |
Keep Nimby.exe and bin\nimby.exe together — the CLI sits in bin because Windows cannot hold both Nimby.exe and nimby.exe in one folder. The GUI looks for bin\nimby.exe, then nimby.exe next to itself, then on PATH; if it is missing or from another version the window cannot do anything useful. Always move or copy the whole folder.
data\ is what makes the install portable: settings, repositories and the hash cache travel with the folder. Nimby probes the folder with a real write, so if you extract somewhere read-only such as C:\Program Files it falls back to %APPDATA%\Nimby\config.json automatically. Both work; only the portable one survives copying the folder to another machine.
To uninstall, close Nimby and delete the folder, plus %APPDATA%\Nimby if you used the fallback.