Extension Installation Guide

ugiAuth is a Chromium-based browser extension. Follow the steps below to install it on Chrome, Edge, Brave, Opera, and other compatible browsers.

Download Extension Open Web Panel

Before you install

A few requirements ensure the extension works smoothly.

Supported browsers: Google Chrome, Microsoft Edge, Brave, Opera, Opera GX, Vivaldi, Arc, and other Chromium-based browsers. Firefox and Safari are not supported. We recommend using an up-to-date browser version.

Manual installation (.crx file)

If no store link is available or you prefer manual setup, download the .crx file and follow the browser-specific steps below.

Some browsers may block direct .crx installation for security. In that case, rename the file to .zip, extract it, then use «Load unpacked» and select the folder.
Ch

Google Chrome

Google Chrome
  1. Download the .crx file using the «Download Extension» button above.
  2. Type chrome://extensions in the address bar and press Enter.
  3. Enable «Developer mode» in the top right.
  4. Drag the downloaded .crx file onto the extensions page.
  5. Click «Add extension» in the confirmation dialog.
  6. If drag-and-drop fails, rename to .zip, extract, then use «Load unpacked» and select the folder.
Ed

Microsoft Edge

Microsoft Edge
  1. Download the .crx file.
  2. Type edge://extensions in the address bar.
  3. Enable «Developer mode» from the left sidebar.
  4. Drag the .crx file onto the page, or use «Load unpacked».
  5. Confirm the installation.
Br

Brave

Brave
  1. Download the .crx file.
  2. Type brave://extensions in the address bar.
  3. Enable «Developer mode».
  4. Drag and drop the file, or extract as zip and use «Load unpacked».
  5. Brave also supports Google extensions; you can install from the Chrome Web Store.
Op

Opera / Opera GX

Opera / Opera GX
  1. Download the .crx file.
  2. Type opera://extensions in the address bar.
  3. Enable «Developer mode».
  4. Drag and drop the .crx file.
  5. Opera can also install Chrome extensions: use «Go to Chrome Web Store» on the opera://extensions page.
+

Other Chromium browsers

Vivaldi, Arc, Chromium
  1. Vivaldi: vivaldi://extensions — enable Developer mode, then drag-and-drop or load unpacked.
  2. Arc and other Chromium forks: usually chrome://extensions or their own extensions page with the same steps.
  3. Remember to pin the extension to your toolbar in every browser.

After installation

Once installed, you will be ready to use the extension in a few minutes.

1

Pin the extension

Click the extension icon in the browser toolbar and enable «Pin». This gives you one-click access.

2

Add your first account

Click the extension icon, use «Add QR» to scan a verification QR code, or enter details manually.

3

Sync with the web panel

Optional: register from the extension; your codes will also appear in the web panel and be accessible from any device.

Common issues

I get «Package is invalid» or «CRX_REQUIRED_PROOF_MISSING»

Chrome and Edge may block non-store .crx files. Rename the file to .zip, extract the archive, then on the extensions page use «Load unpacked» and select the extracted folder.

The extension icon does not appear

Make sure ugiAuth is enabled on the extensions page. Click the puzzle icon in the toolbar and pin ugiAuth.

The extension does not update after installation

Manual installs do not auto-update. When a new version is released, download and install again from this page. Store installs update automatically.

QR code scanning does not work

QR scanning only works on the active tab. Open the service's 2FA setup page, click «Add QR» in the extension, and scan the code on the page. Alternatively, enter the secret key manually.

About Firefox and Safari

ugiAuth is a Manifest V3 Chromium extension; it is not compatible with Firefox (.xpi) or Safari. You can use the web panel on those browsers, or switch to a Chromium-based browser.

Ready to install?

Download the file, follow the steps above, and start managing your verification codes in minutes.

Download Extension