Skip to content

Sources: add app sources under Tools, with updates and release notes - #143

Open
TinusTK wants to merge 1 commit into
FrizzleM:mainfrom
TinusTK:sources
Open

TinusTK wants to merge 1 commit into
FrizzleM:mainfrom
TinusTK:sources

Conversation

@TinusTK

@TinusTK TinusTK commented Nov 19, 2026

Copy link
Copy Markdown

Hi! This adds a Sources page to Tools, like the one in SideStore. You add a source once, and
from then on you can see which of its apps have updates, read their release notes, and install
them without fetching the IPA by hand for a custom install.

Tools Sources Add a source
Your sources An app's page Install

What it does

  • Add a source: paste its https link, an altstore:// or sidestore:// source link, or a
    link to a .json source file. The link is fetched before it's saved, so only a working source
    is kept. Under the field, SideStore, AltStore, LiveContainer + SideStore and Haven are
    suggested, one tap each.
  • Your sources: a button that opens the list on the same page. Each source shows under its
    developer, with their GitHub picture (read from where the source is hosted), or the app's icon
    when there's none. A source's link can be copied, and it can be removed.
  • Built in: your own source (frizzlem.json) is always there and can't be removed, so
    SideInstaller and Nightflix are listed from the start.
  • Apps: every app from every source, with its icon, developer and version. An app's page has
    Install (or Update to x.y), What's new (the release notes, with headings, bullets and bold
    shown), its description, and the version history with each version's notes. An earlier
    version can be installed too, after a warning.
  • Updates: with LocalDevVPN on, the installed apps are read the same way Sideloaded apps does
    it (SideloadedAppsManager), and ProfileMatcher.installed matches the <bundle id>.<team id>
    that SideInstaller signs with. An app with a newer version gets an Update tag, and the Sources
    tile shows how many there are.

Installing goes through what's already there

Install doesn't add a new install path. It builds a sideinstaller://install?url=… link and
hands it to Engine.receiveLink, so it's the same "Install from a link?" question and the same
download, sign and install as a link or a custom .ipa.

When it checks

The sources are checked once when SideInstaller opens, the same way UpdateChecker checks
SideInstaller itself, which this PR leaves as it is. To check again, pull down on Sources or tap
Check for updates.

Files

  • ios-app/SourcesView.swift (new): the source format, SourcesManager and the pages.
  • ios-app/RootView.swift: the tile with its update count, and the check at launch.
  • ios-app/UpdateChecker.swift: one word, isNewer is now nonisolated so the Sources list
    can use the same version comparison.
  • ios-app/Assets.xcassets/SourcesLogo.imageset: the tile's logo, made to match the others.
  • The 9 *Strings.swift tables: every new string translated.
  • CHANGELOG.md: under Unreleased.

Checked

  • scripts/check-ios.sh: the simulator build and all 25 SideInstallerTests pass.
  • scripts/check_translations.py --base main: nothing newly untranslated.
  • In the simulator: adding sources (by typing, by pasting and from the suggestions), the app
    list, the release notes and the Install question.
  • Not checked: the Update tags and the count on the tile. They need LocalDevVPN, which the
    simulator doesn't have.

Things you may want changed

  • The suggested sources, Haven in particular. Haven is my app: a media player for your own
    Jellyfin, Emby and Plex servers and for IPTV, with a film and TV show tracker and Stremio
    add-ons. It isn't one
    SideInstaller installs, so I'm happy to remove it if you don't want it there.
  • The translations are mine, so native speakers may want to polish them.
  • The tile logo: I drew it to match the others, but swap in your own if you'd like.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant