Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
210 commits
Select commit Hold shift + click to select a range
107ad09
wip: generalization checkpoint (catalog, Steam sources, shared presen…
Bium23 Nov 13, 2026
0a46af7
feat: Steam squares use the app's own icon, never a cropped cover
Bium23 Nov 13, 2026
6fe3177
feat: Steam games use the shared Selene head and hero
Bium23 Nov 13, 2026
feb7742
fix: keep game art between Steam and nxnative games
Bium23 Nov 13, 2026
b92b531
feat: Steam games get the Spotlight page below the head
Bium23 Nov 13, 2026
95582ee
feat: Steam backgrounds prefer screen-shaped art
Bium23 Nov 13, 2026
3471549
feat: Steam Play with real sessions
Bium23 Nov 13, 2026
ff52c65
feat: Steam Options replace the separate Steam page
Bium23 Nov 13, 2026
554b57a
fix: Steam sessions survive an NX Library restart
Bium23 Nov 13, 2026
b814538
feat: Steam art shows at once and LaunchBox finds PC art
Bium23 Nov 14, 2026
c4f134a
feat: Keep Steam in the background while a game starts
Bium23 Nov 14, 2026
20494a2
feat: Settings groups keep Switch and Steam apart
Bium23 Nov 14, 2026
db29089
fix: Settings sidebar follows the selected section
Bium23 Nov 14, 2026
2f73234
fix: Settings sidebar scrolls to the selection at once
Bium23 Nov 14, 2026
a63bd78
fix: Settings Search waits for the player to open its field
Bium23 Nov 14, 2026
2ba7b20
fix: Esc in Settings Search closes the field, not Settings
Bium23 Nov 14, 2026
d5440ff
fix: moonlight keeps 60 fps on ProMotion while nothing else moves
Bium23 Nov 14, 2026
7a8f284
fix: Steam heads arrive exactly like Switch ones
Bium23 Nov 14, 2026
c4e18ff
feat: Steam backgrounds also look for LaunchBox fan art
Bium23 Nov 14, 2026
e07686e
fix: a Steam session follows the process it saw start
Bium23 Nov 14, 2026
324451b
feat: Switch-only settings move into the Switch group
Bium23 Nov 14, 2026
4ab1e83
chore: drop the unused Steam backdrop view and orphan strings
Bium23 Nov 14, 2026
0300f09
fix: app data roots are folders before they exist
Bium23 Nov 14, 2026
81fda68
fix: Steam art decodes off the main thread like nxnative art
Bium23 Nov 14, 2026
64fbf7f
fix: Collection's head fades with Spotlight's curve
Bium23 Nov 14, 2026
3150129
fix: drop two concurrency warnings and an unused notification
Bium23 Nov 14, 2026
e70772c
fix: Steam Play checks processes cheaply; drop unused capability rules
Bium23 Nov 14, 2026
af95878
feat: read Steam's local playtime for the current account
Bium23 Nov 14, 2026
71e29d3
feat: play totals combine Steam's baseline with newer sessions
Bium23 Nov 14, 2026
5b38a05
feat: Steam playtime baselines follow Steam's local file
Bium23 Nov 14, 2026
ad6d567
docs: Steam playtime
Bium23 Nov 14, 2026
d83c99c
fix: Steam playtime keeps its last good totals while Steam rewrites i…
Bium23 Nov 14, 2026
a3c6687
fix: a rising Steam value never steps the total back
Bium23 Nov 14, 2026
9c702cd
fix: trimmed sessions after Steam's value still count
Bium23 Nov 14, 2026
3056963
fix: Steam playtime rules are testable and never show another account
Bium23 Nov 14, 2026
d1a8f13
docs: Steam playtime carry, trimmed sessions and sync rules
Bium23 Nov 14, 2026
05be49f
fix: Steam playtime holds up across accounts, launch and hidden totals
Bium23 Nov 14, 2026
c2a1aa8
feat: a game that starts leads the Spotlight row
Bium23 Nov 14, 2026
4c2f85a
feat: NX Library comes back after a Steam game played from it
Bium23 Nov 14, 2026
581428d
feat: Steam games show Steam as their platform, with Valve's logo
Bium23 Nov 14, 2026
370dca3
docs: return to NX Library, Spotlight order and the Steam platform logo
Bium23 Nov 14, 2026
72b665e
fix: Steam return, Spotlight order and the logo stat hold up in edge …
Bium23 Nov 14, 2026
2f0d4ee
fix: the PLATFORM label is back over the Steam logo
Bium23 Nov 14, 2026
8717f2f
feat: the session card shows after a Steam game too
Bium23 Nov 14, 2026
b29a001
feat: Steam games wait in NX Library's launch screen
Bium23 Nov 14, 2026
836eb24
fix: the Steam launch screen never sticks or fights the player
Bium23 Nov 14, 2026
3a7a39b
feat: the launch screen's game logo breathes while the game starts
Bium23 Nov 14, 2026
2f3c746
fix: only the display link draws Moonlight on macOS 14
Bium23 Nov 14, 2026
3270dc4
feat: the Steam launch screen covers the screen in its own window
Bium23 Nov 14, 2026
be8cc79
docs: the launch screen stays on every Space by choice
Bium23 Nov 15, 2026
751e1f3
feat: read Steam's binary KeyValues
Bium23 Nov 15, 2026
edc18a6
feat: read a Steam game's achievements from Steam's cache
Bium23 Nov 15, 2026
7a4f27e
feat: summarize a game's achievements
Bium23 Nov 15, 2026
d34b3b0
feat: Steam's public achievement rarity and icons
Bium23 Nov 15, 2026
6ff19c7
feat: focus for the achievements tile and screen
Bium23 Nov 15, 2026
570f444
feat: load Steam achievements off the main thread
Bium23 Nov 15, 2026
7883a78
feat: summary tiles replace Your activity
Bium23 Nov 15, 2026
bc3a829
feat: an Achievements screen for Steam games
Bium23 Nov 15, 2026
a985778
fix: achievements review findings
Bium23 Nov 15, 2026
6c8f56e
feat: achievements card beside About, no summary tiles
Bium23 Nov 15, 2026
394e251
fix: Read more reachable from Build & Sources
Bium23 Nov 15, 2026
af8e970
feat: Steam scan tells downloading games apart
Bium23 Nov 15, 2026
7073c87
feat: downloading Steam games stay in the library
Bium23 Nov 15, 2026
0c63cab
feat: a download tile for Steam games being installed
Bium23 Nov 15, 2026
e64ddfa
feat: Steam downloads in place of Play while installing
Bium23 Nov 15, 2026
05cdedb
feat: rescan Steam when a manifest changes
Bium23 Nov 15, 2026
47144fb
docs: Steam downloads
Bium23 Nov 15, 2026
f2424ca
fix: Steam watcher lifetime and dropped events
Bium23 Nov 15, 2026
157e5c4
fix: a downloading Steam game's tile shows its art
Bium23 Nov 15, 2026
9f5818a
fix: a Steam game without its app gets LaunchBox's Square as icon
Bium23 Nov 15, 2026
54f163f
feat: the download mark breathes
Bium23 Nov 15, 2026
28dac2c
feat: a downloading tile keeps a hint of its colours
Bium23 Nov 15, 2026
d951533
revert: full black and white for a downloading tile
Bium23 Nov 15, 2026
080ef80
fix: the download light sits outside the flattened tile
Bium23 Nov 15, 2026
d59fc57
feat: Downloading on Steam pill and a pulsing thin download mark
Bium23 Nov 15, 2026
0e3f02a
fix: a downloading game's pill reads Downloading, as Porting does
Bium23 Nov 15, 2026
a297700
feat: Steam tiles drop the Steam label
Bium23 Nov 15, 2026
1ec290f
feat: a game Steam downloads leads the row, as a porting game does
Bium23 Nov 15, 2026
9d380bf
docs: one Steam reference, architecture keeps a summary
Bium23 Nov 15, 2026
1fe2ac9
feat: the achievements block sits open on the art
Bium23 Nov 15, 2026
bbe47c7
fix: the open achievements block reads on any art and clears its title
Bium23 Nov 15, 2026
7227077
feat: a soft fading shade behind the achievements block
Bium23 Nov 15, 2026
853f9b2
feat: achievements in a light outlined panel
Bium23 Nov 15, 2026
a45af70
feat: player-facing details rows for every source
Bium23 Nov 15, 2026
5930f00
feat: Search Nintendo Store moves to Edit details
Bium23 Nov 15, 2026
e0ce663
feat: one Details panel for every source
Bium23 Nov 15, 2026
b177cef
docs: the Details panel
Bium23 Nov 15, 2026
ef6972a
fix: Play builds an unbuilt game; display names read once
Bium23 Nov 15, 2026
75b4e4a
chore: Details review minors
Bium23 Nov 15, 2026
77c8344
feat: the achievements card reads as a button
Bium23 Nov 15, 2026
6c86f8e
feat: the Achievements screen speaks the card's language
Bium23 Nov 15, 2026
17be452
feat: the achievements card answers the pointer
Bium23 Nov 15, 2026
4235b87
fix: the achievements card fans out slower, without bounce
Bium23 Nov 15, 2026
7898760
fix: the achievements card animates only its own change
Bium23 Nov 15, 2026
0f79fa7
fix: the achievements card moves as one block in the glide
Bium23 Nov 15, 2026
9952314
fix: the Achievements screen fits the window; rows fade at the edges
Bium23 Nov 15, 2026
5bdd06d
fix: the Achievements list scrolls calmly
Bium23 Nov 15, 2026
e7438e3
fix: the Achievements list scrolls on its own offset
Bium23 Nov 15, 2026
7dfe0a1
fix: an arrow on the Achievements list never steps the wrong way
Bium23 Nov 15, 2026
2a6c014
feat: achievement tiers from Steam rarity
Bium23 Nov 15, 2026
84daf03
feat: tier crystal art
Bium23 Nov 15, 2026
cea7e8d
feat: tier crystals on the Achievements screen
Bium23 Nov 15, 2026
65f9b57
fix: a tier follows the percentage the screen shows
Bium23 Nov 15, 2026
3bafe78
feat: achievements list in one column; recent unlocked icons
Bium23 Nov 15, 2026
b3d78ec
feat: Selene layout for the Achievements screen
Bium23 Nov 15, 2026
30401e9
fix: classic tier names; tier counts never truncate
Bium23 Nov 15, 2026
ca17d8c
feat: achievements gauge reads as one block; LB/RB beside the filters
Bium23 Nov 15, 2026
73aa2e5
feat: A opens an achievement's detail; crystals at 512 px
Bium23 Nov 15, 2026
8a213d2
feat: Y orders the achievements; list fades out above the hints
Bium23 Nov 15, 2026
14c1c20
feat: Arcane replaces Platinum; v7 tier crystals
Bium23 Nov 16, 2026
c04d9dc
feat: sharper 1024 px tier crystals
Bium23 Nov 16, 2026
be00b64
feat: tier crystals from the maintainer's own art
Bium23 Nov 16, 2026
f8513b6
feat: Arcane is an orb
Bium23 Nov 16, 2026
315b7b1
feat: the page card shows the best crystal earned
Bium23 Nov 16, 2026
7c93526
feat: achievements card leads with the reward
Bium23 Nov 16, 2026
de63117
feat: Details rows sit on the page, no panel
Bium23 Nov 16, 2026
85af17d
feat: Details in a quiet panel instead of rows
Bium23 Nov 16, 2026
c8f7bb6
fix: restore Details dividers and lighten achievement card
Bium23 Nov 16, 2026
0531095
fix: compact achievement prompts and move order beside Open
Bium23 Nov 16, 2026
0c0f885
fix: restore prompt size and align achievements hints with Home
Bium23 Nov 16, 2026
7adc0ad
fix: unify command bars at Settings position and reserve footer space
Bium23 Nov 16, 2026
f38f0a9
fix: center footer position and shrink only achievement filter prompts
Bium23 Nov 16, 2026
fc90cdf
feat: show critic stars and score in Details
Bium23 Nov 16, 2026
6d5e3e8
fix: resolve store titles and renamed Steam ratings
Bium23 Nov 16, 2026
6c34677
feat: add personal IGDB credentials and critic ratings
Bium23 Nov 16, 2026
fb83d87
feat: group optional API services in settings
Bium23 Nov 16, 2026
c1cd9c9
fix: resolve critic ratings for Switch 2 games
Bium23 Nov 16, 2026
ff2c090
docs: record verified Ocarina IGDB rating availability
Bium23 Nov 16, 2026
b8585f0
feat: show explicit IGDB user score fallback
Bium23 Nov 16, 2026
252725a
feat: offer IGDB metadata in the field picker
Bium23 Nov 16, 2026
824c0ea
feat: add verified public metadata sources
Bium23 Nov 16, 2026
76fcfa9
fix: coordinate metadata description expansion and scrolling
Bium23 Nov 16, 2026
7836c12
fix: tighten IGDB ratings and read downloads in chunks
Bium23 Nov 16, 2026
dbabd83
feat: animate the Arcane orb in the achievements card
Bium23 Nov 16, 2026
0c4fdb0
fix: resume the Arcane video once its first frame is ready
Bium23 Nov 16, 2026
fc74d27
feat: play the Arcane loop at 1.7x
Bium23 Nov 16, 2026
721f387
fix: keep the Arcane orb on whole pixels so it doesn't jump
Bium23 Nov 16, 2026
9b3b2a2
feat: use the maintainer's second Arcane video
Bium23 Nov 16, 2026
05d0c56
Revert "fix: keep the Arcane orb on whole pixels so it doesn't jump"
Bium23 Nov 16, 2026
5c8c180
fix: scale the Arcane orb outside its grey filter
Bium23 Nov 16, 2026
a3e47c3
fix: scale the Arcane video inside its still filter layer
Bium23 Nov 16, 2026
d176029
fix: queue Steam downloads past six and keep decoded achievement icons
Bium23 Nov 16, 2026
822b6a4
feat: show the earned Arcane large and animated on the Achievements s…
Bium23 Nov 16, 2026
f3c63a6
fix: load achievement icons from Steam's community-assets host
Bium23 Nov 16, 2026
9b369d7
feat: name the Arcane instead of 100% on a completed Achievements screen
Bium23 Nov 16, 2026
05da0ba
fix: play the Arcane video at 1.5x
Bium23 Nov 16, 2026
6b2f147
feat: show a completed game's Arcane as a centred medallion
Bium23 Nov 16, 2026
126debd
fix: move gliding pages and lists as one block
Bium23 Nov 16, 2026
7c458e7
fix: keep the focused achievement in view after a re-read reorders th…
Bium23 Nov 16, 2026
8f97293
feat: show an achievement's detail as a centred medallion
Bium23 Nov 16, 2026
f130b6f
feat: blur secret achievements under a lock
Bium23 Nov 16, 2026
6ac2bcb
feat: mirror the game's column in the Achievements header
Bium23 Nov 16, 2026
a70778e
fix: keep the trophies at the top with the gauge under them
Bium23 Nov 16, 2026
40698e1
revert: restore the Achievements header and detail surface
Bium23 Nov 16, 2026
bc1b70c
feat: set the Achievements gauge under the trophies
Bium23 Nov 16, 2026
6a09e6a
style: make the Achievements percentage and bar smaller
Bium23 Nov 16, 2026
c9f5629
fix: drop non-numeric rarities and fail recent misses without queueing
Bium23 Nov 16, 2026
12802d7
refactor: tidy the achievements views
Bium23 Nov 16, 2026
39ad2e2
docs: bring the file map, Steam and architecture notes up to date
Bium23 Nov 16, 2026
5251ebe
fix: address review regressions in Steam and game navigation
Bium23 Nov 16, 2026
016e15e
refactor: remove obsolete library code and exercise the current catalog
Bium23 Nov 16, 2026
429afc1
fix: bind achievement list geometry to each reopened screen model
Bium23 Nov 16, 2026
b6c3e26
refactor: share the Steam available-installation lookup
Bium23 Nov 16, 2026
c88e614
refactor: share Steam KeyValues lookups with explicit duplicate rules
Bium23 Nov 16, 2026
344dca2
docs: add conventions, flows and one validation list; reorganise the …
Bium23 Nov 16, 2026
b5c4c5d
docs: keep designs and plans private
Bium23 Nov 16, 2026
79716d6
feat: show the app as Arcane
Bium23 Nov 17, 2026
f603e60
feat: let updates move to a renamed repository
Bium23 Nov 17, 2026
916bb9f
feat: rename the app file to Arcane on first quit
Bium23 Nov 17, 2026
cd51d75
feat: group settings into General, Library, Porting and System
Bium23 Nov 17, 2026
3c52da7
feat: start with the games already on the Mac
Bium23 Nov 17, 2026
1f745c2
feat: welcome NX Library players to Arcane once
Bium23 Nov 17, 2026
723592e
fix: keep the Steam choice and let Setup lead the welcome
Bium23 Nov 17, 2026
bb2cb9e
fix: let Return reach the welcome, not the game below
Bium23 Nov 17, 2026
655bbd4
fix: open on the welcome and leave it smoothly
Bium23 Nov 17, 2026
30be5a8
feat: time the Spotlight entrance like Selene
Bium23 Nov 17, 2026
f69dcfc
fix: keep the library still under the intro and the welcome
Bium23 Nov 17, 2026
62b377b
feat: polish library entry and launch input
Bium23 Nov 17, 2026
444f03f
docs: record first-run and welcome validation
Bium23 Nov 17, 2026
f1bb3ed
fix: preserve onboarding choices and handle discovery failures
Bium23 Nov 17, 2026
6a54d18
feat: preserve NUP programs and back up all local users
Bium23 Nov 17, 2026
87c3319
docs: record settings and local backup validation
Bium23 Nov 17, 2026
435395c
fix: explain prewarm activity and verify nested app bundles
Bium23 Nov 17, 2026
80a7633
fix: keep Spotlight artwork visible across navigation
Bium23 Nov 17, 2026
cc7d975
fix: preserve app copies and recover legacy library conflicts
Bium23 Nov 17, 2026
f427937
fix: keep first launch usable and gate app regressions
Bium23 Nov 17, 2026
5eb9862
feat: add the Arcane theme and particle controls
Bium23 Nov 17, 2026
86b7671
refactor: keep only soft background particles
Bium23 Nov 17, 2026
0f4b416
feat: render Arcane and Arcane Flow backgrounds live
Bium23 Nov 17, 2026
176b7ba
fix: preserve the original blue default theme
Bium23 Nov 17, 2026
99879cd
fix: restore the actual original blue gradient and fallback
Bium23 Nov 17, 2026
9a37994
fix: bend fine background threads with travelling wind waves
Bium23 Nov 17, 2026
dcef2c9
fix: keep background rendering continuous across screens
Bium23 Nov 17, 2026
86313de
fix: stop per-draw disk reads and close a failed build's files
Bium23 Nov 17, 2026
25804a3
feat: adopt the crystal-in-glass app icon
Bium23 Nov 17, 2026
fa8c315
feat: entrance plays to its end, controls come in last
Bium23 Nov 17, 2026
f280bb2
feat: app icon with navy and plum ink strokes
Bium23 Nov 17, 2026
93a4f1f
chore: prepare Arcane 0.2.0 release candidate
Bium23 Nov 18, 2026
c86b9b0
docs: record Arcane 0.2.0 offline update validation
Bium23 Nov 18, 2026
29c9d05
chore: pin nxnative 461a5f9f for Arcane 0.2.0
Bium23 Nov 18, 2026
5c68e8d
docs: verify 0.2.0 updater with the final engine pin
Bium23 Nov 18, 2026
05e991d
fix: keep the launch cover during Steam cold startup
Bium23 Nov 18, 2026
b9e2d77
fix: stop hiding Steam while a game is starting
Bium23 Nov 18, 2026
20c062e
fix: remove app branding from the game launch screen
Bium23 Nov 18, 2026
7ebf085
docs: present Arcane as a Mac game library and launcher
Bium23 Nov 18, 2026
6d1b308
feat: add optional support for Arcane
Bium23 Nov 18, 2026
bfda25e
feat: highlight the Arcane support button
Bium23 Nov 18, 2026
921f870
docs: finalise the Arcane 0.2.0 changelog
Bium23 Nov 18, 2026
4ee6c5c
test: wait for the Steam cover fallback task
Bium23 Nov 18, 2026
fcd4ed9
test: measure the interval between Steam rescans
Bium23 Nov 18, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
buy_me_a_coffee: bium
5 changes: 5 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,11 @@ jobs:
run: python3 -m unittest discover -s Tests/PublicationChecks
- name: Swift tests
run: swift test
- name: Application regressions without UI
run: |
for check in Tests/CatalogAppChecks/run_*.py; do
python3 "$check" || exit 1
done
- name: Release compilation
run: swift build -c release --product NXLibrary
- name: Package and verify development app
Expand Down
30 changes: 23 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,22 @@
# NX Library — agent guidance
# Arcane — agent guidance

A personal macOS SwiftUI front-end for upstream [nxnative](https://github.com/seedds/nxnative). Read `README.md` and `docs/architecture.md` before changing behavior.
A personal macOS SwiftUI front-end for upstream [nxnative](https://github.com/seedds/nxnative). Before changing behavior, read in this order: this file, `docs/architecture.md` (how each area works), `docs/conventions.md` (where new code goes and how it is built), `docs/flows.md` (end-to-end paths), the area's own document if it has one (for example `docs/steam.md`), then the files through `docs/file-map.md`.

## Documentation

The documentation is how the next session understands the structure. Keep it exact.

- **Build on the existing structure.** Every new piece follows a recipe in `docs/conventions.md` and its named example. If no recipe fits, propose one to the maintainer; once approved, add it to `conventions.md` before or with the code. Never invent a second way to do something the codebase already does.
- **Same commit, same truth.** A change updates, in the same commit:
- its row in `docs/file-map.md`, placed in its area section, and the total;
- its area in `docs/architecture.md` (or the area's own document);
- `docs/flows.md`, if a flow changed;
- `docs/validation.md`, if something new awaits validation or the maintainer confirmed something.
- **Present tense only.** `architecture.md`, `conventions.md`, `flows.md` and area documents describe what the code does now. Put history in `CHANGELOG.md`, dated notes (`docs/upstream-upgrades/`, `docs/reviews/`) or git. Keep the *why* of a choice next to it in one sentence. Move measurements and probe evidence to a dated note in `docs/reviews/` and link it.
- **One validation list.** Validation status lives only in `docs/validation.md`. A row becomes validated only on the maintainer's confirmation.
- **No appended sections.** New features go into the section of their area, never into a dated section at the end of a guide or of the file map. If an area grows a document of its own, add it to the reading order above.
- **Designs and plans stay private.** Design notes, plans, research, product ideas and future intentions live in `docs/private/` (git-ignored) and are never moved into the repository. Public documents state current behavior and the one-sentence *why*; they never name private files or reveal planned features, sources, product or business ideas.
- **Readable docs.** Use short paragraphs, lists and tables; avoid single lines of thousands of characters. Name real types and files. Verify every claim against the code before writing it.

## Non-negotiables

Expand Down Expand Up @@ -39,15 +55,15 @@ Every re-pin is a product decision, not just a hash change. Before changing the
2. Read the engine's current `scripts/build_ipa_from_nsp.py -h`, `docs/env_switches.tsv`, `dm/games/*/README.md`, and the changed docs.
3. Classify each change: shader/pipeline, host/runtime, input/display/audio, game profiles, build/extraction, CLI/env, docs/tests.
4. For each user-visible capability decide **UI**, **backend only**, or **not adopted**, and say why.
5. Wire any new engine flag that maps to an existing NX Library control. Example: nxnative 4f24ce6 added `--allow-other-metal`; it must be passed when the app's untested-toolchain override is on.
5. Wire any new engine flag that maps to an existing Arcane control. Example: nxnative 4f24ce6 added `--allow-other-metal`; it must be passed when the app's untested-toolchain override is on.
6. If the engine's README `pip install` line names a new package, add its wheel (and its dependencies) to `runtime.lock`, rebuild with `scripts/bundle_runtime.sh`, and update `NOTICE`; a GPL package also ships its source in `Runtime/sources/`. `EngineRuntimeRequirementsTests` fails until it is there.
7. If the engine's `dm/gfx/tools/dmsh_chain.lock` certifies a new Metal compiler, add it to `ToolchainRequirements.current.metalAssets` with Apple's asset build from `xcodebuild -showComponent MetalToolchain -json` (`buildVersion`), so the Setup check can download exactly that compiler. Raise `minimumXcode` when the new compiler needs it.
8. Re-pin only after tests, the compatibility gate, a certified build, and a smoke launch. Update `README.md` and the design spec.
9. Write a dated note in `docs/upstream-upgrades/` using the checklist there.

Never follow `main` automatically. A commit that is newer is not automatically a commit that is tested with this Mac's toolchain.

The only exception is the player's own choice in **Settings → Engine → Newest engine**: it moves the checkout to upstream `main` on request, turns the untested override on and records builds as untested, and is refused when `main` certifies a different Metal compiler. Setup keeps installing the pinned commit and never treats that choice as an error. Do not add any automatic path to `main`.
The only exception is the player's own choice in **Settings → Setup and engine → Newest engine**: it moves the checkout to upstream `main` on request, turns the untested override on and records builds as untested, and is refused when `main` certifies a different Metal compiler. Setup keeps installing the pinned commit and never treats that choice as an error. Do not add any automatic path to `main`.

## Branches

Expand All @@ -60,11 +76,11 @@ The user performs interactive app and game checks. Never use computer-use tools
```bash
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer swift test
bash scripts/build_app.sh
codesign --verify --deep --strict "$HOME/Applications/NXLibrary Dev.app"
codesign --verify --deep --strict "$HOME/Applications/Arcane Dev.app"
```

Development builds install as **NX Library Dev** (`~/Applications/NXLibrary Dev.app`), the maintainer's only test copy. Never build over, replace or test in the released `~/Applications/NX Library.app`; it is the copy installed from GitHub and updates itself.
Development builds install as **Arcane Dev** (`~/Applications/Arcane Dev.app`), the maintainer's only test copy. Never build over, replace or test in the released copy (`~/Applications/NX Library.app`, which becomes `Arcane.app` when a release that carries the new name quits); it is the copy installed from GitHub and updates itself.

Then verify the gate in **Settings → Engine**, build one real game, and launch it to a visible screen. Do not claim a build or game is working from compilation alone.
Then verify the gate in **Settings → Setup and engine**, build one real game, and launch it to a visible screen. Do not claim a build or game is working from compilation alone.

Releases go through `scripts/release.sh` only: it refuses a dirty tree, so commit or stash local changes first. Never publish (`--publish`) without the user asking.
59 changes: 58 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,63 @@
# Changelog

User-visible changes to NX Library are recorded here. Entries are grouped by release, with the newest first. Engine changes also have their own [upgrade notes](docs/upstream-upgrades/README.md).
User-visible changes to Arcane (formerly NX Library) are recorded here. Entries are grouped by release, with the newest first. Engine changes also have their own [upgrade notes](docs/upstream-upgrades/README.md).

## 0.2.0 — 2026-11-18

See the [validation checklist](docs/validation.md) for the state of manual checks.

### Added

- Add installed Steam games for Mac to the shared Spotlight and Collection catalog alongside nxnative games. Arcane watches Steam install manifests to reflect downloads and installed games, and shows playtime and achievements when available.
- Steam game pages show **More like this** below About and Details, with related Steam games first and a fallback to matching Switch titles in your library.
- Steam achievements have a controller-friendly view with filters, sorting, public rarity, crystal tiers and an animated Arcane for unlocking every achievement.
- Shared game details show critic scores from Wikidata and optional IGDB. The metadata picker offers field-by-field suggestions from IGDB, LaunchBox and TheGamesDB.
- **Settings → About → Support Arcane** opens the project's optional Buy Me a Coffee page in your browser.

### Changed

- **Updated nxnative to `461a5f9f`.** The upstream update includes shader and texture fixes, audio output-route fixes, more game profiles and improvements in package discovery and pipeline preparation. The required Metal compiler is still `32023.922`. The new engine applies to games built with this pin.

- **New app icon.** Arcane's icon is now a crystal inside a glass sphere, framed by navy and plum ink strokes on light paper. The Light, Dark and Mono choices in **App icon** follow it.
- The shell keeps the same background renderer when opening Settings and returning home, preserving its frame and motion clock.
- Changing the theme updates the shared background and its shades even when the wallpaper and selected card stay the same.

- **Arcane** keeps the original blue moonlight as the default. Optional **Arcane Crystal** and **Arcane Flow** draw fine light threads bending in slow travelling waves, with faint ambient light and no broad beams or glass planes. Pink and cyan stay local, with very small colour changes over three minutes. Both are rendered live, with soft particles and the shared motion controls; no pictures or video. The existing theme identity and preferences stay compatible.

- The app opens on the moving backdrop and brings the first Spotlight library in with growing tiles and a gradual game background. The welcome and Setup share that backdrop during the entrance; fullscreen waits for the window to be drawn. **Entrance animation** replaces the old Intro animation label while keeping its saved value and boot sound. The separate intro and preparation message are removed. The entrance always plays to its end: keys, clicks, the wheel and the controller wait for it, and the top bar and button hints come in last.
- Native alerts and file pickers take priority over controller actions as well as the keyboard and menu commands, so actions do not reach the library or an Arcane dialog underneath.
- The remembered **Game files** folder is kept for the picker without scanning it at launch. Choosing a folder or files in Add game starts the source scan; library refresh continues to discover installed apps.
- The app is now called **Arcane** in every visible place: window, menus, Settings, About and texts in all six languages. Your library, settings and data stay where they are. The development copy is Arcane Dev.
- Settings are grouped into **General**, **Library**, **Porting** and **System**. Launch screen, Surprise me, session card and hidden games are in Library → Games; keys, cloud saves and build caches have their own Porting pages; Rumble sits with the other new-game defaults; Console is in System. Every setting keeps its value.
- Players coming from NX Library see **Welcome to Arcane** once: the new name, what's new, and an offer to add Steam games for Mac when Steam is found and still off.
- A first launch starts from what is already on the Mac: installed Steam games for Mac and games you already ported, each with a count. Choose whether Steam joins the library, then open it; **Porting** leads to the setup for converting Switch games. Nothing changes on disk until you open the library.
- After an update, the app file becomes **Arcane.app** the next time you quit, in the same folder; the Dock keeps opening it. It stays as it is when the folder is read-only or an Arcane.app is already there.

### Fixed

- Steam receives Play once Arcane submits the launch cover, so a fast Space change can stay behind the waiting screen.
- The waiting screen stays up when a cold Steam launch pauses during its startup interstitials.
- Steam can finish opening windows behind the waiting screen without Arcane repeatedly hiding them and switching macOS Spaces.
- The waiting screen leaves the bottom-right corner free of app branding.
- Spotlight loads installed mods and the lower game page when the page opens. Moving on the game row skips the Details calculations. Spotlight and Collection save the last selected game in the background.
- Open library remains available during the initial scan, so an unresponsive folder cannot hold up first launch. Leaving cancels the request; sources can be added later in Settings.

- Updating the app preserves existing copies beside it, including files named `(new)` or `(old)`. Each update uses its own staging directory; a failed Trash operation keeps the previous app.
- If an older copy changes the legacy library after migration, **Keep Arcane’s library** preserves the current games and sources and archives both versions before continuing. The libraries are not merged.

- Spotlight reuses decoded game artwork on its first frame after returning from Settings, preserving personal picks and Steam icons. The Mods card keeps its prepared cover across navigation instead of briefly returning to its empty background.
- Porting shows **Preparing the first launch** during the engine's prewarm phase instead of estimating it from an older build's finishing time. A prewarm warning explains that missing pipelines are prepared when the game first starts.
- NUP discovery keeps a selected program separate from its application and DLC identities. Rebuilds explicitly select that program when the engine supports it; older NUP records keep program zero.
- Local save backups include additional users and their registry. Restoring an older backup preserves other local users; interrupted replacements and interrupted recovery retain verified backups and unexpected external changes. Cloud sync remains limited to the primary user and device save.

- First launch keeps the Steam switch choice after quitting during Porting and uses the saved Steam folder for discovery and activation. An incomplete Steam read offers **Retry** instead of saying no games were found.
- Notification permission is requested when a porting starts, rather than when opening the library.
- Scrolling a game page can keep focus on its achievements card; Game Details is disabled while another panel owns input.
- Achievement requests made before Steam is configured are retried when its source becomes available.
- The achievements list keeps following the selected row after quickly closing and reopening the screen. Validated in Dev by the maintainer on 16 November.
- Automatic logo searches use the game's Switch or Switch 2 platform.
- Steam libraries that return after a scan join file watching on the next scan, even when their paths have not changed. Event paths under `/var` and `/tmp` are recognized consistently.
- Steam achievement and playtime readers reject unsafe or changing files through the shared bounded reader.

## 0.1.4.3 — 2026-11-12

Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Contributing

NX Library is an early macOS front-end for a pinned upstream nxnative.
Start with [README](README.md), [architecture](docs/architecture.md) and
[AGENTS.md](AGENTS.md).
Start with [README](README.md), [AGENTS.md](AGENTS.md),
[architecture](docs/architecture.md) and [conventions](docs/conventions.md).

Keep changes small and preserve Play for existing apps. Never patch the user's
nxnative checkout, silently follow upstream main, or bypass the compatibility
Expand Down
12 changes: 11 additions & 1 deletion NOTICE
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ The MIT permission notice is reproduced for each project below.
--------------------------------------------------------------------------------
nxnative
https://github.com/seedds/nxnative
Pinned engine commit: 2716f78f01e90a9f9bbf0d09e7a798903525962f
Pinned engine commit: 461a5f9f95fc9fc40a690bb2a82eb23f1f03bdca

MIT License

Expand Down Expand Up @@ -95,6 +95,16 @@ No Nintendo games, keys, logos, fonts, sounds, or other Nintendo assets are
included in this repository. NX Library is not affiliated with, endorsed by,
or sponsored by Nintendo.

The Steam logo (Resources/Brands/SteamLogo.png, the inverse logo from Valve's
Steam brand guidelines, unaltered) marks Steam games in the library.
©2026 Valve Corporation. Steam and the Steam logo are trademarks and/or
registered trademarks of Valve Corporation in the U.S. and/or other countries.
NX Library is not affiliated with, endorsed by, or sponsored by Valve.

The Buy Me a Coffee cup (Resources/Brands/BuyMeACoffee.png) is from the
official brand kit (https://buymeacoffee.com/brand) and identifies the external
support page. The artwork belongs to Buy Me a Coffee.

--------------------------------------------------------------------------------
Bundled media (Material Icons, Selene sounds and palettes): see
Resources/Selene/NOTICE.txt and
Expand Down
Loading