Ownfoil

Clients support

This release adds Ownfoil compatibility with all homebrew apps that support remote backup installation, and are actively supported and maintained. Up to now Ownfoil has always been Tinfoil centric as it is the client that supports most features and implements the best security, but now multi-client support has been added and it will easier to add specific client features in the future (like backuping saves, dumps...).

Each client has specific settings and can be enabled / disabled, and the Setup page in the UI will now display instructions on how to configure the enabled clients, as well as the features supported.

[!WARNING]
If you host a public shop with Tinfoil's encryption enabled, and you do not want people to be able do download your entire shop outside of a Switch device, you should disable all other clients. Enabling an other client will render the encryption feature useless, as they do not support encryption themselves.

Path based filtering

For clients that supports it, you can now add /base, /update, /dlc, /multi to the URL to filter what content is served by the shop.

What's Changed

New Features

• Add support for clients other than Tinfoil by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/290
• Add Sphaira support by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/291
• Add Setup page with homebrew setup instructions by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/292
• Add CyberFoil support by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/304
• feat: keep track of download count by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/305

Fixes and Improvements

• improv(clients): support dynamic hauth per host by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/293

Dependencies

• build(deps): bump werkzeug from 3.1.5 to 3.1.6 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/294
• build(deps): bump flask from 3.1.2 to 3.1.3 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/295
• build(deps): bump unzip-http from 0.6 to 0.7 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/296
• build(deps): bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/298
• build(deps): bump docker/build-push-action from 6 to 7 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/299
• build(deps): bump docker/login-action from 3 to 4 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/300
• build(deps): bump docker/metadata-action from 5 to 6 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/301
• build(deps): bump docker/setup-buildx-action from 3 to 4 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/302

Issues fixed

• Reset hauth when domain is changed #204

Full Changelog: https://github.com/a1ex4/ownfoil/compare/2.2.1...2.3.0

This version is a bug fix release, that also improves the Organizer for people accessing their library with Windows.

What's Changed

Fixes and Improvements

• improv(organizer): add option to enforce Windows filename sanitizing by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/285
• fix(organizer): Fix organizer not working in scheduled jobs by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/286
• fix(library): title with no owned app not deleted if files are removed when app is not running by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/287

Dependencies

• ci(docker): cache python environment in docker build by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/288

Issues fixed

• Forbidden characters with organizer. #251
• Organizer: add option to force Windows compatible filenames #284

Full Changelog: https://github.com/a1ex4/ownfoil/compare/2.2.0...2.2.1

This release continues to focus on library management improvements and features, robustifying the backend code and making needed changes for future implementations. There are also bug fixes in the UI, library management code and in Tinfoil displaying the titles incorrectly.

Library Organizer

You can now configure Ownfoil to automatically organize your library: all identified files will be renamed and organized according to the settings. The templates can be configured from the Settings page in the Web UI:

Some additional features of the organizer to tidy up your library:

• automatically delete older updates
• delete empty folders after library organization

Console keys management

As requested by users, the console keys revisions are now individually verified by Ownfoil and available to review in the Settings page. You can now see if you are missing newer revisions, or if one key happens to be invalid:

When the specific key required to open a file is missing, Ownfoil now tracks the key in the file's identification status.

Scheduler improvements

The scheduler has been improved to allow the configuration of periodic jobs in the UI, as well as enabling/disabling them:

This now makes it very easy to add periodic tasks in the backend, configure them using the UI.

Performance improvements

By only opening the sections containing metadatas, the file identification is now 2x to 10x times faster.
In this release the docker image has been updated to use Python 3.14, which greatly improves the speed of execution of Ownfoil.

What's Changed

New Features

• Add automated library management by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/229
• Console keys management: add invalid/missing revisions in UI by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/280
• Improve scheduler to support configurable period and enabling/disabling jobs from settings by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/281
• Add Ownfoil logo by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/283

Fixes and Improvements

