Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌈 FakeNitroKeeper

A Vencord userplugin that remembers your FakeNitro client theme and brings it back when Discord silently resets it.

CI Release License Vencord TypeScript

ThemeKeeper settings in Vencord

Why?

FakeNitro unlocks Discord's client-side Nitro themes, but Discord may occasionally replace the selected appearance with the stock theme after a restart, reconnect, account switch, or settings sync.

FakeNitroKeeper adds a second, persistent layer of protection. Inside Vencord the plugin appears as ThemeKeeper.

Features

  • 💾 Saves the selected theme automatically
  • 👤 Keeps a separate snapshot for each Discord account
  • 🔄 Restores the theme after Discord reconnects
  • 🛰️ Detects remote settings updates that may overwrite local appearance
  • 🐕 Includes a lightweight watchdog for silent resets
  • 🔔 Can notify you whenever a theme is restored
  • 🪟 Includes an optional silent Windows launcher for Discord updates
  • 🔒 Stores everything locally — no telemetry and no network requests

One-click Windows build

Don't want to install Node.js, pnpm, or build Vencord yourself? Download the ready-to-use archive from GitHub Releases.

  1. Install and launch Discord Stable at least once.
  2. Download FakeNitroKeeper-v1.1.1-Windows.zip from the latest release.
  3. Extract the entire archive to a permanent folder.
  4. Fully close Discord.
  5. Run RESTORE_THEMEKEEPER.cmd.
  6. When asked, allow it to create or replace the desktop Discord shortcut.

That's it. The script installs the archived Vencord build, starts Discord, and enables ThemeKeeper automatically. Git, Node.js, and pnpm are not required.

Warning

Do not move or delete the extracted folder after installation. Discord loads the custom Vencord build directly from its dist directory.

Silent Discord launcher

The release archive includes a small Windows launcher:

  • Start-DiscordThemeKeeper.ps1 — checks whether the current Discord install still points to this Vencord build and repairs it if Discord updated.
  • Start-DiscordThemeKeeper.vbs — starts the PowerShell checker invisibly through Windows Script Host, avoiding CMD/PowerShell flashes.
  • START_DISCORD_THEMEKEEPER.cmd — visible/manual launcher for troubleshooting.
  • INSTALL_DISCORD_SHORTCUT.cmd — creates or replaces the desktop shortcut.
  • UNINSTALL_THEMEKEEPER_BUILD.cmd — uninstalls the archived Vencord build and restores the original Discord desktop shortcut.

The desktop shortcut is still named Discord and uses the original Discord icon, but its target is Windows Script Host:

wscript.exe Start-DiscordThemeKeeper.vbs

So when the user clicks the normal-looking Discord shortcut, no CMD or PowerShell window is created or flashed. The launcher silently checks Vencord first, repairs it if needed, and then starts Discord.

How it works

ThemeKeeper stores only the appearance-related part of Discord's settings protobuf. Other appearance preferences, account settings, messages, and credentials are not copied.

When Discord updates its user settings, ThemeKeeper compares the active theme with the locally saved snapshot. If Discord unexpectedly replaced it, the plugin dispatches a local partial settings update containing only:

  • the base theme;
  • clientThemeSettings;
  • the selected background gradient preset.

This avoids overwriting unrelated accessibility or appearance settings.

Requirements

Important

Vencord's official prebuilt installer cannot load arbitrary userplugins. You need a source build of Vencord, or the ready-to-use archive from Releases.

Installation from source

Open a terminal inside your Vencord source directory and run:

cd src/userplugins
git clone https://github.com/Dunterbabochka/FakeNitroKeeper.git fakeNitroKeeper
cd ../..
pnpm build
pnpm inject

Restart Discord after the build finishes. ThemeKeeper is enabled by default and automatically enables its FakeNitro dependency.

For the full userplugin installation guide, see the official Vencord documentation.

Usage

  1. Open Discord Settings → Appearance.
  2. Select any client theme unlocked by FakeNitro.
  3. Done — ThemeKeeper saves it automatically.

There is no theme picker inside ThemeKeeper itself. Its settings page only controls restoration behaviour.

Settings

Setting Default Description
Auto Restore On Restores the saved appearance after an unexpected reset
Watchdog On Checks periodically for silent theme resets
Restore Delay 1500 ms Waits for Discord settings to settle after reconnecting
Notify On Restore On Shows a Vencord notification after restoration

Updating

git -C src/userplugins/fakeNitroKeeper pull
pnpm build

Then fully restart Discord.

Troubleshooting

The plugin saved the stock theme

Select your desired theme once more in Discord Settings → Appearance. The next local appearance update replaces the saved snapshot.

ThemeKeeper does not appear in the plugin list

Make sure the file is located at:

Vencord/src/userplugins/fakeNitroKeeper/index.ts

Then rebuild Vencord and restart Discord.

Discord updated and Vencord disappeared

If you installed the ready-to-use Windows build, launch Discord through the desktop Discord shortcut created by INSTALL_DISCORD_SHORTCUT.cmd. It checks and repairs Vencord before starting Discord.

You can also run RESTORE_THEMEKEEPER.cmd manually from the extracted archive.

Uninstalling the Windows build

Run UNINSTALL_THEMEKEEPER_BUILD.cmd from the extracted archive. It removes the Vencord patch and rewrites the desktop Discord shortcut back to the original Discord launcher:

%LOCALAPPDATA%\Discord\Update.exe --processStart Discord.exe

Privacy

ThemeKeeper makes no HTTP requests and has no analytics. It stores a small theme snapshot and the corresponding Discord account ID in Vencord's local IndexedDB database under the key ThemeKeeper_snapshots.

The Windows launcher writes only a local diagnostic log to settings/themeKeeper-launcher.log inside the extracted archive folder.

Disclaimer

Client modifications are against Discord's Terms of Service. This project is not affiliated with or endorsed by Discord or Vencord. Use it at your own discretion.

License

FakeNitroKeeper is licensed under GNU General Public License v3.0 or later, matching Vencord.

The implementation builds on Vencord's public plugin APIs and the approach used by its built-in FakeNitro plugin.


Краткая инструкция на русском

Готовая сборка

  1. Скачай FakeNitroKeeper-v1.1.1-Windows.zip из раздела Releases.
  2. Распакуй архив в постоянную папку.
  3. Полностью закрой Discord.
  4. Запусти RESTORE_THEMEKEEPER.cmd.
  5. Разреши создать/заменить ярлык Discord на рабочем столе.

Ярлык будет называться Discord и использовать обычную иконку Discord, но внутри он запускает wscript.exe, который уже полностью скрыто стартует PowerShell launcher. Поэтому CMD/PowerShell-окно при обычном запуске не должно даже мигать.

Если Discord обновится и Vencord слетит, запускай Discord через этот ярлык — он сам проверит Vencord, пропатчит Discord заново и запустит его.

Для удаления запусти UNINSTALL_THEMEKEEPER_BUILD.cmd: он удалит патч Vencord и вернёт ярлык Discord на рабочем столе к оригинальному запуску через %LOCALAPPDATA%\Discord\Update.exe.

Установка из исходников

  1. Установи Vencord из исходников.
  2. Склонируй репозиторий в Vencord/src/userplugins/fakeNitroKeeper.
  3. Выполни pnpm build, затем pnpm inject.
  4. Перезапусти Discord.

После установки выбери тему в Настройки Discord → Внешний вид.

ThemeKeeper запомнит оформление автоматически и восстановит его, если Discord снова переключится на стандартную тему.

About

A Vencord userplugin that remembers FakeNitro client themes and restores them when Discord resets the appearance.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages