🇷🇺 Russian Lyrics Romanizer

A Spicetify extension that converts Russian Cyrillic lyrics into phonetic English — so you can sing along without knowing Cyrillic!

---

✨ What It Does

When you open the Lyrics view in Spotify for a Russian song, the extension automatically converts the Cyrillic text into readable phonetic English (romanization) in real time.

Before:

Я хочу, чтобы ты была счастлива

After:

Ya khochu, chtoby ty byla schastliva

• ✅ Works on Spotify's built-in Lyrics panel
• ✅ Uses a phonetic romanization standard (BGN/PCGN-based)
• ✅ Topbar toggle — switch on/off with one click, state is remembered
• ✅ Leaves non-Russian lyrics (Latin, etc.) completely untouched
• ✅ Works on Windows, macOS, and Linux

---

📦 Installation

Method 1: Spicetify Marketplace (Recommended)

The easiest way. No manual steps needed.

1. Make sure you have Spicetify and the Marketplace installed.
2. Open Spotify → click the Marketplace icon in the topbar.
3. Go to the Extensions tab.
4. Search for "Russian Lyrics Romanizer".
5. Click Install — done! 🎉

---

Method 2: Manual Installation

1. Download russian-romanizer.js from this repository.

2. Copy the file to your Spicetify Extensions folder:

   OS	Path
   Windows	%appdata%\spicetify\Extensions\
   macOS / Linux	~/.config/spicetify/Extensions/

3. Enable the extension and apply:

   spicetify config extensions russian-romanizer.js
   spicetify apply

4. Restart Spotify if it doesn't reload automatically.

---

🎛️ Usage

After installation, you'll see a Я button in the Spotify topbar:

State	Icon	Behavior
ON (default)	Я (bright)	Russian lyrics are romanized
OFF	Я (dimmed)	Original Cyrillic lyrics are shown

• Click the Я button to toggle romanization on or off.
• Your preference is saved automatically — it persists across Spotify restarts.
• A small notification pops up to confirm the toggle state.

---

🔤 Romanization Standard

The extension uses a phonetic transliteration based on the BGN/PCGN standard — optimized for readability:

Cyrillic	Romanized	Example
Е / е	Ye / ye	Ельник → Yelnik
Ё / ё	Yo / yo	Ёж → Yozh
Ж / ж	Zh / zh	Жизнь → Zhizn
Х / х	Kh / kh	Хорошо → Khorosho
Ц / ц	Ts / ts	Цветок → Tsvetok
Ч / ч	Ch / ch	Человек → Chelovek
Ш / ш	Sh / sh	Школа → Shkola
Щ / щ	Shch / shch	Щука → Shchuka
Ю / ю	Yu / yu	Юность → Yunost
Я / я	Ya / ya	Язык → Yazyk
Ъ / Ь	(silent)	Eliminated as in standard

---

🛠️ How It Works

1. Waits for Spicetify's API to be ready.
2. Adds a toggle button (Я) to the Spotify topbar.
3. Monitors the lyrics container using a MutationObserver — any time new lyric lines appear (song change, scroll), they are processed.
4. Detects Cyrillic text (Unicode block U+0400–U+04FF) and wraps each text node in a <span> storing both the original and romanized versions.
5. Toggling simply swaps between stored original ↔ romanized text — no re-processing needed.

---

🤝 Contributing

Found a bug or want to improve the transliteration? Open an issue or submit a pull request!

---

📄 License

MIT — free to use, modify, and distribute.

---

Made with ❤️ by Jyzhdev