Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Ulto85/amongGX/llms.txt

Use this file to discover all available pages before exploring further.

Launch amongGX in Under Five Minutes

The entire application is a single file — browser.py — so getting up and running requires nothing more than Python, two pip packages, and one command. Follow the steps below and you will have the Among Us-themed browser open on your desktop within minutes.
1

Clone or download the repository

Grab the single source file from GitHub:
git clone https://github.com/Ulto85/amongGX.git
cd amongGX
No build step or compilation required — the entire application is browser.py.
2

Install the Python dependencies

Install PyQt5 and its QtWebEngine module with pip:
pip install PyQt5 PyQtWebEngine
These two packages are the only runtime dependencies. If you prefer an isolated environment, create a virtualenv first:
python -m venv venv
source venv/bin/activate      # Windows: venv\Scripts\activate
pip install PyQt5 PyQtWebEngine
3

Run the browser

python browser.py
That’s it. Python executes the script, Qt initialises, and the browser window opens.
4

The Among Us fan page loads as your home

On first launch the browser automatically navigates to the default home page:
https://Among.robowolf.repl.co
The window title bar will read Among - <page title> (for example Among - Among Us Fan Page) as soon as the page finishes loading — this is set dynamically by the update_title slot every time a page load completes.You will also see the full toolbar across the top of the window: Home, ⤶ Back, ⤷ Forward, ⟳ Reload, the URL bar, and the four quick-link buttons — Discord, , (Steam), and 👍.

Entry Point

The bottom of browser.py contains the standard Qt application bootstrap that starts everything:
app = QApplication(sys.argv)
app.setApplicationName("Among")
window = MainWindow()
app.exec_()
LineWhat it does
QApplication(sys.argv)Creates the Qt application object and hands it any command-line arguments
app.setApplicationName("Among")Sets the OS-level application name to "Among"
window = MainWindow()Instantiates the main window, builds all UI, and calls self.show()
app.exec_()Enters the Qt event loop — the call blocks until the window is closed

Your First Navigation

Once the browser is open, try the following:

Typing a URL

Click the URL bar, type an address, and press Enter. You can type with or without a scheme:
google.com
If you type a URL without a scheme (e.g. google.com instead of http://google.com), amongGX automatically prepends http:// for you. The navigate_to_url method checks q.scheme() == "" and calls q.setScheme("http") before loading the page.

Using the Toolbar Buttons

ButtonAction
HomeReturns to https://Among.robowolf.repl.co
Goes back one page in the browsing history
Goes forward one page in the browsing history
Reloads the current page
DiscordOpens discord.com
Opens a YouTube music link (vibe check)
Opens Among Us on the Steam store
👍Opens the creator’s YouTube channel

Next Steps

Now that the browser is running, explore the detailed usage guides:
  • Navigation controls — deep dive into the back/forward/reload/home actions and URL bar behaviour
  • Toolbar quick-links — learn more about the Discord, music, Steam, and subscribe shortcuts

Build docs developers (and LLMs) love