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
import { registerPlugin, type PluginListenerHandle } from "@capacitor/core";
import type { SystemMedia } from "../lib/apiTypes";
/**
* Bridge to the app's Android side (MusikePlaybackPlugin.java): a foreground service with a media session,
* so music keeps playing with the screen off and the notification, lock screen and headphone buttons work.
*/
interface PlaybackPlugin {
update(options: {
title?: string;
artist?: string;
album?: string;
artwork?: string;
playing?: boolean;
position?: number;
duration?: number;
}): Promise<void>;
addListener(event: "action", fn: (e: { action: string; position?: number }) => void): Promise<PluginListenerHandle>;
}
const noop = async () => {};
const Playback = registerPlugin<PlaybackPlugin>("MusikePlayback", {
// In a desktop browser (development), there is nothing to drive.
web: () => ({ update: noop, addListener: async () => ({ remove: noop }) }),
});
/**
* Bridge to the app's iOS side (ios/App/App/MusikePlayback.swift). iOS has no Capacitor plugin here: the web view's
* own message handler carries the now-playing info, and the lock screen's buttons come back as
* window.__musikeMediaAction(), the same actions the Android plugin sends.
*/
interface MessageBridge {
postMessage(message: unknown): void;
}
const iosBridge = (
globalThis as { webkit?: { messageHandlers?: { musikeMedia?: MessageBridge } } }
).webkit?.messageHandlers?.musikeMedia;
// The system advances the position on its own while playing; only real changes need sending.
let last = { playing: false, position: 0, at: 0 };
/** Whether this state is news to the system: a real change, not the clock moving. */
function worthSending(playing: boolean, position: number): boolean {
const now = Date.now();
const expected = last.playing ? last.position + (now - last.at) / 1000 : last.position;
if (playing === last.playing && Math.abs(position - expected) < 2 && now - last.at < 15_000) return false;
last = { playing, position, at: now };
return true;
}
const androidMedia: SystemMedia = {
setTrack(track) {
last = { playing: last.playing, position: 0, at: Date.now() };
void Playback.update({ ...track, position: 0 });
},
setState({ playing, position, duration }) {
if (!worthSending(playing, position)) return;
void Playback.update({ playing, position, duration: Number.isFinite(duration) ? duration : 0 });
},
onAction(handler) {
void Playback.addListener("action", (e) => handler(e.action as Parameters<typeof handler>[0], e.position));
},
};
const iosMedia: SystemMedia = {
setTrack(track) {
last = { playing: last.playing, position: 0, at: Date.now() };
iosBridge?.postMessage({ type: "track", ...track, position: 0 });
},
setState({ playing, position, duration }) {
if (!worthSending(playing, position)) return;
iosBridge?.postMessage({ type: "state", playing, position, duration: Number.isFinite(duration) ? duration : 0 });
},
onAction(handler) {
(globalThis as { __musikeMediaAction?: (action: string, position?: number) => void }).__musikeMediaAction = (
action,
position,
) => handler(action as Parameters<typeof handler>[0], position);
},
};
export const media: SystemMedia = iosBridge ? iosMedia : androidMedia;