A 3DS homebrew application that lets you use your (New or Old) Nintendo 3DS or 2DS as a wireless controller, keyboard, and mouse for Windows and Linux.
- Use your 3DS as a wireless gamepad for PC games and emulators
- Use your 3DS as a keyboard or mouse. C-stick can be mapped to scroll or move cursor
- Cross-platform support for Windows and Linux
- Support for all buttons, Circle Pad, and C-Stick
- Configurable server IP and port
- Low latency wireless connection
- Battery level indicator
- LCD toggle option to save battery
- Nintendo 3DS with custom firmware (CFW)
- Homebrew Launcher access or ability to install CIA files
- Wi-Fi connection (same network as PC)
- Windows or Linux
- Python 3.6+
- Windows: ViGEmBus driver
- Linux: uinput kernel module
- Copy
3ds_controller_vX.X.X.3dsxto your 3DS' SD card in/3ds/folder - Launch Homebrew Launcher on your 3DS
- Run the 3DS Controller application
- Copy `3ds_controller_vX.X.X.cia" onto your 3DS' SD card
- Open FBI or another tool that can install CIA files, I highly recommend 3dsDL, it's a really great tool.
- Select the option to install a CIA from the SD card
- Either install and keep the file, or install and delete; you don't need to keep the file if you don't want to.
- Launch from the home screen, or, if using 3dsDL, select Launch after it installs.
- Install ViGEmBus driver
- Install Python 3.6+
- Install required packages:
pip install vgamepad - Run the PC receiver:
python pc.py
- Load uinput module:
sudo modprobe uinput - Install dependencies:
sudo apt-get install libudev-dev pip install python-uinput - Run PC receiver with root privileges:
su - modprobe python-uinput python3 path/to/pc.py
- Start PC receiver script
- Launch 3DS Controller on your 3DS
- Set the IP address in the 3DS app to match your PC's IP by tapping Keyboard again, then tap "Change IP?" The top screen will have an input box to set the IP.
- Connect and start using your 3DS as a controller
| Hold SELECT button | Toggle LCD on/off |
| 3DS Input | PC Controller Output |
|---|---|
| A/B/X/Y Buttons | A/B/X/Y Buttons |
| Circle Pad | Left Analog Stick |
| C-Stick | Right Analog Stick |
| D-Pad | D-Pad |
| L/R Buttons | LB/RB (Left/Right Bumpers) |
| ZL/ZR Buttons | LT/RT (Left/Right Triggers) |
| Start/Select | Start/Back |
| 3DS Input | PC Mouse Output |
|---|---|
| Touchscreen | Move mouse |
| Circle Pad | Toggle between move mouse or scroll up & down |
| C-Stick | Toggle between move mouse or scroll up & down |
| D-Pad | Arrow Keys |
| L button/A button | Left click |
| R button/B button | Right click |
| ZL button/Y button | Back |
| ZR button/X button | Forward |
| START button | Enter |
| 3DS Input | PC Keyboard Output |
|---|---|
| Touch | Press keys |
| Tap Keyboard tab again | Drop-down: "Change IP?" |
| A button/START button | Enter |
| B button | Backspace |
| L button/R button | Shift |
| Y button | Copy |
| X button | Paste |
| D-pad | Arrow keys |
| ZL button/ZR button | Back/Forward |
| Circle Pad | Move Cursor |
| C-stick | Scroll |
- Config file at
/config.inion SD card - Edit to change server IP and port
- Default port: 8888
- Listens on all interfaces on port 8888
- Debug mode:
python pc.py --debug
You need one of following group of dependencies:
- DevkitPro and DevkitARM
- 3DS development libraries (libctru)
- Make utility
- Docker or Podman
- Python 3.6+
- Windows: ViGEmBus driver
- Linux: uinput module and headers
-
Install DevkitPro with 3DS support
# Windows: Download from https://devkitpro.org/wiki/Getting_Started # Linux/macOS wget https://apt.devkitpro.org/install-devkitpro-pacman chmod +x ./install-devkitpro-pacman sudo ./install-devkitpro-pacman sudo dkp-pacman -S 3ds-dev -
Install CIA building tools (makerom and bannertool)
# Windows # Download makerom and bannertool from: # - makerom: https://github.com/3DSGuy/Project_CTR/releases # - bannertool: https://github.com/Steveice10/bannertool/releases # Add both to your PATH # Linux/macOS git clone https://github.com/3DSGuy/Project_CTR.git cd Project_CTR/makerom make sudo cp makerom /usr/local/bin git clone https://github.com/Steveice10/bannertool.git cd bannertool make sudo cp output/*/bannertool /usr/local/bin -
Set environment variables (if needed)
export DEVKITPRO=/opt/devkitpro export DEVKITARM=${DEVKITPRO}/devkitARM -
Clone repository
git clone https://github.com/icicle1133/3ds-controller.git cd 3ds-controller -
Build application
# For 3DSX file make clean make # For CIA file make cia -
Output files:
3ds_controller.3dsx(Homebrew format)3ds_controller.cia(CIA format for installation via FBI)
-
Clone repository
git clone https://github.com/icicle1133/3ds-controller.git cd 3ds-controller -
Build application (Replace podman by docker if using Docker)
# For 3DSX file podman run -v $(pwd):/home-ext --workdir /home-ext -it --rm --name 3ds docker.io/devkitpro/devkitarm:latest make clean podman run -v $(pwd):/home-ext --workdir /home-ext -it --rm --name 3ds docker.io/devkitpro/devkitarm:latest make # For CIA file podman run -v $(pwd):/home-ext --workdir /home-ext -it --rm --name 3ds docker.io/devkitpro/devkitarm:latest make cia -
Output files:
3ds_controller.3dsx(Homebrew format)3ds_controller.cia(CIA format for installation via FBI)
- Install Python 3.6+
- Install packages:
pip install vgamepad - Install ViGEmBus driver
- Run:
python pc.py
- Install dependencies:
sudo apt-get install python3-dev libudev-dev - Install packages:
pip install python-uinput - Load uinput:
sudo modprobe uinput - Run:
sudo python pc.py
- Add ability to save multiple server configurations
- Add multiple device connections for local multiplayer
- Re-add keyboard/touchscreen support like CTurt's 3ds Controller had.
This project is protected by the PolyForm Noncommercial License