Open-source music player for YouTube Music's catalog, with genres, full albums and playlists. Windows, macOS, Linux, Android, iPhone and Docker. No account needed.
TypeScript
export interface Track {
id: string;
title: string;
artist: string;
album?: string;
duration: number;
thumb: string;
art: string;
kind: "song" | "video";
}
export interface Playlist {
id: string;
name: string;
createdAt: number;
updatedAt: number;
tracks: Track[];
}
export interface Library {
favorites: Track[];
playlists: Playlist[];
history: Track[];
}
import { tr, type Text } from "./i18n.js";
export const VIDEO_ID = /^[A-Za-z0-9_-]{11}$/;
/** Machine-readable reason so the web app can offer the right fix (e.g. "update yt-dlp"). */
export type ErrorCode = "tool_missing" | "maybe_outdated" | "bot_check";
/** An error for the person using the app: its text is translated into each request's language when sent. */
export class HttpError extends Error {
constructor(
public status: number,
public text: Text,
public code?: ErrorCode,
) {
super(tr("en", text));
}
}