YT Nickname Restorer

About

This extension is inspired by 'YTid 名稱修復器'. Special thanks to 夜有風 for sharing!
==============================================================================
Project Repository (For review purposes only; please do not re-publish): https://github.com/lisheng099/YT-Nickname-Restoration-Assistant
==============================================================================

📺 YT Nickname Restorer

📖 Introduction
YT Nickname Restorer is a browser extension designed specifically for YouTube viewers. To solve the issue of YouTube replacing User IDs with unrecognizable Handles (e.g., @User-xk9lp...), this tool automatically "restores" these codes to the channel's actual display name in Live Chats and Comments.

We adhere to a "Local Operation, Privacy First" policy. All query actions are sent directly from your browser to YouTube, ensuring your browsing privacy is completely safe.

🚀 Key Features

1. Automatic Nickname Restoration

Support Range: Live Chat, Comments.

How it works: When you watch a video, the extension automatically scans for @Handle IDs on the screen and silently queries the corresponding real nickname in the background for replacement.

Dual Cache Mechanism: The system uses smart lifecycle management. Data is cached for 15 days by default, after which it is marked as expired and will automatically refresh in the background. If data is not used for more than 30 days, it will be permanently deleted from the disk to save space.

2. Smart Tooltip
Hover your mouse over the restored name to see a floating info card:

Real Name: Displays the full channel name.

Original Handle: For easy verification of the original ID.

Subscriber Badge: Displays a colored dot based on subscriber count:

🟢 Cyan: 1 Million+ (1M+)

🟡 Gold: 100k+

⚪ Silver: 10k+

🟠 Bronze: 1000+ (1k+)

🟤 Brown: Potential Channel (500+)

Expired Notice: If data hasn't been updated for a while, a prompt will appear, and the system will automatically update it in the background.

3. Advanced Settings (Click Extension Icon)

Max Name Length: Set the display character limit (Default: 20 chars) to prevent overly long names from breaking the chat layout.

Click to Copy URL: When enabled, clicking a nickname copies the channel URL directly.

Fetch Speed Control: Offers "Normal" and "Slow" modes for users to adjust based on their needs.

💾 Import & Export: The Ultimate Community Tool
This is one of the most powerful features, located in the "Cache Manager". By sharing the database (.json file), community members can help each other build a massive name database.

How to use?

Click the extension icon in the top right corner of your browser.

Click "📋 Open Cache Manager".

Find the buttons in the top right corner:

Export: Download all the names currently collected on your computer as a JSON file.

Import: Load a JSON file shared by others and merge the list into your database.

🤝 Why use Import? (Community Highlights)
Sharing this JSON file in fan groups, Discord, or forums has three major benefits:

✅ Benefit 1: Crowd-sourced "Regulars List"
If you belong to a VTuber or streamer fan community, members are often consistent. Veteran fans can export and share their accumulated data with new fans. After importing, new fans can instantly see the nicknames of all regulars without starting from zero.

✅ Benefit 2: Instant Access, No Waiting
Normally, the extension queries unknown IDs one by one, which takes time. With Import, your database already has the data. When you enter a busy chat room, everyone's names appear instantly, drastically improving experience and performance.

✅ Benefit 3: Smart Validation
The code is designed to mark imported data as "Waiting for Update". This means you see the nicknames immediately upon import (enjoying the speed), but the next time you encounter that person in chat, the extension will silently verify the data correctness in the background.

🛠️ FAQ & Troubleshooting

Q1: Why do some names have a dotted underline?
A: This indicates the data was obtained via "Import" or hasn't been updated for over 15 days. It doesn't affect readability; the system will automatically update it in the background the next time the user speaks.

Q2: What if I see "OUTPUT **NOT AVAILABLE" or names aren't restoring?**
A: This is usually because of too frequent fetching in a short time. The system has a built-in protection mechanism that temporarily pauses fetching. Please wait a moment (about 5 minutes) to recover. If you plan to leave the tab open for a long time, we recommend switching to "Slow Mode" in settings.

Q3: Will my data be uploaded?
A: Absolutely not. There is no logic in the code to upload to any server. All data exists only within your browser. The exported JSON file is also saved only to your computer's hard drive.