feat: add per-user moods as generated playlists
CI / chart (push) Successful in 2s
CI / chart-push (push) Successful in 2s
CI / test (push) Successful in 1m41s
CI / image (push) Successful in 3m11s

Add private server-managed playlist moods with curated seeds and related
library fill. Moods are created or promoted from existing playlists in the
web UI, refresh lazily after their TTL, and are marked stale after a scan.

Symfonium stars pin the active mood: opening a mood restores its context,
and a starred song becomes a permanent seed. Without an active session the
song is pinned to every mood that already contains it.

Includes the V4 migration, custom mood endpoints, management UI, tests and
smoke coverage. Bump the chart to 0.1.4.
This commit is contained in:
TapTap committed 2026-11-14 12:52:25 +00:00
1 parent e08d993e35
commit 28bfdd9d00
25 files changed
+2039 -14

No files matched your search

@@ -0,0 +1,47 @@
-- Moods are private, server-managed playlists. The playlist stays the
-- Symfonium-visible object; this table holds the generation settings.
ALTER TABLE playlists ADD COLUMN kind TEXT NOT NULL DEFAULT 'user'
CHECK (kind IN ('user', 'mood'));
CREATE TABLE moods (
playlist_id TEXT PRIMARY KEY REFERENCES playlists(id) ON DELETE CASCADE,
query TEXT,
genres TEXT NOT NULL DEFAULT '[]',
target_size INTEGER NOT NULL DEFAULT 50,
yt_slots INTEGER NOT NULL DEFAULT 0,
expand_related BOOLEAN NOT NULL DEFAULT 1,
refresh_hours INTEGER NOT NULL DEFAULT 24,
generated_at TEXT,
generation INTEGER NOT NULL DEFAULT 0,
last_error TEXT
);
-- Manual, promoted and liked songs are permanent anchors for the mood.
CREATE TABLE mood_seeds (
playlist_id TEXT NOT NULL REFERENCES moods(playlist_id) ON DELETE CASCADE,
song_id TEXT NOT NULL REFERENCES songs(id) ON DELETE CASCADE,
origin TEXT NOT NULL DEFAULT 'manual'
CHECK (origin IN ('manual', 'promoted', 'star', 'yt_like')),
added_at TEXT NOT NULL,
PRIMARY KEY (playlist_id, song_id)
);
-- YT Music candidates. The downloader and recommendation UI land in a later
-- phase; the table is created now so generation does not need a migration.
CREATE TABLE mood_recommendations (
playlist_id TEXT NOT NULL REFERENCES moods(playlist_id) ON DELETE CASCADE,
video_id TEXT NOT NULL,
title TEXT NOT NULL,
artist TEXT NOT NULL,
duration INTEGER,
state TEXT NOT NULL DEFAULT 'new'
CHECK (state IN ('new', 'liked', 'rejected', 'downloaded')),
matched_song_id TEXT REFERENCES songs(id) ON DELETE SET NULL,
times_added INTEGER NOT NULL DEFAULT 0,
first_seen TEXT NOT NULL,
last_seen TEXT NOT NULL,
PRIMARY KEY (playlist_id, video_id)
);
CREATE INDEX idx_mood_seeds_song ON mood_seeds (song_id);
CREATE INDEX idx_mood_recommendations_song ON mood_recommendations (matched_song_id);
+268
View File
@@ -44,12 +44,17 @@
#status.error { color:#ff7b72; }
#crumb { cursor:pointer; color:var(--accent); }
.hidden { display:none !important; }
form label { display:grid; gap:5px; font-size:13px; color:var(--muted); }
form label.row { display:flex; gap:8px; align-items:center; color:var(--text); }
form input[type=checkbox] { width:auto; }
.error { color:#ff7b72; }
</style>
</head>
<body>
<header id="topbar" class="hidden">
<h1>MusicManager</h1>
<button class="ghost" id="homeBtn">Albums</button>
<button class="ghost" id="moodsBtn">Moods</button>
<input id="search" placeholder="Search" style="width:220px">
<select id="folder"></select>
<span class="spacer"></span>
@@ -261,6 +266,268 @@ async function search() {
}
}
function formatWhen(value) {
if (!value) return 'never';
const date = new Date(value);
return Number.isNaN(date.getTime()) ? value : date.toLocaleString();
}
async function showMoods() {
$('app').dataset.moodId = '';
setStatus('Loading moods...');
try {
const moods = (await api('getMoods')).moods?.mood || [];
$('title').textContent = 'Moods';
$('content').innerHTML = `
<div class="row" style="margin-top:12px">
<button class="primary" id="newMoodBtn">New mood</button>
<button id="promoteMoodBtn">Promote playlist</button>
</div>
${moods.length ? `<table>
<thead><tr><th>Name</th><th>Seeds</th><th>Songs</th><th>Refreshed</th><th></th></tr></thead>
<tbody>${moods.map(moodRow).join('')}</tbody>
</table>` : '<p class="muted">No moods yet. Create one or promote an existing playlist.</p>'}`;
$('newMoodBtn').onclick = showCreateMood;
$('promoteMoodBtn').onclick = showPromoteMood;
setStatus(`${moods.length} moods`);
} catch (error) {
setStatus(error.message, true);
}
}
function moodRow(mood) {
return `<tr>
<td><strong>${esc(mood.name)}</strong>${mood.lastError ? ' <span class="error">(generation error)</span>' : ''}</td>
<td>${esc(mood.seedCount)}</td>
<td>${esc(mood.songCount)}</td>
<td class="muted">${esc(formatWhen(mood.generatedAt))}</td>
<td class="row" style="justify-content:flex-end">
<button data-mood-open="${esc(mood.id)}">Open</button>
<button data-mood-refresh="${esc(mood.id)}">Refresh</button>
<button data-mood-delete="${esc(mood.id)}">Delete</button>
</td>
</tr>`;
}
function showCreateMood() {
$('app').dataset.moodId = '';
$('title').innerHTML = '<span id="crumb">Moods</span> / New mood';
$('content').innerHTML = `
<form id="moodForm" style="max-width:560px;margin-top:14px;display:grid;gap:10px">
<label>Name<input name="name" required placeholder="Focus"></label>
<label>Query (optional)<input name="query" placeholder="ambient focus"></label>
<label>Genres (comma separated)<input name="genres" placeholder="Ambient, Electronic"></label>
<label>Target size<input name="targetSize" type="number" min="1" max="500" value="50"></label>
<label>Refresh hours<input name="refreshHours" type="number" min="1" max="720" value="24"></label>
<label class="row"><input name="expandRelated" type="checkbox" checked> Fill with related library songs</label>
<div class="row"><button class="primary" type="submit">Create mood</button></div>
</form>`;
$('crumb').onclick = showMoods;
$('moodForm').onsubmit = async (event) => {
event.preventDefault();
const form = new FormData(event.target);
try {
const mood = (await api('createMood', {
name: form.get('name'),
query: form.get('query') || '',
genres: form.get('genres') || '',
targetSize: form.get('targetSize'),
refreshHours: form.get('refreshHours'),
expandRelated: form.get('expandRelated') ? 'true' : 'false',
})).mood;
await showMood(mood.id);
} catch (error) {
setStatus(error.message, true);
}
};
}
async function showPromoteMood() {
setStatus('Loading playlists...');
try {
const [playlistsPayload, moodsPayload] = await Promise.all([api('getPlaylists'), api('getMoods')]);
const playlists = playlistsPayload.playlists?.playlist || [];
const moodIds = new Set((moodsPayload.moods?.mood || []).map((mood) => mood.id));
const owned = playlists.filter((playlist) => playlist.owner === state.user && !moodIds.has(playlist.id));
$('title').innerHTML = '<span id="crumb">Moods</span> / Promote playlist';
$('content').innerHTML = owned.length ? `
<p class="muted">The playlist ID and name stay the same. Its current songs become permanent seeds.</p>
<form id="promoteForm" style="max-width:560px;display:grid;gap:10px">
<label>Playlist<select name="playlistId">${owned.map((playlist) =>
`<option value="${esc(playlist.id)}">${esc(playlist.name)} (${esc(playlist.songCount)})</option>`).join('')}</select></label>
<label>Query (optional)<input name="query"></label>
<label>Target size<input name="targetSize" type="number" min="1" max="500" value="50"></label>
<label>Refresh hours<input name="refreshHours" type="number" min="1" max="720" value="24"></label>
<label class="row"><input name="expandRelated" type="checkbox" checked> Fill with related library songs</label>
<div class="row"><button class="primary" type="submit">Promote</button></div>
</form>` : '<p class="muted">No owned playlists found.</p>';
if ($('crumb')) $('crumb').onclick = showMoods;
if ($('promoteForm')) $('promoteForm').onsubmit = async (event) => {
event.preventDefault();
const form = new FormData(event.target);
try {
const mood = (await api('promotePlaylistToMood', {
playlistId: form.get('playlistId'),
query: form.get('query') || '',
targetSize: form.get('targetSize'),
refreshHours: form.get('refreshHours'),
expandRelated: form.get('expandRelated') ? 'true' : 'false',
})).mood;
await showMood(mood.id);
} catch (error) {
setStatus(error.message, true);
}
};
setStatus(`${owned.length} playlists`);
} catch (error) {
setStatus(error.message, true);
}
}
async function showMood(id) {
setStatus('Loading mood...');
try {
const mood = (await api('getMood', { id })).mood;
const seeds = mood.seed || [];
const entries = mood.entry || [];
$('title').innerHTML = `<span id="crumb">Moods</span> / ${esc(mood.name)}`;
$('content').innerHTML = `
<div class="row" style="margin-top:12px">
<span class="muted">${esc(mood.seedCount)} seeds · ${esc(mood.songCount)} songs · refreshed ${esc(formatWhen(mood.generatedAt))}</span>
<span class="spacer" style="flex:1"></span>
<button id="moodRefresh">Refresh now</button>
<button id="moodDelete">Delete mood</button>
</div>
${mood.lastError ? `<p class="error">${esc(mood.lastError)}</p>` : ''}
<form id="moodSettings" style="max-width:560px;margin-top:14px;display:grid;gap:10px">
<label>Name<input name="name" required value="${esc(mood.name)}"></label>
<label>Query (optional)<input name="query" value="${esc(mood.query || '')}"></label>
<label>Genres (comma separated)<input name="genres" value="${esc((mood.genres || []).join(', '))}"></label>
<label>Target size<input name="targetSize" type="number" min="1" max="500" value="${esc(mood.targetSize)}"></label>
<label>YT slots (reserved)<input name="ytSlots" type="number" min="0" max="500" value="${esc(mood.ytSlots)}"></label>
<label>Refresh hours<input name="refreshHours" type="number" min="1" max="720" value="${esc(mood.refreshHours)}"></label>
<label class="row"><input name="expandRelated" type="checkbox" ${mood.expandRelated ? 'checked' : ''}> Fill with related library songs</label>
<div class="row"><button class="primary" type="submit">Save settings</button></div>
</form>
<h3>Seeds</h3>
${seeds.length ? `<table><tbody>${seeds.map((song) => `
<tr><td>${esc(song.title)}</td><td class="muted">${esc(song.artist || '')}</td>
<td style="text-align:right"><button data-seed-remove="${esc(song.id)}">Remove</button></td></tr>`).join('')}</tbody></table>`
: '<p class="muted">No seeds yet. Add songs below or promote a playlist.</p>'}
<h3>Add seed</h3>
<div class="row">
<input id="seedSearch" placeholder="Search library" style="min-width:260px">
<button id="seedSearchBtn">Search</button>
</div>
<div id="seedResults"></div>
<h3>Current mix</h3>
${entries.length ? `<table><tbody>${entries.map(songRow).join('')}</tbody></table>` : '<p class="muted">The mix is empty.</p>'}`;
$('app').dataset.moodId = id;
$('crumb').onclick = showMoods;
$('moodRefresh').onclick = async () => {
try {
await api('refreshMood', { id });
await showMood(id);
} catch (error) { setStatus(error.message, true); }
};
$('moodDelete').onclick = async () => {
if (!confirm(`Delete mood "${mood.name}"?`)) return;
try {
await api('deleteMood', { id });
await showMoods();
} catch (error) { setStatus(error.message, true); }
};
$('moodSettings').onsubmit = async (event) => {
event.preventDefault();
const form = new FormData(event.target);
try {
await api('updateMood', {
id,
name: form.get('name'),
query: form.get('query') || '',
genres: form.get('genres') || '',
targetSize: form.get('targetSize'),
ytSlots: form.get('ytSlots'),
refreshHours: form.get('refreshHours'),
expandRelated: form.get('expandRelated') ? 'true' : 'false',
});
await showMood(id);
} catch (error) { setStatus(error.message, true); }
};
$('seedSearchBtn').onclick = () => searchSeeds(id, seeds);
$('seedSearch').addEventListener('keydown', (event) => {
if (event.key === 'Enter') { event.preventDefault(); searchSeeds(id, seeds); }
});
setStatus(`${seeds.length} seeds, ${entries.length} songs`);
} catch (error) {
setStatus(error.message, true);
}
}
async function searchSeeds(moodId, seeds) {
const query = $('seedSearch').value.trim();
if (!query) return;
setStatus('Searching...');
try {
const result = (await api('search3', { query, songCount: '30', albumCount: '0', artistCount: '0' })).searchResult3 || {};
const seedIds = new Set(seeds.map((song) => song.id));
const songs = (result.song || []).filter((song) => !seedIds.has(song.id));
$('seedResults').innerHTML = songs.length
? `<table><tbody>${songs.map((song) => `
<tr><td>${esc(song.title)}</td><td class="muted">${esc(song.artist || '')}</td>
<td style="text-align:right"><button data-seed-add="${esc(song.id)}">Add</button></td></tr>`).join('')}</tbody></table>`
: '<p class="muted">No matching songs, or all are already seeds.</p>';
setStatus(`${songs.length} results`);
} catch (error) {
setStatus(error.message, true);
}
}
document.addEventListener('click', (event) => {
const open = event.target.closest('[data-mood-open]');
if (open) { showMood(open.dataset.moodOpen); return; }
const refresh = event.target.closest('[data-mood-refresh]');
if (refresh) {
api('refreshMood', { id: refresh.dataset.moodRefresh })
.then(() => showMoods())
.catch((error) => setStatus(error.message, true));
return;
}
const remove = event.target.closest('[data-mood-delete]');
if (remove) {
const id = remove.dataset.moodDelete;
if (!confirm('Delete this mood?')) return;
api('deleteMood', { id })
.then(() => showMoods())
.catch((error) => setStatus(error.message, true));
return;
}
const addSeed = event.target.closest('[data-seed-add]');
if (addSeed) {
const moodId = addSeed.closest('main').dataset.moodId;
if (!moodId) return;
api('addMoodSeed', { id: moodId, songId: addSeed.dataset.seedAdd })
.then(() => showMood(moodId))
.catch((error) => setStatus(error.message, true));
return;
}
const removeSeed = event.target.closest('[data-seed-remove]');
if (removeSeed) {
const moodId = removeSeed.closest('main').dataset.moodId;
if (!moodId) return;
api('removeMoodSeed', { id: moodId, songId: removeSeed.dataset.seedRemove })
.then(() => showMood(moodId))
.catch((error) => setStatus(error.message, true));
}
});
function formatDuration(seconds) {
const total = Math.max(0, Math.floor(seconds || 0));
return `${Math.floor(total / 60)}:${String(total % 60).padStart(2, '0')}`;
@@ -291,6 +558,7 @@ document.addEventListener('click', (event) => {
$('loginBtn').onclick = login;
$('password').addEventListener('keydown', (event) => { if (event.key === 'Enter') login(); });
$('homeBtn').onclick = showAlbums;
$('moodsBtn').onclick = showMoods;
$('logout').onclick = logout;
$('search').addEventListener('keydown', (event) => { if (event.key === 'Enter') search(); });
$('folder').onchange = () => { state.folderId = $('folder').value; showAlbums(); };