• Speed up file identification by only reading metadata sections by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/232
• fix: special characters in password validation by @Kratemis in https://github.com/a1ex4/ownfoil/pull/236
• Fix filter and searching by @Sab44 in https://github.com/a1ex4/ownfoil/pull/241
• Fix tinfoil games by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/247
• Organizer: Prevent forbidden characters in filenames by @garlik82 in https://github.com/a1ex4/ownfoil/pull/256
• Fix: Add "owned" flag to DLCs and fix false-positive "Up to date" pills by @HarleyBartles in https://github.com/a1ex4/ownfoil/pull/254
• Fix encoding when reading TitleDB files by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/282

Dependencies

• build(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/227
• build(deps): bump actions/stale from 9 to 10 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/228
• Migrate from NSTools to nsz by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/231
• build(deps): bump zstandard from 0.24.0 to 0.25.0 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/238
• build(deps): bump python from 3.11-alpine to 3.13-alpine by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/130
• build(deps): bump pyyaml from 6.0.2 to 6.0.3 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/245
• build(deps): bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/267
• build(deps): bump actions/upload-artifact from 4 to 6 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/269
• build(deps): bump werkzeug from 3.1.3 to 3.1.5 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/273
• build(deps): bump python from 3.13-alpine to 3.14-alpine by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/249

Issues fixed:

• Special Characters in Password - Auth Failure #105
• Display the console keys revision in the UI and detect when new revision is needed for file indentification #205
• In tinfoil no game title is present #239
• Error preventing the rest of the folder scanning #246
• Forbidden characters with organizer. #251
• Feature suggestion: Add option to set interval/disablement for automatic library scan #270
• Error when launching - UnicodeDecodeError: 'charmap' codec can't decode byte 0x9d in position 58879 #277

New Contributors

• @Kratemis made their first contribution in https://github.com/a1ex4/ownfoil/pull/236
• @Sab44 made their first contribution in https://github.com/a1ex4/ownfoil/pull/241
• @garlik82 made their first contribution in https://github.com/a1ex4/ownfoil/pull/256

Full Changelog: https://github.com/a1ex4/ownfoil/compare/2.1.3...2.2.0

What's Changed

This releases fixes the only remaining issue from the v2.1 changes on Web library view caching. It prevents the cached library file from being corrupted, with atomic and thread safe write of the json file. Library disappearing from the Web UI should no longer happen.
The loading of TitlesDB into memory has also been optimized.

Fixes and Improvements

• fix(library): fix library not showing in the UI if cached file is corrupted by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/224

Dependencies

• build(deps): bump flask from 3.1.1 to 3.1.2 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/225

Fixed issues

• ownfoil latest ver. crashes on unraid #210

Full Changelog: https://github.com/a1ex4/ownfoil/compare/2.1.2...2.1.3

What's Changed

This release fixes several issues with library scans, database migration and file content identification. It should be much more reliable and robust when multiple files are added rapidly in your libraries.

Fixes and Improvements

• Fix library scan concurrency between scheduler and manually scanning from the UI by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/217
• Fix TitleDB was not loaded if multiple identification tasks are called within 30s by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/218
• improv(ui): allow upload of new keys file in the UI even if console keys are valid (#205) by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/219
• fix(db): fix database migration from previous schema missing the Files table (#209) by @a1ex4 in https://github.com/a1ex4/ownfoil/pull/220

Dependencies

• build(deps): bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/213
• build(deps): bump requests from 2.32.4 to 2.32.5 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/214
• build(deps): bump zstandard from 0.23.0 to 0.24.0 by @dependabot[bot] in https://github.com/a1ex4/ownfoil/pull/215

Issues fixed

• Unloads TitleDB before update #206
• Error in database hash computation #207
• Migration failure (drop table files). #209
• Unable to complete scan of games directory #221

Full Changelog: https://github.com/a1ex4/ownfoil/compare/2.1.1...2.1.2