- Python 55.5%
- Shell 26.7%
- JavaScript 12%
- CSS 4.5%
- Fluent 1.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| packaging | ||
| scripts | ||
| .gitignore | ||
| boot.sys.mjs | ||
| branding.ftl | ||
| chatgpt-librewolf | ||
| chatgpt-librewolf.desktop | ||
| chatgpt-librewolf.png | ||
| chatgpt.webmanifest | ||
| ICON-SOURCE.txt | ||
| LICENSE | ||
| README.md | ||
| userChrome.css | ||
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 itsprofiles/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/profiledirectory 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.