Other consolesLoginRegisterDevelopers

3DS Store › Emulators › 3DS-CLI

3DS-CLI changelog

v5.3 · Oct 3, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| PSP | psp/EBOOT.PBP | ms0:/PSP/GAME/3ds-cli/ |
| PS Vita | vita/3ds-cli.vpk | install with VitaShell |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |
| PS3 | ps3/3ds-cli.pkg | install it from the XMB |

That's it. The other zips below are for the Homebrew App Store
to install from, not for copying by hand.

v5.2.2 · Sep 26, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| PSP | psp/EBOOT.PBP | ms0:/PSP/GAME/3ds-cli/ |
| PS Vita | vita/3ds-cli.vpk | install with VitaShell |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |
| PS3 | ps3/3ds-cli.pkg | install it from the XMB |

That's it. The other zips below are for the Homebrew App Store
to install from, not for copying by hand.

v5.2 · Sep 14, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| PSP | psp/EBOOT.PBP | ms0:/PSP/GAME/3ds-cli/ |
| PS Vita | vita/3ds-cli.vpk | install with VitaShell |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |
| PS3 | ps3/3ds-cli.pkg | install it from the XMB |

That's it. The other zips below are for the Homebrew App Store
to install from, not for copying by hand.

v5.1 · Sep 10, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| PSP | psp/EBOOT.PBP | ms0:/PSP/GAME/3ds-cli/ |
| PS Vita | vita/3ds-cli.vpk | install with VitaShell |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |
| PS3 | ps3/3ds-cli.pkg | install it from the XMB |

That's it. The other zips below are for the Open Shop Channel and
the Homebrew App Store to install from, not for copying by hand.

v5.0.1 · Aug 28, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| PSP | psp/EBOOT.PBP | ms0:/PSP/GAME/3ds-cli/ |
| PS Vita | vita/3ds-cli.vpk | install with VitaShell |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |
| PS3 | ps3/3ds-cli.pkg | install it from the XMB |

The PS3 is the exception to step 2: it has no removable card, so
its Image goes to /dev_hdd0/3ds-cli/ on the internal drive,
which is easiest to fill over FTP. It also needs a display that can
do 720p, the only mode the terminal is laid out for. There is a
ps3/3ds-cli.self in the zip too, for loaders that want one
instead of the .pkg.

That's it. The other zips below are for the Open Shop Channel and
the Homebrew App Store to install from, not for copying by hand.

v5.0 · Aug 27, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| PSP | psp/EBOOT.PBP | ms0:/PSP/GAME/3ds-cli/ |
| PS Vita | vita/3ds-cli.vpk | install with VitaShell |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |

That's it. The other zips below are for the Open Shop Channel and
the Homebrew App Store to install from, not for copying by hand.

v4.2 · Aug 26, 2026

Install

  1. Download 3ds_cli.zip below and extract it.
  2. Copy Image to the root of your SD card.
  3. Copy your console's file from the zip:

| Console | Copy this | To here |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| GameCube | gamecube/3ds-cli.dol | anywhere Swiss can reach |

That's it. The other zips below are for the Open Shop Channel and
the Homebrew App Store to install from, not for copying by hand.

v4.1 · Aug 22, 2026

Setup

One Image serves every console - the guest is identical, only the
host binary differs. Copy Image to the root of your SD card, then
the binary for your console:

| Console | Binary | Goes to |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| GameCube | gamecube/3ds-cli.dol | SD Gecko / SD2SP2 |

On the 3DS, Wii U and Switch you can skip the Image step: launch
the app with none on the card and it offers to download this
release's over WiFi.

The Image has the root filesystem bundled in: on first boot the app
unpacks it to rootfs.ext2 on the card, which stays as the writable
disk from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v4.0 · Aug 21, 2026

Setup

One Image serves every console - the guest is identical, only the
host binary differs. Copy Image to the root of your SD card, then
the binary for your console:

| Console | Binary | Goes to |
|---|---|---|
| 3DS | 3ds/3ds-cli.3dsx | sdmc:/3ds/3ds-cli/ |
| Wii U | wiiu/3ds-cli.wuhb | sd:/wiiu/apps/ |
| Switch | switch/3ds-cli.nro | sdmc:/switch/ |
| Wii | wii/3ds-cli.dol | sd:/apps/3ds-cli/boot.dol |
| GameCube | gamecube/3ds-cli.dol | SD Gecko / SD2SP2 |

The Image has the root filesystem bundled in: on first boot the app
unpacks it to rootfs.ext2 on the card, which stays as the writable
disk from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v3.0 · Aug 12, 2026

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v2.3 · Aug 12, 2026

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v2.2-hotfix · Aug 4, 2026

Fixes o3ds cia not booting

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v2.2 · Aug 3, 2026

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v2.1 · Aug 1, 2026

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v2.0.1 · Jul 31, 2026

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

v2.0 · Jul 29, 2026

SD Card Setup

Extract the zip and copy to your SD card:

  • Image → sdmc:/Image
  • 3ds-cli.3dsx → sdmc:/3ds/3ds-cli/3ds-cli.3dsx

The Image has the root filesystem bundled in: on first boot the app
unpacks it to sdmc:/rootfs.ext2, which stays as the writable disk
from then on - changes persist across sessions.
Includes: bash, htop, neofetch, nano, vim, tree, wget, dropbear,
procps, util-linux.

Full Changelog: https://github.com/cmdada/3DS-CLI/compare/1.8...build-9e47f7815bef60290930d0b892fe6143f58c4593

v1.8 · Jun 23, 2026

Full Changelog: https://github.com/cmdada/3DS-CLI/compare/1.7...1.8

v1.7 · Jun 7, 2026

Full Changelog: https://github.com/cmdada/3DS-CLI/compare/1.6...1.7

v1.6 · Jun 5, 2026

Full Changelog: https://github.com/cmdada/3DS-CLI/compare/1.5...1.6

v1.5 · Jun 5, 2026

Full Changelog: https://github.com/cmdada/3DS-CLI/compare/1.4...1.5

v1.4 · Jun 3, 2026

MASSIVELY improved performance

  • source/main.c:276: added emulator tuning constants and a 2 KB UART output buffer.
  • source/main.c:299: UART output now batches with fwrite instead of calling printf for every byte.
  • source/main.c:473: emulator execution is now time-budgeted per frame. It no longer runs only 10000 instructions then waits for VBlank, which was the big bottleneck.
  • Makefile:52: bumped C optimization from -O2 to -O3 and added -fomit-frame-pointer.
  • running at higher speed!

v1.3 · May 28, 2026

Better keyboard feedback and Universal-DB install package.

v1.1 · May 10, 2026

Full Changelog: https://github.com/cmdada/3ds-cli/commits/