ChatGPT PWA using native Gecko Web Apps in LibreWolf; Arch Linux packages hosted on Forgejo
  • Python 55.5%
  • Shell 26.7%
  • JavaScript 12%
  • CSS 4.5%
  • Fluent 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-31 13:57:20 +03:00
packaging Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00
scripts Build releases in fresh directories to avoid stale raw-source cache 2026-10-31 13:46:31 +03:00
.gitignore Use FirefoxPWA with standalone ChatGPT UI, native theme and discrete GPU 2026-10-31 13:45:31 +03:00
boot.sys.mjs Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00
branding.ftl Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00
chatgpt-librewolf Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00
chatgpt-librewolf.desktop Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00
chatgpt-librewolf.png Use FirefoxPWA with standalone ChatGPT UI, native theme and discrete GPU 2026-10-31 13:45:31 +03:00
chatgpt.webmanifest Use FirefoxPWA with standalone ChatGPT UI, native theme and discrete GPU 2026-10-31 13:45:31 +03:00
ICON-SOURCE.txt Use FirefoxPWA with standalone ChatGPT UI, native theme and discrete GPU 2026-10-31 13:45:31 +03:00
LICENSE Package ChatGPT as a native LibreWolf Gecko Web App 2026-10-31 13:28:23 +03:00
README.md Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00
userChrome.css Brand app identity, icons and authentication windows as ChatGPT 2026-10-31 13:57:20 +03:00

ChatGPT PWA

ChatGPT as a standalone PWA, powered by PWAsForFirefox with LibreWolf as its Gecko runtime on Linux Wayland. The launcher prepares an isolated copy of the distribution's prebuilt LibreWolf for FirefoxPWA and opens the installed ChatGPT site. No browser compilation is needed.

Install from this Forgejo

Packages are served by this repository's pacman release, independently of AUR. Download scripts/install-repo.sh and packaging/ligand-chatgpt.asc from a trusted checkout, then run:

sudo bash scripts/install-repo.sh
paru -S chatgpt-librewolf

The installation script imports the dedicated repository signing key and adds only [ligand-chatgpt] to pacman.conf. Packages are signed; signature checks remain required. LibreWolf is obtained from the distribution's repositories. LibreWolf 159 or newer, Python, and FirefoxPWA 2.20.1 or newer are required.

Development package from the same Forgejo:

paru -S chatgpt-librewolf-git

The packages conflict; install one. Both use the same dedicated app profile. Run chatgpt-librewolf or choose ChatGPT from the app menu. Sign in normally inside the app; no credentials are included in the package.

Behaviour

  • Native Wayland only, using a dedicated LibreWolf runtime managed through FirefoxPWA. Personal LibreWolf profiles are not modified.
  • Initial setup copies approximately 438 MiB of LibreWolf runtime files into the app data directory. The runtime is refreshed when the distribution's LibreWolf engine changes; this copies prebuilt files and does not compile.
  • App data lives in ${XDG_DATA_HOME:-~/.local/share}/chatgpt-librewolf/pwa; FirefoxPWA profiles are stored in its profiles/ directory.
  • On migration from version 0.1, the existing app profile is copied into the new FirefoxPWA profile to retain login and site data. The old chatgpt-librewolf/profile directory is retained for rollback. The cookie and key databases were verified unchanged in the migrated profile.
  • Login and site data persist when the app closes. LibreWolf's automatic shutdown cleanup is disabled only in this dedicated app profile.
  • FirefoxPWA handles the installed site and its application window. Authentication may open another window, depending on the provider.
  • The app window has no browser navigation or menu toolbar. KWin's native titlebar and window controls remain available, as do app permission prompts. The packaged ChatGPT icon is used by the app menu and taskbar shortcut.
  • Desktop menus, taskbar entries, app window titles, and authentication windows use the ChatGPT name and icon. LibreWolf remains the underlying engine; technical attribution is retained in this documentation and diagnostics.
  • The launcher repairs generated shortcuts so launches from pinned taskbar entries use the same theme and GPU settings as the application menu.
  • This is an unofficial launcher. ChatGPT remains an online service: offline conversations, service workers, push notifications and voice features depend on ChatGPT and Gecko support, not this package.

The package includes a snapshot of ChatGPT's official web app manifest from https://chatgpt.com/unauth-mweb/manifest.json, which declares standalone display mode. The launcher installs that snapshot through FirefoxPWA; this avoids a command-line manifest fetch being blocked by the site's protection.

Theme and GPU settings

The defaults are the system theme and the discrete GPU, when available. Personal LibreWolf settings are not changed. Configure this application in ~/.config/chatgpt-librewolf/config.json:

{"gpu": "discrete", "theme": "system"}

gpu accepts discrete, integrated, or a Mesa DRI_PRIME PCI selector, such as pci-0000_08_00_0 for the GeForce 820M in the tested laptop. theme accepts system, dark, or light. ChatGPT's own Appearance setting should be System to follow the browser theme.

Environment overrides are also supported:

CHATGPT_LIBREWOLF_GPU=integrated chatgpt-librewolf
CHATGPT_LIBREWOLF_THEME=dark chatgpt-librewolf

These settings take effect on a new application process. Close the app before changing its GPU. Native Wayland is selected with MOZ_ENABLE_WAYLAND=1; Mesa's DRI_PRIME selects the requested GPU. The launcher does not replace the driver or bypass a GPU safety blocklist. Selecting a GPU does not prove that every browser feature uses hardware acceleration.

chatgpt-librewolf --prepare-only
chatgpt-librewolf --print-command
chatgpt-librewolf --diagnostics

These commands prepare the dedicated profile, show launch arguments, and show the launch configuration. The dedicated profile disables speculative content process prelaunch and limits the process pool per isolated web origin. Memory and CPU usage depend on conversation size and page activity; this package does not impose a hard memory limit or promise a fixed reduction. Chromium/V8 command-line flags do not apply to Gecko.

Build packages

cd packaging/stable && makepkg
# Or: cd packaging/git && makepkg

These commands package the launcher; they do not compile LibreWolf. The stable package uses files from the version tag with pinned SHA-256 checksums. The development package obtains its source from this Forgejo repository.

Upstream: PWAsForFirefox and its alternative-runtime instructions.

License: MIT for this launcher. LibreWolf, Gecko and ChatGPT retain their own licenses and terms. ChatGPT names and logos belong to OpenAI.