# Setting up NSMBe5 on Linux

If you are considering swapping to Linux (or are already using Linux), modding NSMB DS is still perfectly doable! NSMBe just needs a little bit of setup before you can begin opening levels. After this tutorial, you'll be up and running with NSMBe on your favorite Linux distro.

- This tutorial has been tested on the following operating systems:   
    \- Fedora   
    \- Manjaro (should work for every Arch-based distribution)   
    \- Linux Mint (should work for every Debian-based distribution)   
    Help us improve the compatibility list!

### Requirements:

- A computer running Linux
- [The latest build of NSMBe5](https://github.com/MammaMiaTeam/NSMB-Editor/releases/latest/ "NSMBe5 download link")

<p class="callout warning">While not *needed*, having administrator permission (sudo) is helpful for troubleshooting</p>

### Step 1: Installing [PortProton](https://flathub.org/apps/ru.linux_gaming.PortProton)

#### Method 1: Via Flathub (recommended)

Follow the [Flathub setup guide.](https://flathub.org/setup) Then, install the app by opening a terminal and typing:

```bash
flatpak install flathub ru.linux_gaming.PortProton
```

<p class="callout warning">If it doesn't work or you need admin rights, check the second method.</p>

#### Method 2: Manual installation

Go to [flathub.org/apps/ru.linux\_gaming.PortProton](http://flathub.org/apps/ru.linux_gaming.PortProton) and hit “download”. This will download a `.flatpakref` file.

The file should appear in your Downloads folder. If your browser asks you where it should save it, choose a location that you will remember.

[![Capture d’écran du 2025-03-23 12-42-49.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/capture-decran-du-2025-03-23-12-42-49.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/capture-decran-du-2025-03-23-12-42-49.png)

Go to the file's location, right-click an empty space, and select "Open in a terminal". From there, type the following command:

```bash
flatpak install ru.linux_gaming.PortProton.flatpakref
```

If it doesn't work because admin rights are needed, try the following command instead:

```bash
flatpak install --user ru.linux_gaming.PortProton.flatpakref
```

<p class="callout warning">If this method still doesn't work, ask us in NSMB Central.  
</p>

<p class="callout success">Congratulations! You're now ready to open NSMBe!  
</p>

### Step 2: Installing NSMB Editor

<p class="callout info">PortProton might download some files before starting the first time you launch it. That's normal.</p>

Go to your NSMBe5 folder. Open `NSMBe5.exe` by double-clicking on it. You should see a window like this:

[![Copie d'écran_20250330_212505.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/copie-decran-20250330-212505.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/copie-decran-20250330-212505.png)

<p class="callout warning">Make sure to change the prefix to "DOTNET"</p>

If you want to add a shortcut to your app menu, click on "Create shortcut". It will ask you where to put it:

[![Copie d'écran_20250330_212530.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/copie-decran-20250330-212530.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/copie-decran-20250330-212530.png)

Once it's done, click "create shortcut".

Now, to launch the app, just have to click on the "Launch" button, and there you go!

[![Capture d’écran du 2025-03-23 12-51-25.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/capture-decran-du-2025-03-23-12-51-25.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/capture-decran-du-2025-03-23-12-51-25.png)

<p class="callout success">Congratulations! Now, you are ready to make awesome stuff with Linux!</p>


### FAQ / Troubleshooting

> ##### Some actors appear weirdly, how can I fix it?

When opening a level in the level editor, some elements may seem scaled incorrectly:

[![Fractionnal scaling issue.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/Qjvfractionnal-scaling-issue.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/Qjvfractionnal-scaling-issue.png)

This is because your computer is using **fractional scaling**. This zooms your screen, but not all elements in the app. To fix that, go into your display settings and select 100% or 200%:

[![Display.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/my0display.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/my0display.png)

Now it's working better!

[![Now it's working!.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/now-its-working.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/now-its-working.png)

<p class="callout info">No better solution has been found yet. If you have one, please tell `@rph_nsmb` on the NSMB Central server.</p>

> ##### It takes a while to navigate with the file explorer. Can't I add a shortcut?

Of course you can! First, you will need to go to the parent folder of the one you want to make a shortcut (for example, I want to add `/home/rph/Documents/Template`, I'll go to `/home/rph/Documents`). Right-click on the folder you want to make a shortcut and select "create link". You should see something like this:

[![Link.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/link.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/link.png)

<p class="callout info">If you don't see the "Create shortcut" option, take a look at the file explorer's menus or check its settings.  
</p>

 Right-click on the link and select "cut".

Now, you will need to go to your PortProton setting folder. To do so, go to your home folder and go to `PortProton/prefixes/DOTNET/dosdevices`. Now paste your linked folder and rename it to a lowercase letter followed by a colon, for example: `n:`.

[![Drive.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/drive.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/drive.png)

Now, if you open the file explorer, you should see your drive in "Computer":

[![Drive 2.png](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/scaled-1680-/drive-2.png)](https://bookstack.nsmbcentral.net/uploads/images/gallery/2025-04/drive-2.png)

<p class="callout success">Congratulations! You have your shortcut.</p>