Skip to content

Initial Setup

cobalt2727 edited this page Apr 26, 2022 · 51 revisions

First things first, here's a guide to get you set up on installing Ubuntu to your Switch:

https://wiki.switchroot.org/en/Linux/Ubuntu-Install-Guide

Install/Run the Megascript

If you are using a Nintendo Switch on L4T Ubuntu 3.4.0 or newer, you already have the L4T Megascript. Search your applications list for the icon.

Option A (no terminal use needed, update to L4T 3.4.0+ for use on Nintendo Switch only - not applicable to other Tegra hardware):

1. If you're already using 3.4.0, go directly to step 4. However, if you're on an older version (3.3.0 or lower), download the 3.4.0 Update Files
2. Remove /bootloader/ini/01-ubuntu.ini file from the fat32 partition on sdcard.
3. Extract the update_only 7z file to the fat32 partition on your SD card (if you have no space, try removing all Ubuntu related files from the fat32 partition on your SD card, and try again).
4. Dump joycon pairing info in hekate (if you haven't ever done so).
5. Boot your Switch and you will have the L4T Megascript in your applications list, which you can select to run the Megascript.

Option B (works for Jetson Nano users, Switchroot Focal beta testers, and most likely other Tegra hardware in Ubuntu - run the Megascript directly from the terminal just once and get an app icon for future launches):

Boot L4T on your device and open a terminal (Ctrl + Alt + T or open Terminal from the app list), then copy and paste the following command to automatically update dependencies and run the Megascript: (Hint: We've got a headless mode! If running over SSH with no display, remove "gui")

bash <( wget -O - https://raw.githubusercontent.com/cobalt2727/L4T-Megascript/master/core_refactor2.sh ) "gui"

Note: do not run this command with sudo - the script will prompt for admin access as needed.

An L4T Megascript application will be added to your system when you run the Megascript for the first time.

This can be found at /usr/share/applications/ if you want to remove our .desktop file later, for any reason.

IMPORTANT NOTE IF YOU GET ERRORS INVOLVING TURUL REPOSITORIES

You are running an old and unsupported version of L4T Ubuntu, and should definitely update for the best experience. Follow the steps above, Option A

We HIGHLY recommend that you first run the initial setup script to ensure everything is in working order.
Here's all the options included in that:

Flatpak Setup+Fix

Workaround permissions issues due to options not supported in L4T Kernel
Note that Flatpak applications (and Snaps) apparently have no hardware acceleration on Tegra platforms, so do NOT use them for anything complex like games (and we don't recommend that you use Snaps at all)

Joy-Con Mouse

Lets you use the Joy-Cons as - you guessed it - a mouse/keyboard.
Note: Joy-Cons, Switch Pro Controller, Dualshock 4 (wired only), XBox One Controller (wireless only), and Nintendo GameCube Controllers (when using the ToadKing Gamecube Driver) are currently supported.

Default button configs for Joy-Cons/Pro Controller (other controllers similar):

Button Key
B Left Click
A Right Click
X Middle Mouse Button
L Volume Down
R Volume Up
ZR Brightness Up
ZL Brightness Down
D-PAD Keyboard Arrow Keys
Screenshot Turn the mouse off and on (leave off when playing games)
Home Escape
+ Enter
- Back
Right Stick Click F5
Left Stick XY Mouse XY
Right Stick XY Scroll XY

SDL2

Installs SDL2.0.14 Debian binaries compiled on Switch hardware (RetroPie SDL2.0.14 Fork). It's a requirement for many games in the script (which is why it installs as part of the main L4T-Megascript as well as being included in the Initial Setup script.

The following programs (and many others!) require SDL2:

SRB2, SRB2Kart, SuperTux2, Celeste (Pico-8 Port), Flappy Bird, SM64 Port, RetroPie (automatically installs with Retropie), Box64

And that's all! You're all set to install just about any other program included in the Megascript. Check the individual wiki pages to read more on a particular game or program.

(If possible, you definitely want to hook up a USB keyboard and/or mouse to make setup easier...)

Clone this wiki locally