Note: This is an enhanced fork of the original Ownfoil with additional features for better library management.

Ownfoil is a Nintendo Switch library manager, that will also turn your library into a fully customizable and self-hosted Tinfoil Shop. 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 your content.

• multi user authentication
• web interface for configuration
• web interface for browsing the library
• content identification using decryption or filename
• Tinfoil shop customization

• 📊 Missing Content Page: Dedicated page showing all missing base games, updates, and DLCs
• 🗂️ Library Organization: Automatically organize files into structured folders (GameName/BASE, GameName/UPDATES, GameName/DLC)
• 🔍 Advanced Duplicate Detection: Find and remove duplicate files with detailed explanations
  • Identifies older update versions
  • Detects duplicate base games and DLCs
  • Shows clear reasons for deletion
  • Batch cleanup with safety checks
• 🧹 Empty Folder Cleanup: Automatically removes empty directories after file organization
• 📤 Export Missing Content: Download a text report of all missing content
• 🎯 Enhanced File Handling: Better support for files without proper metadata

The project is still in development, expect things to break or change without notice.

• Installation
• Usage
• Roadmap
• Similar Projects

Running this command will start the shop on port 8465 with the library in /your/game/directory :

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

The shop is now accessible with your computer/server IP and port, i.e. http://localhost:8465 from the same computer or http://192.168.1.100:8465 from a device in your network.

Create a file named docker-compose.yml with the following content:

version: "3"

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
      - ./config:/app/config
    ports:
      - "8465:8465"

You can then create and start the container with the command (executed in the same directory as the docker-compose file):

docker-compose up -d

This is usefull if you don't want to remember the docker run command and have a persistent and reproductible container configuration.

Clone the repository using git, install the dependencies and you're good to go:

$ git clone --recurse-submodules https://github.com/a1ex4/ownfoil
$ cd ownfoil
$ pip install -r requirements.txt
$ python app/app.py

To update the app you will need to pull the latest commits.

In Tinfoil, add a shop with the following settings:

• Protocol: http (or https if using a SSL enabled reverse proxy)
• Host: server/computer IP, i.e. 192.168.1.100
• Port: host port of the container, i.e. 8000
• Username: username as created in Ownfoil settings (if the shop is set to Private)
• Password: password as created in Ownfoil settings (if the shop is set to Private)

Once Ownfoil is running you can access the Shop Web UI by navigating to the http://<computer/server IP>:8465.

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.

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). There is watchdog in place for all your added directories: files moved, renamed, added or removed will be reflected directly in your library.

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].

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.

In the Settings page under the Library section, you can:

• Organize Library: Click the "Organize Library" button to automatically restructure your files into folders like GameName/BASE, GameName/UPDATES, and GameName/DLC
• Clean Duplicates: Click the "Clean Duplicates" button to find and remove duplicate files. The tool will show you exactly what will be deleted and why

Navigate to the Missing Content page from the navigation bar to see:

• Games where you have DLC or updates but missing the base game
• Games with available updates that you don't have
• Games missing DLC content
• Export the missing content list as a text file for reference

Planned feature, in no particular order.

• Library browser:
  • Add "details" view for every content, to display versions etc
  • Missing content page to show what's not in your library
• Library management:
  • Rename and organize library after content identification
  • Delete older updates and duplicate files
  • Automatic nsp/xci -> nsz conversion
• Shop customization:
  • Encrypt shop
• Support emulator Roms
  • Scrape box arts
  • Automatically create NSP forwarders
• Saves manager:
  • Automatically discover Swicth device based on Tinfoil connection
  • Only backup and serve saves based on the user/Switch
• External services:
  • Integrate torrent indexer Jackett to download updates automatically

If you want to create your personal NSP Shop then check out these other similar projects:

• eXhumer/pyTinGen
• JackInTheShop/FT-SCEP
• gianemi2/tinson-node
• BigBrainAFK/tinfoil_gdrive_generator
• ibnux/php-tinfoil-server
• ramdock/nut-server
• Myster-Tee/TinfoilWebServer
• DevYukine/rustfoil
• Orygin/gofoil