Homebrew NX Simple Downloader - A simple file downloader

  • Thread starter Thread starter Mayo0x0
  • Start date Start date
  • Views Views 432
  • Replies Replies 4
  • Likes Likes 3

Mayo0x0

New Member
Newbie
Joined
Dec 31, 2025
Messages
4
Reaction score
7
Trophies
1
XP
62
Country
Germany
NX Simple Downloader

screenshot.jpg


A Nintendo Switch homebrew application that reads a download URL from a `.ini` configuration file, fetches the file over HTTP or HTTPS, and saves it to a predefined directory on the SD card — overwriting any existing file.

Features

- HTTP & HTTPS support via libnx BSD sockets and the native Switch SSL service
- Automatic redirects — follows up to 5 HTTP 3xx redirects
- Progress bar with KB counter and percentage (when Content-Length is known)
- Chunked transfer (Transfer-Encoding: chunked) support
- Self-signed certificate support via `ssl_verify = false`
- SD card enforcement — the app refuses to write anywhere other than `sdmc:/`, protecting the Switch NAND from accidental or malicious writes
- Path traversal protection — `..` sequences in `destination` and `filename` are rejected

Installation

1. Copy `NXSimpleDownloader.nro` to your SD card:​
  • sdmc:/switch/NXSimpleDownloader/NXSimpleDownloader.nro
2. Create the configuration file at:​
  • sdmc:/switch/NXSimpleDownloader/config.ini
See [config.ini.example] for the full reference.​
> If `config.ini` is missing, the app creates a template automatically on first launch.​

Configuration

[downloader]
; Full URL of the file to download
url = https://example.com/myupdate.nro
; Target directory on the SD card (must start with sdmc:/ and end with /)
destination = sdmc:/switch/MyApp/
; Filename to save as (overwrites any existing file)
filename = myupdate.nro
; SSL certificate verification for HTTPS (default: true)
; true = verify against system CA store (recommended)
; false = skip verification, accepts self-signed certificates
; ssl_verify = false


License

[PolyForm Noncommercial License 1.0.0](LICENSE) — © 2026 Mayo0x0

Source + downloads
https://github.com/Mayo0x0/NXSimpleDownloader


Screenshot (first launch without config file):
1780128372780.png
 
Last edited by Mayo0x0,
Cool stuff. Let me understand one thing - do I need to set up ini in my PC?
Yes, unless you're using a Homebrew text editor.

Hmm, it would be nice to see the GUI (like Borealis) for URLs instead of config.ini files only...
Currently, there are no plans for a GUI, and the tool wasn't designed to download files on the fly.

My intention was to provide a fixed URL where you can easily download the latest version of this file at any time.

Example: I'm adding new features to the Super Smash Bros. N64 ROM on my PC (https://github.com/JSsixtyfour/smashremix). I've built the new ROM and now want to transfer it to the Switch as easily as possible so I can test it there in the N64 emulator.
To do this, I run an HTTP server on my computer where the current ROM file is located, and on the Switch I just need to use the Simple Downloader

Although a GUI would be nice and would make the whole thing more dynamic...
 
  • Like
Reactions: mathew77

Site & Scene News

Popular threads in this forum