Installation
Web version (userscript)
Unbanded installs as a userscript in your browser. It runs on band.us and band.site.
- Install the Tampermonkey extension (Chrome/Edge/Firefox) or Greasemonkey.
- Download
unbanded.user.jsfrom the GitHub releases. - Open the file: Tampermonkey offers installation. Confirm.
- Open
https://band.usand log in. The ⚙ button appears in the header.
Shortcuts: Ctrl+, opens settings, Esc closes.
Updating (web)
Just replace the userscript with the new version from the releases. Data (plugins, themes, CSS, options) is stored in localStorage under the btt: prefix and is preserved.
Windows desktop version (patcher)
For the BAND desktop app (Electron), use the Windows patcher. It injects the userscript into app.asar and forces full mode (no demo mode).
- Download the patcher from unbanded-windows releases (or build from source).
- Run
UnbandedPatcher.exeas administrator (required to write toProgram Files). - Click Detect — the patcher looks for BAND at
C:\Program Files\BAND. Adjust the path manually if needed. - Click Patch. A backup of
resources\app.asaris created (app.asar.unbanded-backup), then the asar is extracted, patched and repacked. - Launch BAND normally. Unbanded is now active in the desktop client.
To revert: click Unpatch to restore the original
app.asar from the backup.See the Patcher page for details, security notes and limitations.
Prerequisites
- Modern browser with Tampermonkey (web version).
- For building from source: Node.js (for
node build.js) and Python 3 (tools). - For the patcher: Python 3 + Tkinter (included), admin rights, and BAND installed.