feat(saves): Open saves folder and Open builds folder buttons #185

Open
dyst wants to merge 7 commits from dyst/LongshotLauncher:feat/open-folders into main
Member

Players who want to look at their saves or builds, or copy them by hand, had to know where the launcher keeps them. Now one click opens each folder in the file manager.

Stacked on #184: merge order #182, #184, then this (#180 and #181 are merged).

What changed

  • Saves page: an Open saves folder button in the Your Longshot saves header, beside the slot count. It opens Longshot's save folder, the one every build shares (%APPDATA%\Longshot\save\ on Windows, ~/.local/share/longshot/save/ on Linux, a portable launcher's LongshotLauncher-data\user\save\). Its tooltip shows the path.
    • When there is no save folder yet, it is made first, as an import makes it. An empty save folder is what the game makes too, and it gives a player somewhere to put saves by hand. If it can't be made, a toast says why.
  • Settings: a folder button at the end of the Builds folder row opens the builds folder (the default one, a portable launcher's, or the one picked).
    • Until the first build makes that folder, the button is off and its tooltip says Not made yet: the first build makes it. A typed folder isn't made just to be shown, since it may be mistyped.
  • Both go through the existing Host.Open, the same as a build row's Open folder: Explorer on Windows, xdg-open on Linux and the Steam Deck.
  • SaveEnvironment.SaveFolder names the save folder once. The Saves page, the .zip export and Saves.SharedSavePath now use it rather than each joining save themselves.
  • README and docs/saves.md: one line each.
  • Four new texts, in all 12 languages: they need a native speaker's check.

Tests

  • python -I tests/test_launcher_core.py: 1742 checks passed. A new check in DeleteSaveChecks: SaveFolder is LongshotUser's save on Windows and Linux, the folder ImportTarget's profile is in.
  • python -I tests/test_release.py: 37 tests OK.
  • dotnet build App -c Release: 0 warnings, 0 errors.
  • Not tried in the real window or on Linux: the screens below are from tools/screenshots.

Screenshots

Before (#184's head) and after, in the comment below.

šŸ¤– Generated with Claude Code

Players who want to look at their saves or builds, or copy them by hand, had to know where the launcher keeps them. Now one click opens each folder in the file manager. **Stacked on #184:** merge order #182, #184, then this (#180 and #181 are merged). ## What changed - **Saves page:** an **Open saves folder** button in the *Your Longshot saves* header, beside the slot count. It opens Longshot's `save` folder, the one every build shares (`%APPDATA%\Longshot\save\` on Windows, `~/.local/share/longshot/save/` on Linux, a portable launcher's `LongshotLauncher-data\user\save\`). Its tooltip shows the path. - When there is no save folder yet, it is made first, as an import makes it. An empty save folder is what the game makes too, and it gives a player somewhere to put saves by hand. If it can't be made, a toast says why. - **Settings:** a folder button at the end of the *Builds folder* row opens the builds folder (the default one, a portable launcher's, or the one picked). - Until the first build makes that folder, the button is off and its tooltip says *Not made yet: the first build makes it*. A typed folder isn't made just to be shown, since it may be mistyped. - Both go through the existing `Host.Open`, the same as a build row's *Open folder*: Explorer on Windows, `xdg-open` on Linux and the Steam Deck. - `SaveEnvironment.SaveFolder` names the save folder once. The Saves page, the .zip export and `Saves.SharedSavePath` now use it rather than each joining `save` themselves. - README and `docs/saves.md`: one line each. - Four new texts, in all 12 languages: they need a native speaker's check. ## Tests - `python -I tests/test_launcher_core.py`: 1742 checks passed. A new check in `DeleteSaveChecks`: `SaveFolder` is `LongshotUser`'s `save` on Windows and Linux, the folder `ImportTarget`'s profile is in. - `python -I tests/test_release.py`: 37 tests OK. - `dotnet build App -c Release`: 0 warnings, 0 errors. - Not tried in the real window or on Linux: the screens below are from `tools/screenshots`. ## Screenshots Before (#184's head) and after, in the comment below. šŸ¤– Generated with [Claude Code](https://claude.com/claude-code)
The home's left side gets a Track dropdown (stable, rc, nightly, each saying what
is installed on it) and a Version dropdown (that track's versions from the update
check, a check beside the installed one, the default and the newest marked). The
button below follows the pick (Core/VersionPick.cs): Play when it is installed,
Update to or Go back to when the track has a build of another version (built in
its place, in its folder: one build per track), Build when the track has none.
Remove sits beside Play and opens the row's Delete as it is.

The rows' Other versions (the clock) and its dialog go: the Version dropdown does
what it did, for any track. Build another version stays, for a second build of a
track or building one again.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
feat(home): the list of builds is "Your instances"
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
eca781b139
Each row is a build in a folder of its own, which can change version
(update, go back), so "Your versions" read as a list of releases.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Export saves… and From an emulator… gain "A .zip file…". The export writes the save files of Longshot's save folder
(account.sav, option.sav, slot_NN/progress.sav and caption.sav, with their times) and a small note
(longshot-save.json) into a file the Save As dialog picks, made beside it and renamed into place. The import checks the
zip as a Hookshot save is checked (only save files, no path out of it, no link, sizes, at least one slot with a
progress.sav; a bomb stops at what comes out, whatever the zip claims), unpacks it into a temporary folder of its own,
and copies it in as an import from a folder: confirmed first, Longshot's save backed up (import-zip-<stamp>).

Core/SaveArchive.cs with tests/launcher_core/SaveArchiveChecks.cs; the Saves scenes in tools/screenshots; docs/saves.md
"As a .zip file"; the new texts in the 12 full catalogs.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
feat(saves): the .zip holds Longshot's whole save folder, as it is, and imports back whole
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
3fe0c907b9
The zip is now the save folder itself: save/ as its top folder and everything in it, every profile, slot, file and folder
(nested and empty ones too), with their times. Nothing from beside it in the user folder (longshot_options.ini,
mouse_sens.txt, present.txt: the settings are separate); links and junctions are left out, never followed, and the result
page names them. The note is the zip's comment instead of a file among the saves.

Importing such a zip (every entry under save/, Longshot's profile holding a save) takes it as it is, checked for safety only
(no path out of it, no link, no file twice, the caps), and puts it in place of Longshot's whole save folder: backed up whole
first (import-zip-<stamp>), made beside it, two renames. Any other zip (by hand, Hookshot's, an emulator's, a slot's, the
launcher's first ones) keeps the save-files-only rule. Caps raised for a whole folder: 512 MB zip and unpacked, 10,000
entries, 64 MB a file; the export refuses a folder above them, so every zip it writes imports again.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Every copy backs up what it replaces, but getting a backup back meant copying folders by hand. The Saves page gains
"Restore from a backup…" (under the slots): a page listing every save in the backups folder, newest first, with what
made it (an import, an export, Hookshot's import, the versions' saves brought together, a version deleted), when, its
slots and its size, the folder of each one a click away. Restore… opens the import's confirmation: the backup's slots,
what they replace, Keep Longshot's game settings, and Longshot's own save backed up first (restore-backup-<stamp>).
The backup itself is only read; nothing on the page deletes one.

Core/SaveBackups.cs with tests/launcher_core/SaveBackupsChecks.cs; SaveMode.Restore through the confirm and result
pages; App/Views/BackupsView.axaml; the backup scenes in tools/screenshots; docs/saves.md "Restore from a backup"; the
new texts in the 12 full catalogs. Stacked on the .zip export and import.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
test(saves): a whole save folder's import from a .zip is listed among the backups, and restored
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
04f099d93f
Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
fix(home): offer to rename instances' folders an old launcher named after a version
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
0fc4752372
Launchers before v1.0.0-rc.7 named a new build's folder after the version it
first built (LauncherSettings.FolderFor took the version until #104), and an
update stays in its build's folder (BuildRegistry.FolderOf), so such an
instance keeps its first version's name after every update. New instances are
already named after their track. The home now offers, once, to rename the old
ones after their track (Keep or Rename, InstanceFolders): only listed
instances in the builds folder, renamed in place so everything in them stays,
refused while Longshot runs, for links and for folders holding the home or the
shared saves, and put back if the list cannot be saved.

Checks drive a new instance through the whole path (the folder chosen,
make_game.py's --out, the row kept, an update, a go-back) and the rename.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
feat(saves): Open saves folder and Open builds folder buttons
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 3s
06bc35aec4
The Saves page's header opens Longshot's save folder in the file
manager (made first when there is none yet, as an import makes it), and
the builds folder row in Settings opens the builds folder (off, with the
reason, until the first build makes it). Both go through the existing
Host.Open, as a build row's Open folder does.

SaveEnvironment.SaveFolder names the save folder once; the Saves page,
the .zip export and SharedSavePath use it.

Assisted-by: Claude Code
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Author
Member

Screenshots: before and after

Drawn with tools/screenshots (headless, the same scene and window size on both sides). Before is #184's head, so only this PR's change shows.

The Saves page (saves)

Before: no way to the folder.

saves, before

After: Open saves folder in the header, beside the slot count.

saves, after

Settings, the builds folder row (launcher-settings)

Before: the path and Change.

settings, before

After: a folder button at the end of the row. It's off in this scene, because the scene's builds folder hasn't been made: the tooltip says the first build makes it.

settings, after

## Screenshots: before and after Drawn with `tools/screenshots` (headless, the same scene and window size on both sides). Before is #184's head, so only this PR's change shows. ### The Saves page (`saves`) **Before:** no way to the folder. ![saves, before](https://git.magicbean.dev/attachments/e17d66d8-3d97-4ab1-845b-4b80030c9bee) **After:** *Open saves folder* in the header, beside the slot count. ![saves, after](https://git.magicbean.dev/attachments/4912c597-99eb-402f-9b69-34db2e28fc0b) ### Settings, the builds folder row (`launcher-settings`) **Before:** the path and Change. ![settings, before](https://git.magicbean.dev/attachments/82514c25-97c6-43d3-ad41-94a90ab70c5d) **After:** a folder button at the end of the row. It's off in this scene, because the scene's builds folder hasn't been made: the tooltip says the first build makes it. ![settings, after](https://git.magicbean.dev/attachments/d9679208-1a7d-490a-ad7f-cfac86ce89ae)
dyst force-pushed feat/open-folders from 06bc35aec4
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 3s
to b489bc5ca0
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 2s
2026-11-17 21:14:24 +00:00
Compare
Author
Member

Rebased onto main (8594b47: #180, #171 and #179 merged). Only the language files and the screenshot tool's scene list conflicted, both sides adding entries; both kept, each catalog checked as JSON with no duplicate key, the app and the screenshot tool build with 0 warnings. The code is otherwise unchanged, so the earlier test runs stand. Merge order: #181, #182, #184, #185.

Rebased onto main (8594b47: #180, #171 and #179 merged). Only the language files and the screenshot tool's scene list conflicted, both sides adding entries; both kept, each catalog checked as JSON with no duplicate key, the app and the screenshot tool build with 0 warnings. The code is otherwise unchanged, so the earlier test runs stand. Merge order: #181, #182, #184, #185.
dyst force-pushed feat/open-folders from b489bc5ca0
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 2s
to acbcd2c366
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 10s
2026-11-17 21:49:50 +00:00
Compare
Author
Member

Description: the stack's merge order and the row's new name.

Description: the stack's merge order and the row's new name.
Author
Member

Rebased onto the reworked #184 (d9f5559): this PR is its own commit again, acbcd2c. The Open builds folder button stays at the end of the builds folder row, which #184 renamed to BUILDS FOLDER with a hint saying what lives there. Conflicts were the Settings row's label and grid, the README's Settings sentence and the language files (both sides kept, #184's replaced texts removed, each file checked as JSON). Checks: test_launcher_core.py 1799 passed, test_release.py OK, dotnet build App -c Release 0 warnings, 0 errors. Merge order: #182, #184, then this.

The row after the rebase:

after the rebase

Rebased onto the reworked #184 (d9f5559): this PR is its own commit again, acbcd2c. The *Open builds folder* button stays at the end of the builds folder row, which #184 renamed to **BUILDS FOLDER** with a hint saying what lives there. Conflicts were the Settings row's label and grid, the README's Settings sentence and the language files (both sides kept, #184's replaced texts removed, each file checked as JSON). Checks: `test_launcher_core.py` 1799 passed, `test_release.py` OK, `dotnet build App -c Release` 0 warnings, 0 errors. Merge order: #182, #184, then this. The row after the rebase: ![after the rebase](https://git.magicbean.dev/attachments/f232ca0a-a3a9-4533-be16-c6ac0a7c90dd)
All checks were successful
CI / Compile and test (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 10s
This pull request has changes conflicting with the target branch.
  • App/MainWindow.axaml
  • App/ViewModels/SavesViewModel.cs
  • App/Views/SavesView.axaml
  • App/Views/Views.cs
  • Core/Lang/de.json
  • Core/Lang/es.json
  • Core/Lang/fr.json
  • Core/Lang/it.json
  • Core/Lang/ja.json
  • Core/Lang/ko.json
  • Core/Lang/nl.json
  • Core/Lang/pl.json
  • Core/Lang/pt-BR.json
  • Core/Lang/ru.json
  • Core/Lang/zh-Hans.json
  • Core/Lang/zh-Hant.json
  • README.md
  • docs/saves.md
  • tests/launcher_core/Program.cs
  • tools/screenshots/Program.cs
View command line instructions

Manual merge helper

Use this merge commit message when completing the merge manually.

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u 'feat/open-folders:dyst-feat/open-folders'
git switch 'dyst-feat/open-folders'
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
MagicBeanDev/LongshotLauncher!185
No description provided.