VspoDex av VspoCutting

============================================================
ENGLISH
============================================================

🌟 VspoDex 🎮

Track ぶいすぽっ！ (Vspo) VTuber live streams with ease. VspoDex is a browser extension that brings together Holodex and Twitch data to keep you updated on your favorite members' activities.

⚠ IMPORTANT: A Holodex API key setup is required for this extension to function. Setup is easy—simply follow the step-by-step instructions below.

⚙ Features:
🔹 [New] Tab Reordering: Arrange the sequence of popup sidebar tabs (Live, Members, Upcoming, Past) via drag-and-drop on the settings page.
🔹 [New] Members Tab: View all followed channels grouped into Favorites, Vspo JP, Vspo EN, and Vspo Official, sorted by subscriber count. Clicking a member shows their stream archive.
🔹 Unified Stream Tracking: Monitor live and upcoming streams across both YouTube (via Holodex API) and Twitch.
🔹 Customizable Channels: Follow the default Vspo roster or add any custom VTuber channel using YouTube ID.
🔹 Hololive & Nijisanji Search: Includes a built-in search and auto-complete function to easily track Hololive and Nijisanji members.
🔹 Past Streams Archive: View completed streams across YouTube (with infinite scrolling and collab filtering) and Twitch (featuring experimental background-synced VODs for target members, enabled by default).
🔹 Aesthetic Customizations: Select interface themes (Dark, Light, System), font sizes, and sorting options.
🔹 Language Support: Fully localized in English, Japanese (日本語), and Traditional Chinese (繁體中文).

🌐 Language Support:
VspoDex is fully localized and supports multiple languages. You can change your preferred language under the Appearance section on the settings page:
• English (Default)
• 日本語 (Japanese)
• 繁體中文 (Traditional Chinese)

🔑 Requirements:
📌 Holodex API Key: A free key is required to fetch stream data from YouTube.
📌 Twitch Login: You will need to log in to Twitch within the extension. This is used solely for API access to check live status; no personal information or account data is collected or stored.

🛠 How to Get a Holodex API Key:
Getting an API key is quick and free:
1⃣ Go to https://holodex.net and log in.
2⃣ Click your profile icon in the top-right corner and select Account Settings.
3⃣ Scroll down to the API Key section.
4⃣ Click the Generate button to create your key.
5⃣ Copy the key and paste it into the VspoDex Settings page.

============================================================
繁體中文 (Traditional Chinese)
============================================================

🌟 VspoDex 🎮

輕鬆追蹤 ぶいすぽっ！ (Vspo) VTuber 的直播。VspoDex 是一款結合了 Holodex 與 Twitch 數據的瀏覽器擴充功能，讓您即時掌握喜愛成員的最新動態。

⚠ 重要提示：本擴充功能需要設定 Holodex API 金鑰才能正常運作。設定非常簡單——只需按照下方的步驟指示操作即可。

⚙ 功能特色：
🔹 【新功能】分頁排序：可在設定頁面中透過拖放操作，自訂調整彈出式視窗側邊欄分頁（直播中、成員、預定、存檔）的順序。
🔹 【新功能】成員分頁：將追蹤的頻道分組顯示（包括最愛、Vspo JP、Vspo EN、Vspo 官方），並依訂閱者數量排序。點擊成員即可查看其直播存檔。
🔹 統一的直播追蹤：同時監控 YouTube（透過 Holodex API）與 Twitch 的直播和預定節目。
🔹 自訂追蹤頻道：追蹤預設的 Vspo 成員，或透過 YouTube 頻道 ID 新增任何自訂的 VTuber 頻道。
🔹 Hololive & Nijisanji 搜尋：內建搜尋與自動完成功能，讓您輕鬆搜尋並追蹤 Hololive 及 Nijisanji 的成員。
🔹 支援直播存檔：支援無限捲動與時長標記，提供 YouTube 完播影片列表與聯動直播篩選，並支援 Twitch 直播存檔（實驗性功能，預設啟用）顯示。
🔹 美化與自訂：可選擇介面主題（深色、淺色、跟隨系統）、調整字型大小以及變更排序選項。
🔹 多語言支援：完整支援英文、日文及繁體中文。

🌐 語言支援：
VspoDex 已完整在地化並支援多種語言。您可以在設定頁面的「外觀」區塊下更改偏好的語言：
• English (預設)
• 日本語 (日文)
• 繁體中文 (繁體中文)

