MCPcopy Index your code
hub / github.com/ban-heesoo/NewSync

github.com/ban-heesoo/NewSync @release-2.6.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release release-2.6.0 ↗ · + Follow
589 symbols 1,463 edges 48 files 69 documented · 12%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

NewSync

Cover

Screenshots

Player Page Screenshot Artwork Fullscreen Screenshot 1 Artwork Fullscreen Screenshot 2 Artwork Fullscreen Screenshot 3 Artwork Fullscreen Screenshot 4

Extension for Synchronized Lyrics on YouTube Music

NewSync is a browser extension that brings synchronized lyrics to YouTube Music with an Apple Music-inspired interface.

Installation

Install from Source

For Chrome Users, Developers & Advanced Users

Requirements:

For Chrome, Vivaldi, Opera, and Brave

  1. Clone or Download the Repository: bash git clone https://github.com/ban-heesoo/NewSync
  2. Alternatively, you can download the latest release from Github Releases and extract the zip file.
  3. Open Extensions Page: Navigate to chrome://extensions/ (same for Vivaldi, Opera, and Brave)
  4. Enable Developer Mode: Toggle the "Developer mode" switch in the top right corner.
  5. Load Unpacked Extension: Click on "Load unpacked" and select the cloned repository folder.

For Firefox and Zen

  1. Clone or Download the Repository: bash git clone https://github.com/ban-heesoo/NewSync
  2. Alternatively, you can download the latest release from Github Releases and extract the zip file.
  3. Open Firefox Debugging Page: Navigate to about:debugging#/runtime/this-firefox
  4. Load Temporary Add-on: Click on "Load Temporary Add-on" and choose the manifest.json file from the repository folder.

Install from Add-ons Stores (not yet updated, wait)

Safe, easy, and get auto updates. Install NewSync directly from your browser's web store.

Microsoft Edge (Recommended):

Microsoft Edge Add-ons

Firefox (a bit lag):

Firefox Add-ons

Updating

If you have installed the extension with cloned repository, you can simply update it by running update script in the folder where you cloned the repository:

  • update.bat(for windows) or
  • update.sh(for linux)

Usage

Once installed, simply open YouTube Music and play any song. The lyrics panel will automatically be enhanced by NewSync with custom lyrics, no external API setup required (except for Gemini AI features).

  • Quick Settings: Access quick toggles by clicking the NewSync icon in your browser's toolbar.
  • Full Settings: For comprehensive customization, click "More Settings" from the popup to open the dedicated settings page.

Acknowledgments

This project is inspired by and built upon the work of talented developers:

  • Base Project: NewSync is based on the work by @ibratabian17. Special thanks for the foundation and inspiration.
  • Popup Style: The popup style is inspired by the work of @boidushya, known for creating the Better Lyrics extension for YouTube Music.

We are grateful for their contributions to the open-source community.

Core symbols most depended-on inside this repo

push
called by 127
src/lib/colorTunes.js
map
called by 69
src/lib/colorTunes.js
msg
called by 36
src/lib/i18n.js
getAttr
called by 26
src/lib/parser.js
get
called by 24
src/background/storage/database.js
_getDataText
called by 21
src/modules/lyrics/lyricsRenderer.js
showStatusMessage
called by 21
src/settings/ui.js
setCheck
called by 17
src/settings/ui.js

Shape

Function 290
Method 241
Class 58

Languages

TypeScript100%

Modules by API surface

src/modules/lyrics/lyricsRenderer.js96 symbols
src/lib/xmldom.min.js70 symbols
src/settings/ui.js53 symbols
src/lib/colorTunes.js38 symbols
src/modules/lyrics/dynamicBkg.js20 symbols
src/modules/tidal/index.js15 symbols
src/modules/lyrics/lyricsManager.js15 symbols
src/inject/ytmusic/songTracker.js15 symbols
src/background/gemini/geminiRomanizer.js14 symbols
src/background/core/lyricsService.js14 symbols
src/settings/settingsManager.js13 symbols
src/lib/parser.js13 symbols

For agents

$ claude mcp add NewSync \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page