jmbannon/ytdl-sub

🎵 Tự động tải media và chuẩn bị metadata cho mọi trình phát

Công cụ dòng lệnh nhẹ, dùng yt-dlp để tải YouTube, SoundCloud, Bandcamp và chuẩn hoá file + thẻ metadata theo đúng định dạng của Plex/Jellyfin/Kodi/Emby.

ytdl-sub là một công cụ dòng lệnh Python nhẹ, dùng yt-dlp để tải video và âm nhạc từ YouTube, SoundCloud, Bandcamp... rồi tự động sắp xếp thành cấu trúc thư mục và tạo file metadata (NFO, thẻ nhạc) để các phần mềm phát như Plex, Jellyfin, Kodi, Emby nhận diện ngay mà không cần plugin hay công cụ thứ ba.

✨ Điểm nổi bật

• Tải qua yt-dlp: hỗ trợ rất nhiều nguồn như YouTube, SoundCloud, Bandcamp.
• Tạo metadata tự động: sinh file NFO, thẻ nhạc (qua beets API), sẵn sàng nhập vào Plex/Jellyfin/Emby/Kodi.
• Cấu hình YAML linh hoạt: dùng tệp subscriptions.yaml để định nghĩa kênh, playlist, bài hát và cách xử lý từng loại.
• Preset tích hợp sẵn: cung cấp nhiều mẫu cấu hình sẵn (TV Show, Music, Music Video...) để người dùng nhanh chóng khởi động.
• Hỗ trợ nhiều kiểu nội dung: kênh YouTube làm chương trình truyền hình, album SoundCloud/Bandcamp, video âm nhạc, v.v.
• Tùy chỉnh thư mục gốc: thiết lập riêng thư mục cho TV Show, Music, Music Video.
• Tùy chọn only recent: giới hạn số lượng video tải về trong khoảng thời gian nhất định.
• Tích hợp cookie yt-dlp: hỗ trợ đăng nhập để truy cập nội dung riêng tư.

💡 Vì sao đáng chú ý

Không giống cách thủ công tải rồi tổ chức lại, ytdl-sub kết hợp toàn bộ quy trình: từ định nghĩa nguồn → tải về → định dạng tên file → sinh metadata → sắp xếp thành cấu trúc thư mục chuẩn. Điều này giúp người dùng chỉ cần chạy một lệnh ytdl-sub sub subscriptions.yaml và toàn bộ nội dung sẽ sẵn sàng để thêm vào thư viện Plex/Jellyfin/J Kodi/Emby ngay lập tức.

#yt-dlp #metadata #Plex #Jellyfin #Kodi #Emby #Python #OpenSource #TiniX