Ownfoil

Ownfoil is a Nintendo Switch library manager, that will also turn your library into a fully customizable and self-hosted Shop, supporting multiple clients. The goal of this project is to manage your library, identify any missing content (DLCs or updates) and provide a user friendly way to browse and install your content. Some of the features include:

• multi user authentication
• web interface for configuration and browsing the library
• content identification using content decryption or filename
• automatic library organization
• console keys management
• multiple clients support
• shop customization

Installation

• Using Docker
• Using Python
• Using uv (Windows users do this)
• Using Unraid
• Using Helm chart

[!CAUTION] There is no website associated with this project, only this GitHub repo.
Ownfoil is not released as an application or an executable file - DO NOT download or execute anything related to Ownfoil outside of this repository and its instructions.

Using Docker

Ownfoil is shipped as a docker container for easy deployment, data persistency and updates. If you are unfamiliar with Docker, check the installation documentation here.

Docker run

docker run -d -p 8465:8465 \
   -v /your/game/directory:/games \
   -v ./config:/app/config \
   -v ./data:/app/data \
   --name ownfoil \
   a1ex4/ownfoil

  docker logs -f ownfoil

Docker compose

---
services:
  ownfoil:
    container_name: ownfoil
    image: a1ex4/ownfoil
   # environment:
   #   # For write permission in config directory
   #   - PUID=1000
   #   - PGID=1000
   #   # to create/update an admin user at startup
   #   - USER_ADMIN_NAME=admin
   #   - USER_ADMIN_PASSWORD=asdvnf!546
   #   # to create/update a regular user at startup
   #   - USER_GUEST_NAME=guest
   #   - USER_GUEST_PASSWORD=oerze!@8981
    volumes:
      - /your/game/directory:/games
      - ./data:/app/data
      - ./config:/app/config
    ports:
      - "8465:8465"

docker-compose up -d

Using Python

This requires Python to be installed on your system. If that's not the case you can use uv to install a Python environment.

$ pip install -r requirements.txt
$ python app/app.py

Using uv

Ownfoil can also be run with uv directly from this repository, without cloning it or managing a Python environment yourself.

uvx --from git+https://github.com/a1ex4/ownfoil ownfoil

uv tool install git+https://github.com/a1ex4/ownfoil
ownfoil

ownfoil /path/to/persist
uvx --from git+https://github.com/a1ex4/ownfoil ownfoil /path/to/persist

Usage

Once Ownfoil is running, the Shop Web UI is now accessible with your computer/server IP and port, by navigating to http://<computer/server IP>:8465, i.e. http://localhost:8465 from the same computer or http://192.168.1.100:8465 from a device in your network.

Clients supported

Ownfoil supports multiple clients to install content on your Nintendo Switch:

Tinfoil:

• ✅ HTTP / HTTPS protocol support
• ✅ User authentication
• ✅ Shop browsing with icons and banners
• ✅ Content filtering (games, updates, DLC, XCI) based on URL
• ✅ New games, DLC, Updates, Recommended and XCI sections
• ✅ Compressed content (NSZ and XCZ) support
• ✅ Encrypted shop support
• ✅ Client side Host verification for secure connections
• ✅ Tinfoil shop customization

Sphaira:

• ✅ HTTP / HTTPS protocol support
• ✅ User authentication
• ✅ Directory-based file browsing
• ✅ Content filtering (games, updates, DLC, XCI) based on URL
• ✅ Compressed content (NSZ and XCZ) support

CyberFoil:

• ✅ HTTP / HTTPS protocol support
• ✅ User authentication
• ✅ Shop browsing with icons and Sections (Updates, DLC)
• ✅ Compressed content (NSZ and XCZ) support
• ✅ Client side Host verification for secure connections
• ✅ Custom welcome message (MOTD)

[!TIP] Check the Setup page in the Web UI for specific instructions on configuring each app, using local or remote access.

User administration

Ownfoil requires an admin user to be created to enable Authentication for your Shop. Go to the Settings to create a first user that will have admin rights. Then you can add more users to your shop the same way.

Library administration

In the Settings page under the Library section, you can add directories containing your content. You can then manually trigger the library scan: Ownfoil will scan the content of the directories and try to identify every supported file (currently nsp, nsz, xci, xcz).

[!TIP] There is watchdog in place for all your configured libraries: files moved, renamed, added or removed will be reflected directly in your library.

The automatic library organization can be configured in the Organizer section to set your own templates, enable removing older updates...

Titles configuration

In the Settings page under the Titles section is where you specify the language of your Shop (currently the same for all users).

This is where you can also upload your console keys file to enable content identification using decryption, instead of only using filenames. If you do not provide keys, Ownfoil expects the files to be named [APP_ID][vVERSION].

Ownfoil will warn you if any master key is invalid or missing, to ensure all backups can be decrypted and identified.

Shop customization

In the Settings page under the Shop section is where you customize your Shop, like the message displayed when successfully accessing the shop from Tinfoil or if the shop is private or public.