v0.2.1

Borea v0.2.1

A fix release for v0.2.0. Update with "Update now" on the Home banner, or with borea update-self.

Website | Discord | Content index | Source and issues

Fixes

• Mod authors: opening the listing pull request from the App now works when your copy of content-index is older than a change to the index's own workflows. Before, it stopped with "GitHub refused access to the branch." Borea now starts the branch at a commit your copy already has, so the pull request shows only your listing file. When your listing changed in the index after you made your copy, Borea asks you to press "Sync fork" on GitHub, with a button that opens your copy. Thanks to @elevatorctln for the report.
• Saves and vehicles: Borea no longer claims that a file is open when it cannot know that. A copy, backup, restore or delete now reports the real error if one happens.

For mod authors

• Make your mod work in a Borea instance: a mod that reads Documents/My Games/Kitten Space Agency by a fixed path finds nothing in an instance. The page says what to use instead.

Downloads

File	SHA-256
Borea-0.2.1-linux-x64.tar.gz	c19fa2a9a6adceb75a10c65be81bd0447d53c3aeed6982fc6312334100f991b8
Borea-0.2.1-macos-arm64.tar.gz	3b865a5552f545086ddc804854fe0a06c1a84695447cf36fda046a7b931a7e9a
Borea-0.2.1-win-x64.zip	4e0a7d0c10bab9d655052e8b66e302f594b570e389f6e558c72d9d7ff36665ef
Borea-0.2.1.cdx.json	3bebfc1e5a8587aa1dbee11b1479ab9603993acb5110fbe984583f318fdc6c66
Borea-Cli-0.2.1-linux-x64.tar.gz	8ca7c6da7966118982a358fad4fb893fee9a5a4a425effc71e749e5b070bdeec
Borea-Cli-0.2.1-macos-arm64.tar.gz	0f68ba92b7a4ff70cfb77d7b2291184bc4b71e8a19d48a2ad6af414d01e22701
Borea-Cli-0.2.1-win-x64.zip	d8c661f91c181964355319a747caa37b05e77e32c1b570ea87f47dc6f9e75036
Borea-Cli-0.2.1.cdx.json	d6d5c9bd95575ecb61b26dc907c1ea31f6d7504d4dfc15461c493a79aadaffce

Each platform has two archives.
The App archive, for example Borea-<version>-win-x64.zip, contains the program borea.
Without arguments, borea opens the desktop App, and with arguments, it runs a command.
Most users want this archive.
Archives whose names start with Borea-Cli- are a smaller download that contains only the command line.

The builds include the .NET runtime and are self-contained, so there is nothing to install first.

Each archive contains borea (borea.exe on Windows), LICENSE and THIRD-PARTY-NOTICES.txt, in a folder named Borea, or Borea-Cli for the CLI archive.
Put that folder where it can stay, for example %LocalAppData%\Programs\Borea on Windows or ~/.local/share/Borea on Linux, because Borea updates itself into the folder it runs from.

First start

These builds are not code signed, so the first start might take an extra step on Windows and macOS. The README has the long explanation.

Windows. Right-click the zip, open Properties and select Unblock.
Then unpack the App archive and start borea.exe, or run .\borea.exe --help in PowerShell in the unpacked folder of either archive.
Without that step, Windows shows "Windows protected your PC". This is because the file might not be downloaded often and is not signed. Select "More info", then "Run anyway".

Linux. Unpack the App archive and run ./borea for the App, or run ./borea --help in the unpacked folder of either archive.
Both need the ICU and OpenSSL libraries of your distribution, and only the App also needs the X11, ICE, SM and fontconfig libraries. Most desktop installs already have them. See Readme.

macOS. Unpack and start Borea from Terminal, not from Finder: tar -xzf <file>, then run ./borea inside the new folder of the App archive for the App, or ./borea --help inside the new folder of either archive.
The macOS builds are for Apple silicon. Intel Macs are not supported.

Provenance

To check that a file came from this workflow:

gh attestation verify <file> --repo KSAModding/Borea \
  --signer-workflow KSAModding/Borea/.github/workflows/release.yml

Borea-0.2.1.cdx.json is the software bill of materials for the App archives, in CycloneDX JSON.
The App contains the command line, so this list includes the NuGet packages of the App and of the CLI.
Borea-Cli-0.2.1.cdx.json is the software bill of materials for the CLI archives and includes only the packages of the CLI.
Each list includes the version, license and hash of every package.
Each list is attested only to the archives that it describes, and you can use this command to prove that it belongs to one.
With --format json, the output includes the attested list.

gh attestation verify <archive> --repo KSAModding/Borea \
  --signer-workflow KSAModding/Borea/.github/workflows/release.yml \
  --predicate-type https://cyclonedx.org/bom

Signing will come in the future and is tracked in #76.

What's Changed

• Release v0.2.1 by @Maximilian-Nesslauer in #541

Full Changelog: v0.2.0...v0.2.1