Everything the plugin is, moved out of officerdev/platform on 2026-08-15 — 41 files, unchanged from the tree they left. manifest.ts identity, one permission, ffmpeg/ffprobe declared api/ the sidecar proxy; the prefix comes from mountPrefix() sidecar/ the whole /api/music contract — indexing, streaming, per-user state db/ music_favorites, _playlists, _playlist_items, _now_playing web/ panels, layout, and the player: engine, bar, lyrics, favourites cliamp/ the second playback path, parked — not working, kept deliberately widgets/ the dashboard widget, parked — plugins cannot contribute widgets assets/ icon.png, the dock tile scripts/ the reindex CLI PLUGIN.md is the design record: what moved, what stayed, what broke, and why. MUSIC_API.md is the contract the phone and tablet apps speak, and the reason the sidecar's HTTP shape is not free to change. ── It does not build here, and that is the point ── The platform resolves `hooks/useClient`, `officerdev`, `officerdb/db` and `@@/*` through the workspace links in its own node_modules. Measured from this directory, outside the platform checkout, every one of them fails to resolve — 7 imports in the backend, ~29 in the frontend. So this repository is the source of truth, not yet a buildable unit. Making it one means the host API becoming something a plugin can depend on rather than something it reaches into. That is the next problem, and having the code here is what makes it unavoidable rather than theoretical. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
49 lines
1.9 KiB
TypeScript
49 lines
1.9 KiB
TypeScript
// Host audio plumbing for local playback: a PulseAudio daemon and a null sink named `virtual_out`.
|
|
// cliamp plays *into* that sink (PULSE_SINK) and the capture side reads `virtual_out.monitor`, so the
|
|
// sink has to exist before either of them starts — which is why this runs at sidecar startup rather
|
|
// than on first play. Both steps are idempotent and both failures are non-fatal: a host without
|
|
// pulseaudio simply has no browser playback, and everything else the music sidecar does still works.
|
|
|
|
export const VIRTUAL_SINK = 'virtual_out';
|
|
|
|
export function ensurePulseAudio(): void {
|
|
const pulseaudio = Bun.which('pulseaudio');
|
|
const pactl = Bun.which('pactl');
|
|
if (!pulseaudio || !pactl) {
|
|
console.log('[music] pulseaudio not installed, skipping audio setup');
|
|
return;
|
|
}
|
|
|
|
const check = Bun.spawnSync({ cmd: [pulseaudio, '--check'], stdout: 'ignore', stderr: 'ignore' });
|
|
if (check.exitCode !== 0) {
|
|
const start = Bun.spawnSync({ cmd: [pulseaudio, '--start', '-D'], stdout: 'ignore', stderr: 'ignore' });
|
|
if (start.exitCode !== 0) {
|
|
console.error('[music] failed to start pulseaudio');
|
|
return;
|
|
}
|
|
console.log('[music] pulseaudio started');
|
|
} else {
|
|
console.log('[music] pulseaudio already running');
|
|
}
|
|
|
|
const sinks = Bun.spawnSync({ cmd: [pactl, 'list', 'short', 'sinks'], stdout: 'pipe', stderr: 'ignore' });
|
|
if (sinks.stdout.toString().includes(VIRTUAL_SINK)) {
|
|
console.log(`[music] ${VIRTUAL_SINK} sink already exists`);
|
|
return;
|
|
}
|
|
|
|
const load = Bun.spawnSync({
|
|
cmd: [
|
|
pactl,
|
|
'load-module',
|
|
'module-null-sink',
|
|
`sink_name=${VIRTUAL_SINK}`,
|
|
'sink_properties=device.description=Virtual_Output',
|
|
],
|
|
stdout: 'pipe',
|
|
stderr: 'pipe',
|
|
});
|
|
if (load.exitCode !== 0) console.error('[music] failed to load null sink:', load.stderr.toString().trim());
|
|
else console.log(`[music] ${VIRTUAL_SINK} null sink loaded`);
|
|
}
|