🔑 系統需求：
📌 Holodex API 金鑰：需要一組免費的金鑰來從 YouTube 獲取直播數據。
📌 Twitch 登入：您需要在擴充功能中登入 Twitch。這僅用於存取 API 以檢查直播狀態；本擴充功能不會收集或儲存任何個人資訊或帳戶資料。

🛠 如何取得 Holodex API 金鑰：
取得 API 金鑰非常快速且完全免費：
1⃣ 前往 https://holodex.net 並登入您的帳號。
2⃣ 點擊右上角的個人頭像，然後選擇 Account Settings (帳戶設定)。
3⃣ 向下捲動至 API Key 區塊。
4⃣ 點擊 Generate 按鈕以產生您的金鑰。
5⃣ 複製產生的金鑰，並將其貼入 VspoDex 設定頁面中。

============================================================
日本語 (Japanese)
============================================================

🌟 VspoDex 🎮

ぶいすぽっ！ (Vspo) のVTuber配信を簡単にチェック。VspoDexは、HolodexとTwitchのデータを集約して、お気に入りメンバーの配信状況をリアルタイムでお知らせするブラウザ拡張機能です。

⚠ 重要：本拡張機能を正常に動作させるには、Holodex APIキーの設定が必要です。設定手順は非常に簡単です。以下の手順に従って設定を行ってください。

⚙ 主な機能：
🔹 【新機能】タブの並べ替え：設定ページにてドラッグ＆ドロップで、ポップアップのサイドバータブ（配信中、メンバー、配信予定、過去配信）の表示順序を自由に変更できます。
🔹 【新機能】メンバータブ：フォロー中のチャンネルをお気に入り、ぶいすぽJP、ぶいすぽEN、ぶいすぽ公式などのグループに分けて、チャンネル登録者数順に一覧表示します。メンバーをクリックすると、そのメンバーの過去配信アーカイブを表示できます。
🔹 一元化された配信追跡：YouTube（Holodex API経由）とTwitchのアクティブな配信やスケジュール予定を同時にチェックできます。
🔹 チャンネルのカスタマイズ：デフォルトのぶいすぽメンバーはもちろん、YouTubeのチャンネルIDを使ってお好みのVTuberチャンネルを追加・追跡できます。
🔹 ホロライブ・にじさんじ検索機能：検索および自動補完機能を内蔵。ホロライブやにじさんじのメンバーを検索して簡単にお気に入り追加できます。
🔹 過去配信のアーカイブ表示：無限スクロールや配信時間のバッジ表示に対応。YouTubeのコラボ配信非表示フィルタリングや、Twitchの過去配信（実験的機能、デフォルトで有効）表示をサポートしています。
🔹 デザインのカスタマイズ：インターフェーステーマ（ダーク、ライト、システム同期）、フォントサイズ、配信の並び替え方法を自由に設定できます。
🔹 多言語対応：英語、日本語、繁体字中国語に完全対応しています。

🌐 言語設定：
VspoDexは多言語に対応しています。設定画面の「外観」セクションから、お好みの言語に変更できます。
• English (デフォルト)
• 日本語
• 繁體中文

🔑 必要要件：
📌 Holodex APIキー：YouTubeの配信データを取得するための無料のAPIキーが必要です。
📌 Twitchログイン：拡張機能内でTwitchアカウントにログインする必要があります。これは配信状態を確認するAPIアクセスのためにのみ使用され、個人情報やアカウントデータの収集・保存は一切行いません。

🛠 Holodex APIキーの取得方法：
APIキーは無料で簡単に取得できます：
1⃣ https://holodex.net にアクセスしてログインします。
2⃣ 右上のプロフィールアイコンをクリックし、Account Settings（アカウント設定）を選択します。
3⃣ ページ下部の API Key セクションまでスクロールします。
4⃣ Generate ボタンをクリックしてキーを発行します。
5⃣ 発行されたキーをコピーし、VspoDexの設定ページに貼り付けます。

============================================================
ℹ ABOUT & ACKNOWLEDGEMENTS (English Only)
============================================================

🚀 About this project:
This extension is dedicated to the Vspo community. It provides a clean and efficient way to monitor live streams, upcoming schedules, and channel information across both YouTube (via Holodex) and Twitch.

✨ Credits & Inspiration:
A huge shoutout and massive love to Gumbo (https://github.com/seldszar/gumbo) by seldszar. Gumbo's implementation for Twitch and Holodex was a major inspiration for this project.

🌊 This is a vibe coding project! We used AI to plan and architect the project, sourcing inspiration and patterns from Gumbo's excellent codebase. Big thanks to the AI and the open-source community!

Made with ❤ for Vspo fans.