Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
95 commits
Select commit Hold shift + click to select a range
2e9cb42
Auto-track verifiable folders again; trust own devices to choose folders
Oct 2, 2026
750aa55
Broad-root check lower-cases on every OS
Oct 2, 2026
a775242
Keep the catalogue index in memory; never index it while a peer waits
Oct 2, 2026
5bd8de2
Offer comments: offers no longer need the ask setting
Oct 2, 2026
0eec6a3
No catalogue wildcard vouches for a folder inside a game's install
Omar-VF Oct 11, 2026
a77e03e
Deck: a game's start waits for its save, and its play is told to the …
Omar-VF Oct 20, 2026
8bea4fa
sync: a game being played is held back from syncing until the session…
ChakraFusion Oct 20, 2026
6e59d66
sessions: a process doing nothing is not the game
ChakraFusion Oct 20, 2026
0c8189e
Deck: a play session left open by a reload is ended
Omar-VF Oct 23, 2026
194973e
i18n: extract the save-conflict and location-conflict modals
Oct 16, 2026
4fa39cd
i18n: extract the Settings script, header, tabs and the general and s…
Oct 16, 2026
8836b9b
i18n: extract the Settings storage, advanced and support tabs
Oct 16, 2026
e49b0b1
sessions: a game quiet in the background keeps its session
ChakraFusion Oct 26, 2026
af64c5b
sessions: a session without a save for an hour is taken as over
ChakraFusion Oct 26, 2026
9d4ecb1
sessions: only a session gone all but idle is ended for not saving
ChakraFusion Oct 26, 2026
4f5ecf8
Track game: the games running now come first
ChakraFusion Oct 26, 2026
82bd382
Merge remote-tracking branch 'upstream/dev-public' into pr/running-now
ChakraFusion Oct 27, 2026
d2161e4
Merge remote-tracking branch 'upstream/dev-public' into pr/play-hold
ChakraFusion Oct 27, 2026
8e099a6
Merge dev into dev-public: games from your devices set themselves up …
Omar-VF Oct 27, 2026
6683ee2
A catalogue folder named by a bare wildcard vouches for nothing
Omar-VF Oct 27, 2026
74ec18d
Watcher lists a folder without blocking its removal
Oct 27, 2026
e5377ce
Merge pull request #135 from Liquid-co/merge/dev-into-dev-public
Omar-VF Oct 28, 2026
f8005a0
Merge pull request #117 from ChakraFusion/pr/play-hold
Omar-VF Oct 28, 2026
a0f6032
Merge pull request #126 from ChakraFusion/pr/running-now
Omar-VF Oct 28, 2026
2a7d7ce
test(native): reject root mutation while native writer is active
Seagulls Oct 30, 2026
5274dfa
fix(native): coordinate root topology changes with admitted writers
Seagulls Oct 30, 2026
5cd0a18
fix(native): coordinate root topology changes with admitted writers
Seagulls Oct 30, 2026
089ad2f
fix(native): coordinate root topology changes with admitted writers
Seagulls Oct 30, 2026
a2b92ca
test(native): verify lifetime of daemon presence lock
Seagulls Oct 30, 2026
62acfd2
fix(cli): require daemon presence admission for offline root edits
Seagulls Oct 30, 2026
ec8ff81
fix(cli): require daemon presence admission for offline root edits
Seagulls Oct 30, 2026
0dfeb69
fix(cli): require daemon presence admission for offline root edits
Seagulls Oct 30, 2026
d9d2a16
fix(native): retain root topology reservation across sync admission a…
Seagulls Oct 30, 2026
b1bb0dd
fix(native): retain root topology reservation across sync admission a…
Seagulls Oct 30, 2026
fcdbb29
fix(native): retain root topology reservation across sync admission a…
Seagulls Oct 30, 2026
cf132ba
fix(native): retain root topology reservation across sync admission a…
Seagulls Oct 30, 2026
ab36a00
test(sync): cover queued writers and root topology rejection
Seagulls Oct 30, 2026
4944011
test(backup): refuse untracked import into another game's owned roots
Seagulls Oct 30, 2026
7b1dae1
fix(backup): admit untracked import before mutating owned save paths
Seagulls Oct 30, 2026
00dc8e1
fix(backup): admit untracked import before mutating owned save paths
Seagulls Oct 30, 2026
459d0e9
fix(backup): admit untracked import before mutating owned save paths
Seagulls Oct 30, 2026
ea577d5
fix(store): hold cross-process import claim through authoritative reg…
Seagulls Oct 30, 2026
19a6815
test(store): prove cross-process import ownership and lease identity
Seagulls Oct 30, 2026
8d8f9c8
test(store): prove cross-process import ownership and lease identity
Seagulls Oct 30, 2026
bae69ca
test(store): prove cross-process import ownership and lease identity
Seagulls Oct 30, 2026
ec7ef2c
test(store): prove cross-process import ownership and lease identity
Seagulls Oct 30, 2026
e7151ca
fix(daemon): register imported game under held native ownership admis…
Seagulls Oct 30, 2026
bded266
test(e2e): retry transient native topology 409 after initial sync drains
Seagulls Oct 30, 2026
e656c46
fix(windows): pin named mutex ownership to one OS thread across impor…
Seagulls Oct 30, 2026
248c6e2
test(windows): prove non-recursive admission and release from other g…
Seagulls Oct 30, 2026
c76ba6e
Merge pull request #109 from Liquid-co/fix/deck-launch-sync
Omar-VF Oct 31, 2026
1b65e76
fix(native): bounded context-aware wait around existing topology rese…
Seagulls Oct 31, 2026
b77c2e8
fix(api): wait up to 30 seconds before refusing busy root edits
Seagulls Oct 31, 2026
10dd814
fix(api): bound primary-path admission and fail closed on combined pa…
Seagulls Oct 31, 2026
424e9d7
fix(api): remove daemon presence lock incompatible with desktop startup
Seagulls Oct 31, 2026
7610084
fix(cli): extract cross-process daemon/CLI admission to separate life…
Seagulls Oct 31, 2026
bf261db
test(api): move daemon presence ownership proof out of PR139
Seagulls Oct 31, 2026
cec3a36
refactor(cli): restore baseline commands; move daemon ownership to se…
Seagulls Oct 31, 2026
02624f5
refactor(cli): restore baseline commands; move daemon ownership to se…
Seagulls Oct 31, 2026
6a4ade8
test(api): permit short per-server topology admission deadline
Seagulls Oct 31, 2026
525db76
test(api): make bounded wait deterministic with per-server test timeout
Seagulls Oct 31, 2026
ca995ab
test(api): bound active-writer 409 checks without 30-second test hangs
Seagulls Oct 31, 2026
66b7efa
test(api): one root request waits for native writer and preserves bytes
Seagulls Oct 31, 2026
eea37f7
test(e2e): rely on one server-side bounded wait, not repeated client …
Seagulls Oct 31, 2026
985ef27
fix(native): avoid blocking timer drain on cancelled admission
Seagulls Oct 31, 2026
2254c25
Index no-wait tests: the rebuild is held while they check
Omar-VF Nov 2, 2026
7de4b01
Merge pull request #143 from Liquid-co/fix/index-nowait-test
Omar-VF Nov 2, 2026
89ea0bb
Merge pull request #131 from Seagulls/fix/native-ownership-fail-closed
Omar-VF Nov 2, 2026
4bc4011
Changelog: #92, #93, #109, #114, #117, #121, #125, #126, #129, #131
Omar-VF Nov 2, 2026
fdcce24
Merge pull request #144 from Liquid-co/changelog/unreleased-batch-8
Omar-VF Nov 2, 2026
3db31bb
fix(backup): reconcile import admission with merged upstream ownershi…
Nov 2, 2026
913f79b
test(backup): prove HTTP rollback after registration failure
Nov 2, 2026
8159c99
fix(native): reconcile topology admission with merged upstream and fo…
Nov 2, 2026
dbdace9
Merge pull request #124 from Janlhin/pr-3-conflicts-and-settings
Omar-VF Nov 3, 2026
c5a7352
i18n: extract Devices and the root App
Janlhin Nov 3, 2026
24753b5
Merge pull request #139 from Seagulls/fix/upstream-root-topology
Omar-VF Nov 3, 2026
24b29c8
A drive that is not ready does not hold a save folder
Omar-VF Nov 5, 2026
5c43384
Merge pull request #147 from Liquid-co/fix/relocate-unready-drive
Omar-VF Nov 5, 2026
8b591d8
Merge pull request #134 from Liquid-co/fix/watcher-dir-delete
Omar-VF Nov 7, 2026
abce458
Folder-trust table as migration 0044
Oct 27, 2026
4b0a18f
Say an offer once, not at every sync
Oct 27, 2026
81c9113
Set the trust flag after the peer entry is built
Oct 27, 2026
fcfe98b
Folder trust: a database from a build with migration 0038 opens
Omar-VF Nov 7, 2026
3fb4ad3
Merge pull request #150 from Liquid-co/merge/dev-followups
Omar-VF Nov 7, 2026
6bf661f
Find Cemu on Windows, and stamp the Deck plugin with the release tag
Omar-VF Nov 7, 2026
cc685d7
fix(store): isolate import claims and bound registration waits
Nov 7, 2026
3eb6154
Merge pull request #151 from Liquid-co/fix/cemu-and-plugin-version
Omar-VF Nov 7, 2026
304f78a
Merge pull request #145 from Janlhin/pr-4-devices-and-app
Omar-VF Nov 7, 2026
f2a341e
Merge pull request #27 from Seagulls/fix/pr141-sidecar-bounded-wait
Seagulls Nov 7, 2026
02859f6
chore: remove supplementary import admission documentation
Nov 7, 2026
0b39dc8
i18n: finish the two app strings left over from #145
Janlhin Nov 7, 2026
4764979
Merge pull request #152 from Janlhin/fix/145-app-strings
Omar-VF Nov 9, 2026
a9e7045
fix(store): reserve import claim only for path changes
Nov 9, 2026
0fe57b4
test(store): keep metadata writable during import admission
Nov 9, 2026
9435e80
Merge pull request #28 from Seagulls/fix/pr141-metadata-admission-202…
Seagulls Nov 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -235,6 +235,17 @@ jobs:
cp opensave-decky-plugin/package.json decky-pkg/OpenSave/
cp opensave-decky-plugin/main.py decky-pkg/OpenSave/
cp opensave-decky-plugin/dist/index.js decky-pkg/OpenSave/dist/
# The zip says the version of the tag it is released under. Plugin
# managers compare the two, and a mismatch offers the same update
# again and again (#149). A manual run has no tag: it keeps the files'.
if [ "$GITHUB_REF_TYPE" = "tag" ]; then
V="${GITHUB_REF_NAME#v}"
for f in plugin.json package.json; do
jq --arg v "$V" '.version = $v' "decky-pkg/OpenSave/$f" > "$f.stamped"
mv "$f.stamped" "decky-pkg/OpenSave/$f"
test "$(jq -r .version "decky-pkg/OpenSave/$f")" = "$V"
done
fi
(cd decky-pkg && zip -r ../OpenSave-decky-plugin.zip OpenSave)
unzip -l OpenSave-decky-plugin.zip

