• JavaScript 52.5%
  • CSS 30.1%
  • HTML 15.9%
  • Batchfile 1.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-15 12:51:43 -07:00
music Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
icon_512.png Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
index.html Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
LICENSE Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
license.txt Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
liscence.txt Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
Loading.gif Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
manifest.json Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
next.png Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
open-player.bat Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
play.png Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
prev.png Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
README.md Add README with setup and usage instructions 2026-07-15 12:51:43 -07:00
script.js Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
stop.png Initial open-source release under MIT 2026-07-15 12:50:55 -07:00
style.css Initial open-source release under MIT 2026-07-15 12:50:55 -07:00

Opera GX Background Music Mod

A custom Opera GX mod that adds background music, plus a small local player UI for previewing tracks.

Features

  • Opera GX mod package (manifest.json) with background music payload
  • Local web player (index.html) with play/pause, previous, and next controls
  • Track loading overlay and persistent playback state via localStorage

Requirements

  • Opera GX installed
  • This project downloaded or cloned locally

How to Use in Opera GX

  1. Download this repository as ZIP and extract it, or clone it:
    git clone https://github.com/lyxxis/OperaGX-BackroundMusic.git
    
  2. Open Opera GX.
  3. Go to Mods and choose to load/import a local mod (Developer/Local mode).
  4. Select the project folder that contains manifest.json.
  5. Enable the mod.

Note: The mod currently points to:

  • music/TrackTwo.mp3

This is configured in manifest.json under:

  • mod.payload.background_music

Use the Local Player (Optional)

You can preview music locally in your browser.

Option 1: Run batch file (Windows)

  • Double-click open-player.bat

Option 2: Open directly

  • Open index.html in your browser

Customize Tracks

Update Opera GX mod track

Edit manifest.json:

"background_music": [
  "music/TrackTwo.mp3"
]

Replace the file path with your own track in the music/ folder.

Update local player playlist

Edit script.js and change the playlist array, for example:

const playlist = [
  { title: "Track 1", src: "music/TrackOne.mp3" },
  { title: "Track 2", src: "music/TrackTwo.mp3" }
];

Project Structure

  • manifest.json: Opera GX mod manifest
  • music/: audio files used by the mod/player
  • index.html, style.css, script.js: local preview player
  • open-player.bat: convenience launcher for the local player
  • LICENSE: MIT license

License

MIT License. Attribution is preserved through the included copyright and license notice.