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. Some of the features include:
- multi user authentication
- web interface for configuration
- web interface for browsing the library
- content identification using decryption or filename
- Tinfoil shop customization
The project is still in development, expect things to break or change without notice.
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 /your/config/directory:/app/config --name ownfoil a1ex4/ownfoil
The shop is now accessible with your computer/server IP and port, i.e. https://localhost:8465 from the same computer or https://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
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 or download the Github repository (here), then open a command line inside the ownfoil folder and run:
$ pip install -r requirements
$ python app/app.py
To update the app you will need to pull the latest commits if using git or download the repository as a zip again.
In Tinfoil, add a shop with the following settings:
- Protocol:
http(orhttpsif 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 https://<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.
Planned feature, in no particular order.
- Library browser:
- Add "details" view for every content, to display versions etc
- Library management:
- Rename and organize library after content identification
- Delete older updates
- 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: