Edit Infobox 3DS Homebrews: Ctroller 3DS

You do not have permission to edit this page, for the following reason:

The action you have requested is limited to users in one of the groups: Users, Administrators.

Title:
Image:	Upload file
Description:
Author(s):
Last Updated:
Contributor(s):
Ported by:
Type:
Version:
License:
Language(s):
Format:
Download:
Download Raw:
Website:
Source:
Discussion:
Donation:

Free text:

Ctroller is an application that allows you to use your 3DS as an input device for your Linux system via the uinput kernel module. Inspired by [[3DSController]], it consists of a client that runs on your 3DS, continously streaming the 3DS input data to a server on your PC. The server exposes a virtual device to your system, interpretes the data it receives and writes it to a event node under <code>/dev/input/event*</code> or similar. '''Note:''' This project is no longer maintained, it might still work in an up to date homebrew environment but this is not guaranteed. ==Installation== ===Prerequisites=== You will need [https://sourceforge.net/projects/devkitpro/files/devkitARM/ DevkitARM] and the [https://github.com/smealum/ctrulib ctrulib] to build the 3DS component. Building the 3DS CIA requires [https://github.com/Steveice10/bannertool bannertool] and [https://github.com/profi200/Project_CTR/tree/master/makerom makerom] to be in your <code>$PATH</code>. To run the server, the <code>uinput</code> kernel module needs to be loaded: <source lang="bash"> $ modprobe uinput </source> ===Building=== Run <code>make</code> to build both components, or enter either of the <code>3DS</code>/<code>linux</code> subdirectories to build them individually by running <code>make</code> there. You can use the <code>debug</code> target for development. ===Installing=== If you are using Arch Linux, install [https://aur.archlinux.org/packages/ctroller-git/ ctroller-git] from the AUR. Or use [https://aur.archlinux.org/packages/ctroller-bin/ ctroller-bin] if you do not want to set up the 3DS toolchain. Install the server to your system by running <code>make install</code>. This is equivalent to: * <code> $ cd linux </code> * <code> $ make install DESTDIR="" BINDIR="/usr/bin" </code> * You can set <code>DESTDIR</code> to a install to a different location, i.e. <code>make DESTDIR="/my/fakeroot/environment"</code> installs ctroller in <code>/my/fakeroot/environment/usr/bin</code>. Download the [https://github.com/phijor/ctroller/releases/latest latest release of the 3DS binaries]. Or you can build them yourself: * <code> $ cd 3DS </code> * <code> $ make release </code> Install <code>ctroller.cia</code> with the CIA-manager of your choice. If you want to install the 3DSX-executable: * Copy <code>ctroller.{3dsx,smdh}</code> to <code>/3ds/ctroller/</code> on your SD card. * You can also directly upload the application to your 3DS using [https://github.com/phijor/ctroller/blob/master/3DS/upload.sh upload.sh] (do not blindly execute unknown scrips). * To do so, start a FTP server, such as [[Ftpd 3DS|ftpd]], on your 3DS on port 5000, then run: ** <code> $ cd 3DS </code> ** <code> $ make upload DSIP=<IP of your 3DS here> </code> ** Note this requires <code>ftp</code> to be installed on your system. Create a directory <code>ctroller</code> in the root of your SD card. Place [https://github.com/phijor/ctroller/blob/master/3DS/ctroller.cfg 3DS/ctroller.cfg] in there and replace the IP with the one of your PC (The config file should now be at <code>sdmc:/ctroller/ctroller.cfg</code>). ==User guide== Start the server by running: <source lang="bash"> $ ./linux/ctroller </code> </source> Usage: -d --daemonize execute in background -h --help print this help text -p --port=<num> listen on port 'num' (defaults to 15708) -u --uinput-device=<path> uinput character device (defaults to /dev/uinput) Then launch the ctroller.3dsx application on your 3DS using a homebrew launcher of your choice. For development purposes, the 3DS-Makefile includes a <code>run</code> target that uses <code>3dslink</code> to upload and run the application using the Homebrew Menu NetLoader. ===Notes=== This program is intended to be used in a private network. For simplicity, the server right now accepts any connection on it's port, which might pose a security risk if others can send data to it. This will be changed in future releases. For now, you probably shouldn't be using this in a public network. ==Changelog== * GitHub - https://github.com/phijor/ctroller * Arch Linux - https://aur.archlinux.org/packages/ctroller-git * Reddit - https://www.reddit.com/r/3dshacks/comments/4iko2r/ctroller_use_your_3ds_as_a_gamepad_on_your_linux

Summary:

Cancel