Rename internal Alchemy names/settings to Slipstream (hard fork) #126

Closed
opened 2026-09-27 19:58:34 +00:00 by sky_line · 2 comments
Owner

Slipstream is now a hard fork of Alchemy. We never intend to upstream, and will only cherry-pick individual upstream changes we want. The user-facing branding is done (product name, channel, binaries, data dir, logs, icons, links). The internal names still say Alchemy; they were deliberately kept during the first rename. Migrate them too.

Scope

  • Settings keys: Alchemy* → Slipstream* in settings.xml/settings_alchemy.xml and every gSavedSettings / LLCachedControl / XUI control_name / menu parameter reference.
    • Needs a migration: on load, copy any saved Alchemy* value to its new key, so users keep their settings (see the existing first-run data-dir copy in LLAppViewer).
    • Keep reading the old names for a release or two.
  • Source files and classes: al*.cpp/h (alchatbar, altpscamera, alviewermenu, …), AL* class names, ALToolTPS, etc. → a Slipstream prefix. Rename with git mv so history follows.
  • Env vars: ALCHEMY_* → SLIPSTREAM_* (e.g. ALCHEMY_AFFINITY, ALCHEMY_NO_AFFINITY, ALCHEMY_VK_VALIDATION). Accept the old names for a while.
  • XUI names:
    • the alchemy skin folder;
    • Alchemy* texture names (AlchemyRelease128 …);
    • floater/panel names that embed "alchemy";
    • the settings_alchemy.xml file name.
  • Build: USE_* / CMake options, LL_* defines that carry Alchemy naming, the AlchemyViewer 3p repo references where we vendor our own packages later (the branding package is no longer used for icons).
  • Logs / diagnostics: tag names and comments that say Alchemy.
  • Keep: license and copyright attribution ("based on Alchemy, © Alchemy Development Group"), the About credits, and doc/contributions.txt history.

Notes

  • This is a big mechanical change. Do it in one branch with scripted renames plus the settings migration, and build both platforms.
  • It makes future cherry-picks from upstream Alchemy need path/name translation. Accepted, since we're hard-forking.
Slipstream is now a **hard fork** of Alchemy. We never intend to upstream, and will only cherry-pick individual upstream changes we want. The user-facing branding is done (product name, channel, binaries, data dir, logs, icons, links). The *internal* names still say Alchemy; they were deliberately kept during the first rename. Migrate them too. ### Scope - **Settings keys:** `Alchemy*` → `Slipstream*` in `settings.xml`/`settings_alchemy.xml` and every `gSavedSettings` / `LLCachedControl` / XUI `control_name` / menu `parameter` reference. - **Needs a migration:** on load, copy any saved `Alchemy*` value to its new key, so users keep their settings (see the existing first-run data-dir copy in `LLAppViewer`). - Keep reading the old names for a release or two. - **Source files and classes:** `al*.cpp/h` (`alchatbar`, `altpscamera`, `alviewermenu`, …), `AL*` class names, `ALToolTPS`, etc. → a Slipstream prefix. Rename with `git mv` so history follows. - **Env vars:** `ALCHEMY_*` → `SLIPSTREAM_*` (e.g. `ALCHEMY_AFFINITY`, `ALCHEMY_NO_AFFINITY`, `ALCHEMY_VK_VALIDATION`). Accept the old names for a while. - **XUI names:** - the `alchemy` skin folder; - `Alchemy*` texture names (`AlchemyRelease128` …); - floater/panel names that embed "alchemy"; - the `settings_alchemy.xml` file name. - **Build:** `USE_*` / CMake options, `LL_*` defines that carry Alchemy naming, the `AlchemyViewer` 3p repo references where we vendor our own packages later (the `branding` package is no longer used for icons). - **Logs / diagnostics:** tag names and comments that say Alchemy. - **Keep:** license and copyright attribution ("based on Alchemy, © Alchemy Development Group"), the About credits, and `doc/contributions.txt` history. ### Notes - This is a big mechanical change. Do it in one branch with scripted renames plus the settings migration, and build both platforms. - It makes future cherry-picks from upstream Alchemy need path/name translation. Accepted, since we're hard-forking.
sky_line added this to the Slipstream project 2026-10-06 15:04:15 +00:00
Author
Owner

Scope measured on main (98a8576b2f) on 2026-10-06:

  • 94 Alchemy* settings: 74 in settings.xml, 20 in settings_per_account.xml. All need the old-key → new-key migration.
  • 54 al* source files to git mv.
  • 33 XUI files mention alchemy.
  • 394 Alchemy mentions in .cpp / .h.

Related: #488 (Lightbox → Photo Studio) renames the alfloaterlightbox / panel_lightbox_* files. Coordinate so they are not renamed twice.

Scope measured on main (98a8576b2f) on 2026-10-06: - **94 `Alchemy*` settings**: 74 in `settings.xml`, 20 in `settings_per_account.xml`. All need the old-key → new-key migration. - **54 `al*` source files** to `git mv`. - **33 XUI files** mention alchemy. - **394 `Alchemy` mentions** in `.cpp` / `.h`. Related: #488 (Lightbox → Photo Studio) renames the `alfloaterlightbox` / `panel_lightbox_*` files. Coordinate so they are not renamed twice.
Author
Owner

Done (2026-10-07): settings Alchemy* -> Slipstream* with first-launch migration (adbc37d33f), al*/AL* sources and classes -> sl*/SL* (5fba9ade46), ALCHEMY_* env vars -> SLIPSTREAM_* with fallbacks (9daa73b871), remaining UI names (557ec78fdf), build/platform names (e5d69103b3). No Alchemy* setting keys or al* files remain; the leftover mentions are attribution and migration fallbacks, which stay.

Done (2026-10-07): settings Alchemy* -> Slipstream* with first-launch migration (adbc37d33f), al*/AL* sources and classes -> sl*/SL* (5fba9ade46), ALCHEMY_* env vars -> SLIPSTREAM_* with fallbacks (9daa73b871), remaining UI names (557ec78fdf), build/platform names (e5d69103b3). No Alchemy* setting keys or al* files remain; the leftover mentions are attribution and migration fallbacks, which stay.
Sign in to join this conversation.
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
sky_line/Slipstream#126
No description provided.