Skip to content

Alfredo-Sandoval/Aether

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

106 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aether

MIT License Chrome Web Store PRs Welcome

ChatGPT interface extension with ambient backgrounds, glass effects, and privacy controls. Not affiliated with OpenAI.

Quick Install

Clone the repo OR download/extract the zip -> open chrome://extensions -> enable Developer mode -> click Load unpacked and select the project folder -> pin the extension.


Features

Ambient Backgrounds

  • Built-in presets and an optional animated gradient
  • Blur control - 0 to 150px
  • Scaling - contain or cover

Interface Customization

  • Glass styles - Clear or Dimmed
  • Light/Dark modes - auto or manual
  • Quick settings - in-page panel

Privacy and Visibility

  • Privacy mode - blur chat messages and history (hover to reveal)
  • Hide upgrade prompts - remove upgrade buttons and banners
  • Hide UI elements - toggle GPTs, Sora, Today's pulse, and more

Performance and Behavior

  • Animation controls - disable background or menu animations
  • Auto-hide GPT-5 limit - hide limit popup after 5 minutes
  • Local settings - stored in storage.sync

Languages

  • English and Spanish
  • Popup strings use Chrome's extension locale.
  • Content-script strings prefer the ChatGPT UI language, then fall back to the browser language.

Privacy

  • No network calls
  • No analytics or telemetry
  • Optional sync via storage.sync

Installation

From Source (Developer Mode)

  1. Download or git clone this repository
  2. Open Chrome and navigate to chrome://extensions
  3. Enable Developer mode (toggle in top right)
  4. Click Load unpacked and select the project folder
  5. Pin the extension icon for easy access
  6. Visit https://chatgpt.com

For Developers / Distributors

To create a clean, distributable ZIP file that contains only the extension assets needed for Chromium-based browsers:

  1. Run the packaging script:

    chmod +x package.sh
    ./package.sh
  2. This generates a file named Aether-vX.X.X.zip.

  3. The ZIP includes the runtime extension files only: manifest.json, popup/background/content assets, CSS, _locales/, icons/, Aether/, and LICENSE.

  4. Repo-only files such as tests, scripts, lint configs, logs, and git metadata are intentionally excluded.

  5. Users can install the ZIP by extracting it and loading the folder in Chrome (Developer Mode -> Load Unpacked).

UI Audit and Screenshots

Use the built-in Playwright audit to capture popup screenshots and run dynamic UI checks:

npm run ui:audit:popup

To make popup warnings fail the run, append:

npm run ui:audit:popup -- --fail-on-warning

For live ChatGPT checks (requires a loaded ChatGPT UI in the launched browser context):

npm run ui:audit

Artifacts are written to .tmp/ui-audit/<timestamp>/:

  • report.json - run metadata, geometry checks, and warnings
  • popup-*.png - popup states (tabs, search, dropdowns, sliders)
  • chatgpt-*.png - quick-settings screenshots when available

Usage

Basic Controls

  • Extension popup - open full settings
  • Quick settings - gear icon on ChatGPT pages
  • Background presets - dropdown in settings

Key Features

  • Privacy Mode - blur chat content for privacy; hover to reveal
  • Glass Style - Clear or Dimmed

Tips

  • Settings sync across devices if Chrome sync is enabled
  • Use Quick Settings for frequent changes
  • Disable animations on older hardware

Permissions

"permissions": ["storage"],
"content_scripts": [{
  "matches": [
  "https://chatgpt.com/*",
  "https://chat.openai.com/*"
]}]
  • storage - remember your settings and preferences
  • content script matches - run only on ChatGPT pages

No data leaves your machine. All processing is local.


Technical Details

Architecture

  • Manifest V3 - MV3 service worker + storage APIs (manifest.json)
  • CSS-driven glass and blur - backdrop-filter/filter in CSS; JS only toggles classes/vars
  • No page-script injection - DOM/CSS injection plus lightweight extension-side navigation hooks
  • Centralized defaults - defaults in background.js (popup caches/fallbacks)
  • Dual-layer background - layer swap/crossfade for smooth transitions

Browser Compatibility

  • Chromium-based browsers with MV3 (Chrome/Edge/Brave/Opera)
  • Not tested on Firefox/Safari
  • Glass effects require backdrop-filter support
  • Known compatibility: Works in Perplexity Comet; does not work in ChatGPT Atlas Browser

License

Licensed under the MIT License.

See LICENSE file for details.


About

A beautiful, customizable ChatGPT interface extension with ambient backgrounds and glass effects

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors