NUber-dev/YTubic - 仓库详情

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它直接与 YouTube 的 InnerTube API 通信，而非使用缓慢的 WebView 包装器，提供了原生般的体验，包括同步歌词、高分辨率封面艺术，以及自动更新的 yt-dlp，且采用 GPL-3.0 开源许可证。

适合谁使用

追求比官方网页版更流畅体验的 YouTube Music 重度用户
希望审计或自定义音乐客户端的开源爱好者
对 Tauri/React/TypeScript 技术栈感兴趣的开发者
需要桌面媒体键和系统托盘集成的 Windows、Linux 或 macOS 用户

典型使用场景

使用多个提供商的逐行同步歌词听音乐
从桌面应用管理 YouTube Music 的库、播放列表、喜欢和艺术家
多任务时使用始终置顶的浮动播放器小部件
通过系统媒体键和托盘/菜单栏图标控制播放

项目优势

预加载和激进缓存实现即时导航，每次点击无需等待转圈
支持 LRCLIB、Musixmatch 和 Genius 的同步歌词，并升级高分辨率封面
应用及其内嵌的 yt-dlp 自动更新，以保持与 YouTube 变更的兼容
跨平台支持，Windows 为主，Linux 和 macOS 提供测试版

使用前须知

Linux 和 macOS 版本处于测试阶段，实际测试远少于 Windows 版
安装程序未代码签名，在 Windows 上触发 SmartScreen 警告，在 macOS 上提示“未识别的开发者”
依赖 yt-dlp 进行音频流处理，若 YouTube 内部变更可能导致故障（虽有自动更新）

README 快速开始

YTubic

A fast, responsive YouTube Music desktop client for Windows, Linux, and macOS.

Built as a reaction to the sluggish webview-wrapper experience — YTubic talks to YouTube's InnerTube API directly, renders its own UI, and caches aggressively, so navigation and playback feel instant.

Features

Fast and responsive UI — instant navigation with prefetch and aggressive caching; no page reloads, no spinners on every click
Flexible player layouts — dock the player at the bottom or as a right-side panel
Floating player widget — pop the player out into a compact always-on-top window
Synced lyrics — line-by-line synced lyrics from multiple providers (LRCLIB, Musixmatch, Genius)
Hi-res cover art — upgrades album covers to high-resolution studio art when available
Full library support — your playlists, likes, albums and artists; search with filters; radio/autoplay queues
Desktop integration — media keys and system media controls, tray/menu-bar icon, single instance
Auto-updates — the app updates itself from GitHub Releases, and keeps its yt-dlp copy fresh automatically

Disclaimer: YTubic is an unofficial client. It is not affiliated with, endorsed by, or sponsored by Google or YouTube. "YouTube" and "YouTube Music" are trademarks of Google LLC. The app streams audio through yt-dlp and may stop working at any time if YouTube changes its internals. Use at your own risk.

Install

Download the latest installer from the Releases page and run it.

Windows 10/11: run the .exe NSIS installer.
macOS 10.15+ (beta): open the universal .dmg; the same build supports Apple Silicon and Intel. Login cookies are encrypted with a Keychain-backed key.
Linux (beta): install the .deb or .rpm, or run the .AppImage. Playback requires WebKitGTK 4.1, GTK 3 and the GStreamer base, good and libav plugins. Signing in also requires a desktop Secret Service provider such as GNOME Keyring or a compatible KWallet setup.
On first launch the app downloads its own copy of yt-dlp (~12 MB) into its data folder and keeps it updated automatically.
Signing in is optional: browse and playback work anonymously; sign in to get your library, likes, and playlists.

*Linux and macOS builds are in beta.

项目描述

Fast, responsive YouTube Music desktop client for Windows — Tauri 2 + React