Expand Down
49 changes: 48 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,9 +157,54 @@ All notable changes to OpenSave are documented here. This project adheres to
backup or an earlier install, it simply takes the newer save. (#106)
- **A Steam folder holding only Steam's own file is not offered as a game
with saves.** (#115)
- **A game waiting for a folder no longer stays on Home once it syncs.** And
when a game is offered, OpenSave now looks for its folder straight away
rather than at the next hourly scan, so a game you have already played on
this device starts syncing within seconds.
- **A game's extra save folders get the same protection as its main one.**
A sync no longer overwrites or deletes files in an additional save
location without a safety snapshot that holds them first, and resolving a
conflict there leaves it open if that snapshot, or the other device, is
not available. "Keep theirs" now takes exactly the other device's copy.
(#92, #93, issues #82 and #83)
- **Two games can no longer claim the same save folder.** Tracking or moving
a game is refused when the folder, or one inside or above it, already
belongs to another game, through a link too; and when OpenSave cannot
check, it refuses rather than guessing. (#131, issue #130)
- **A save folder OpenSave may not write to is said once.** One under Program
Files, say, showed the same "access denied" error at every sync. OpenSave
now says what to do, and tries again in half an hour; a file the game just
has open is retried as usual. (#114)
- **The "After playing" snapshot is no longer taken twice** when the game
saved in the very moment its session began. (#125)

### Changed

- **A game being played is not synced until you stop.** Its autosaves no
longer go to your other devices one by one while you play, and a game
running here never has a save written under it. When the session ends,
the save as you left it is kept and synced once. (#117)
- **On Steam Deck, a game starts with its newest save.** The Game Mode
plugin holds a game's launch until its save has synced, for up to 30
seconds ("Wait for the save before starting", on by default), and tells
OpenSave when you start and stop playing, so each session gets its "After
playing" snapshot. (#109)

- **Games from your other devices set themselves up again.** 2.4.1 stopped
another device from choosing folders on this one, and in doing so made
many games wait on Home for you to pick a folder. Now a game arriving from
another device is tracked by itself wherever this device can tell the
folder is that game's save: where the save catalogue or Steam says the game
keeps its saves here, even before you have played it (so a new PC fills
itself in, saves in place before first launch), in an emulator's save
folder, or a folder a scan has seen. The other device still chooses
nothing.
- **Trust your own devices to choose folders.** For a folder this device
can't recognise, such as one you tracked by hand on the other device, the
game still waits on Home for you to place it. On Devices, "Trust it to
choose folders" lets one of your own devices decide instead, as every
device could before 2.4.1 (`opensave peers trust <device> on`). It is off
until you turn it on, asks first, and goes when the device is unpaired.
- **Much faster with saves of many files.** Checking a 240,000-file save for
changes went from 13–19 seconds to about 1.3, and a follow-up snapshot
copies the unchanged files from the one before instead of compressing them
Expand Down Expand Up @@ -204,7 +249,9 @@ All notable changes to OpenSave are documented here. This project adheres to
folder" finds a game by name, by the program you pick, or one that is
running, and tracks it with its name, cover and save folder. A folder
inside one that is already tracked is refused, with an offer to link the
two instead. (#73)
two instead. The games running now are listed first. (#73, #126)
- **RetroDECK's saves are found by the scan,** wherever RetroDECK is
installed, as EmuDeck's are. (#121, #129)
- **Rename a game.** A pencil beside a game's name on its page — or
"Rename…" in its menu and Ctrl+K, or `opensave rename` — changes what this
device calls it. Your other devices keep their own name, and syncing,
Expand Down
47 changes: 21 additions & 26 deletions cmd/opensave-app/frontend/src/App.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
import { startController, controllerOn, padUsed, pageStep } from './lib/controller.js';
import { startFocusRing } from './lib/focusring.js';
import { appearance } from './lib/appearance.js';
import { locale, resolveLocale } from './lib/i18n.js';
import { locale, resolveLocale, t } from './lib/i18n.js';
import { paletteOpen } from './lib/shortcuts.js';
import { newlyEmptied } from './lib/emptied.js';
import { demandAttention } from './lib/notify.js';
Expand Down Expand Up @@ -111,13 +111,13 @@
const { now, fresh } = newlyEmptied(emptiedBefore, all);
emptiedBefore = now;
for (const g of fresh) {
toast(`Every save file of ${g.name} was deleted here. Your other devices keep theirs until you choose.`, 'warning', {
toast($t('app.emptiedBody', { name: g.name }), 'warning', {
ttl: 15000,
action: { label: 'Choose', run: () => navigate('game', { gameId: g.id }) }
action: { label: $t('app.choose'), run: () => navigate('game', { gameId: g.id }) }
});
demandAttention('emptied', {
title: g.name,
body: 'Every save file was deleted here. Your other devices keep theirs until you choose.',
body: $t('app.emptiedBody', { name: g.name }),
game: g
});
}
Expand Down Expand Up @@ -198,45 +198,45 @@
<div class="update-banner installing">
<span class="with-icon">
{#if $appUpdate.state === 'downloading'}
<Download size={16} /> Updating OpenSave — downloading {$appUpdate.percentage ?? 0}%…
<Download size={16} /> {$t('app.updatingDownloading', { n: $appUpdate.percentage ?? 0 })}
{:else if $appUpdate.state === 'installing'}
<Wrench size={16} /> Installing update…
<Wrench size={16} /> {$t('app.installingUpdate')}
{:else}
<RefreshCw size={16} /> Restarting with the new version…
<RefreshCw size={16} /> {$t('app.restartingVersion')}
{/if}
<em>The app restarts itself when done — your games keep syncing.</em>
<em>{$t('app.restartsItself')}</em>
</span>
</div>
{:else if update}
<div class="update-banner">
<span class="with-icon"><Sparkles size={16} /> OpenSave {update.latest} is available — you're on {update.current}.</span>
<span class="with-icon"><Sparkles size={16} /> {$t('app.updateAvailable', { latest: update.latest, current: update.current })}</span>
<div class="update-actions">
{#if update.notes}
<button class="btn small ghost" on:click={() => (showNotes = !showNotes)}>
{showNotes ? 'Hide notes' : "What's new"}
{showNotes ? $t('app.hideNotes') : $t('app.whatsNew')}
</button>
{/if}
{#if update.assetUrl}
<button class="btn small primary" disabled={installStarted} on:click={installRelease}>
{installStarted ? 'Starting…' : 'Install & restart'}
{installStarted ? $t('app.starting') : $t('app.installRestart')}
</button>
{:else if update.flatpak}
<button class="btn small primary" on:click={() => native.openExternal(update.url)}>Get .flatpak</button>
<button class="btn small primary" on:click={() => native.openExternal(update.url)}>{$t('app.getFlatpak')}</button>
{:else}
<button class="btn small primary" on:click={() => native.openExternal(update.url)}>Download</button>
<button class="btn small primary" on:click={() => native.openExternal(update.url)}>{$t('app.download')}</button>
{/if}
<button class="btn small ghost icon" on:click={() => (update = null)} aria-label="Dismiss" title="Dismiss"><X size={15} /></button>
<button class="btn small ghost icon" on:click={() => (update = null)} aria-label={$t('common.dismiss')} title={$t('common.dismiss')}><X size={15} /></button>
</div>
</div>
{#if showNotes && update.notes}
<div class="update-notes">{update.notes}</div>
{/if}
{:else if updatedTo}
<div class="update-banner">
<span class="with-icon"><Sparkles size={16} /> OpenSave was updated to v{updatedTo}.</span>
<span class="with-icon"><Sparkles size={16} /> {$t('app.updatedTo', { version: updatedTo })}</span>
<div class="update-actions">
<button class="btn small primary" on:click={openWhatsNew}>What's new</button>
<button class="btn small ghost icon" on:click={() => (updatedTo = '')} aria-label="Dismiss" title="Dismiss"><X size={15} /></button>
<button class="btn small primary" on:click={openWhatsNew}>{$t('app.whatsNew')}</button>
<button class="btn small ghost icon" on:click={() => (updatedTo = '')} aria-label={$t('common.dismiss')} title={$t('common.dismiss')}><X size={15} /></button>
</div>
</div>
{/if}
Expand All @@ -252,13 +252,13 @@
{#if bootError}
<div class="boot-error">
<img class="boot-logo" src={logoUrl} alt="OpenSave" />
<h2>OpenSave failed to start</h2>
<h2>{$t('app.failedToStart')}</h2>
<p>{bootError}</p>
<button class="btn primary" disabled={retrying} on:click={boot}>
{retrying ? 'Retrying…' : 'Retry'}
{retrying ? $t('app.retrying') : $t('app.retry')}
</button>
<p class="boot-hint">
Details are saved to <code>.opensave\opensave.log</code> in your user folder.
{$t('app.detailsSaved')}
</p>
</div>
{:else if ready}
Expand Down Expand Up @@ -290,7 +290,7 @@
{:else}
<div class="boot-loading">
<img class="boot-logo pulse" src={logoUrl} alt="OpenSave" />
<span>Starting OpenSave…</span>
<span>{$t('app.startingOpenSave')}</span>
</div>
{/if}
</div>
Expand Down Expand Up @@ -361,11 +361,6 @@
color: var(--text-dim) !important;
font-size: 0.8rem;
}
.boot-hint code {
background: var(--bg-raised);
padding: 1px 5px;
border-radius: 5px;
}
.update-banner {
display: flex;
align-items: center;
Expand Down
Loading
Loading