Skip to content

Improve Analogue Pocket Core setup #86

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nickhamze merged 1 commit into from
Jul 29, 2026
Merged

Improve Analogue Pocket Core setup #86

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
23 changes: 23 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,29 @@ records those user-visible changes. Published releases use semantic versioning.

## [Unreleased]

### Added

- Adds a privacy-safe Analogue Pocket card check with clear layout, Core,
game-count, legacy-folder, and repair findings plus a copyable support
summary that omits card names, paths, device identifiers, game names, and
save data.
- Adds state-aware Pocket actions for first install, update, already-current
verification, and repair, followed by exact next steps on the Pocket.

### Changed

- Gives SwanSong Core releases their own strict `core-vX.Y.Z` namespace so
unrelated homebrew published from the same repository is never presented as
a Core update.

### Fixed

- Blocks automatic Core downgrades and development-version replacement, and
rechecks the selected card before and after downloading so a changed card
cannot bypass those protections.
- Correctly treats the repository’s current SWANFRAME release as unrelated
homebrew instead of a broken or mutable SwanSong Core release.

## [0.9.1] - 2026-07-28

**A Better Welcome.** SwanSong 0.9.1 makes the first launch clearer, the
Expand Down
20 changes: 13 additions & 7 deletions PRIVACY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,8 +45,13 @@ identity, saves, and states.
When you choose an Analogue Pocket SD card, SwanSong reads the mounted volume's
name, filesystem type, capacity, top-level folder names, installed SwanSong
`core.json` version (if present), and only the Core-managed files that a
verified package may replace. It does not read or upload game, save, Memory,
Settings, or Preset contents from the card.
verified package may replace. If you choose **Check Card**, it also reads the
names, file types, and extensions of bounded entries below the standard
WonderSwan game folder to count regular `.ws` and `.wsc` files; it does not
open or hash them and does not follow symbolic links. The copyable summary
omits the card name, path, device identifier, game filenames, and save data.
SwanSong does not read or upload game contents, save contents, Memories,
Settings, or Presets from the card.

In Cartridge Lab, when you choose a flash-cartridge SD-card folder, SwanSong
reads that folder only to select a non-conflicting installer filename, writes
Expand Down Expand Up @@ -245,11 +250,12 @@ install games, or invoke the separate Analogue Pocket installer.

The **Analogue Pocket** tool makes no request at launch, in the background, or
merely because you open its page. Choosing **Check for Core Release** requests
the official `RegionallyFamous/swansong-core` latest-release record through the
GitHub HTTPS API. If an immutable authorized stable release exists, SwanSong
then fetches that release's small `release-manifest.json` and `SHA256SUMS`
assets. Choosing and confirming **Prepare SD Card** downloads the named Core ZIP
from the same official GitHub Release.
the official `RegionallyFamous/swansong-core` release list through the GitHub
HTTPS API. SwanSong ignores releases outside the stable `core-vX.Y.Z`
namespace. If an immutable authorized Core release exists, SwanSong then
fetches that release's small `release-manifest.json` and `SHA256SUMS` assets.
Confirming an install, update, verification, or repair downloads the named Core
ZIP from the same official GitHub Release.

The manifest's publisher, release authorization, completed release gates,
package identity, byte count, and SHA-256 must agree with the GitHub release
Expand Down
12 changes: 9 additions & 3 deletions SUPPORT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,13 +85,19 @@ Pocket SD Card…**. Then:

1. Find the official SwanSong Core.
2. Choose the mounted SD card itself.
3. Review the exact card and version, then install.
3. Review the exact card, installed version, available version, and proposed
action.
4. Optionally choose **Check Card**. If you need help, copy its privacy-safe
summary.
5. Install, update, verify or repair, or repair as offered.

Use an exFAT or FAT32 card and back it up first. SwanSong works with blank and
existing Pocket cards. It does not format the card or remove games, saves,
settings, Memories, Presets, or other cores. It checks the available space,
verifies the files after writing them, and rolls back if the install cannot be
confirmed. Eject the card in Finder before removing it.
blocks automatic downgrades, verifies the files after writing them, and rolls
back if the install cannot be confirmed. The card-check summary omits card
names, paths, device identifiers, game names, and save data. Eject the card in
Finder before removing it.

### How do I read my own cartridge?

Expand Down
Loading