danvics/soulsync
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

perf(dashboard): auto-enable performance mode on weak hardware (device-scoped)

Browse source 
People report SoulSync working their machine hard at idle. On likely-weak devices
(<=2 cores, or <=2GB, or low on both: <=4 cores AND <=4GB) auto-enable reduce-effects
once and toast why ('lower-power device — turn effects back on in Settings').

Device-scoped via localStorage on purpose: a weak laptop must not flip the server
setting for the user's other machines. Acts only when this device has no stored
preference (null), so it runs at most once and never overrides an explicit choice.
Conservative thresholds avoid flagging capable boxes (a 4-core/8GB laptop isn't
touched; Firefox/Safari, which don't expose deviceMemory, only trip on <=2 cores).

Settings-load now prefers the device-level localStorage value over the server
default, so opening Settings no longer clobbers the per-device (auto or manual) choice.
This commit is contained in:
BoulderBadgeDad 2026-06-22 15:12:25 -07:00
parent b5b71df3fa
commit 4b58d8079e
2 changed files with 49 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
webui/static/init.js
View file

@ -213,6 +213,47 @@ function applyReduceEffects(enabled) {
// Bootstrap accent and reduce-effects from localStorage instantly (prevents flash)
(function () {
// Auto performance mode on likely-weak hardware. Only acts when this device has
// NO stored preference yet (null) — so it runs at most once and never overrides
// a choice the user (or a prior auto-run) made. Device-scoped via localStorage on
// purpose: a weak laptop shouldn't flip the server setting for the user's other
// machines. Mobile already disables these effects elsewhere, so skip it here.
if (localStorage.getItem('soulsync-reduce-effects') === null) {
const ua = navigator.userAgent || '';
const isMobile = window.innerWidth <= 768 || /Mobi|Android|iPhone|iPad|iPod/i.test(ua);
const cores = navigator.hardwareConcurrency || 0; // widely supported
const mem = navigator.deviceMemory || 0; // Chromium only; 0 elsewhere
// Conservative — avoid flagging capable machines: <=2 cores, or <=2GB, or a
// low-mid box that's low on BOTH (<=4 cores AND <=4GB). A 4-core/8GB laptop
// (mem>4) is NOT flagged; Firefox/Safari (mem unknown) only trip on <=2 cores.
const weak = !isMobile && (
(cores > 0 && cores <= 2) ||
(mem > 0 && mem <= 2) ||
(cores > 0 && cores <= 4 && mem > 0 && mem <= 4)
);
if (weak) {
localStorage.setItem('soulsync-reduce-effects', '1');
window._autoPerfModeApplied = true; // show the explainer toast once the UI is up
}
}
if (window._autoPerfModeApplied) {
// Toast lives in downloads.js (loaded separately) — retry until it's defined.
const fireToast = (tries) => {
if (typeof showToast === 'function') {
showToast('Performance mode is on — this looks like a lower-power device. ' +
'Turn effects back on in Settings → Appearance.', 'info');
} else if (tries < 40) {
setTimeout(() => fireToast(tries + 1), 250);
}
};
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', () => fireToast(0));
} else {
fireToast(0);
}
}
if (localStorage.getItem('soulsync-reduce-effects') === '1') {
document.body.classList.add('reduce-effects');
window._reduceEffectsActive = true;

10
webui/static/settings.js
View file

@ -1388,8 +1388,14 @@ async function loadSettingsData() {
if (workerOrbsCheckbox) workerOrbsCheckbox.checked = workerOrbsEnabled;
applyWorkerOrbsSetting(workerOrbsEnabled);
// Reduce effects toggle
const reduceEffects = settings.ui_appearance?.reduce_effects === true; // default false
// Reduce effects toggle. This flag is device-scoped: localStorage (set by the
// live toggle and by weak-hardware auto-detect) is the source of truth for THIS
// machine; the server value is only the cross-device default used when this
// device has never chosen. Prefer localStorage when present so opening Settings
// doesn't clobber an auto-enabled (or manually-set) per-device choice.
const serverReduce = settings.ui_appearance?.reduce_effects === true; // default false
const localReduce = localStorage.getItem('soulsync-reduce-effects'); // '1' | '0' | null
const reduceEffects = localReduce !== null ? (localReduce === '1') : serverReduce;
const reduceCheckbox = document.getElementById('reduce-effects-enabled');
if (reduceCheckbox) reduceCheckbox.checked = reduceEffects;
applyReduceEffects(reduceEffects);