Guides‎ > ‎

Overlay Environment Setup (WSL)

This guide was kindly brought to you by @AriaHiroshi

-- Introduction --

The goal of this guide is to set up everything you need to compile custom Zelda actor overlay files on Ubuntu and WSL on windows 10. If you are looking for a guide geared towards Windows specifically, use this one instead.

-- WSL --

Go download Ubuntu from the Microsoft store. Any Linux Distro will work but you need to substitute commandline instructions that reflect the distribution of choice. This guide will be using the plain Ubuntu version but LTS should work.

Now to enable WSL open PowerShell as Administrator and run: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux. After that reboot windows.

You are now able to run Ubuntu from the start menu. It will install the basic bash. This will take 5 - 20 minutes depending on your specs. When done it will ask you to create a new Username and password. This is separate from your windows account. Then type in sudo apt-get update to make sure your system is up to date.

Note: NEVER edit WSL's director with any program outside of a terminal including file explorer cmd and powershell. YOU WILL KILL WSL. Fortunately window has an alternative terminal that is tabbed and starts wsl in your windows home directory at or the windows store.

-- n64 --

If you are unfamiliar with how the command line works, you basically type commands and press the return/enter key on your keyboard to execute them. You're also able to copy and paste, but be careful to copy and paste only one line at a time. When you're prompted with a Y/N prompt, type Y before pressing the return key to say "yes", or N for "no". if it asks for a password and you enter characters the input is accepted but invisible for security reasons.

First, type

sudo apt-get install git gcc unzip mercurial automake libelf-devlib perl-dev libgtk2.0-dev

and press the return key. Type Y for yes and press the return key to install.

Now do all of the following, one line at a time:

git clone

cd n64

sudo ./install_deps

sudo ./configure --prefix=/opt/n64

Note: adding --enable-vc will enable some virtual console compatibility if you wish to.

now do:

sudo make install-toolchain

It's going to take some time for it to do its thing. An hour or two, give or take. Add -jX to the end to speed it up, where X is the number of cores. For example, try -j3 on a computer with four cores to use three, leaving one for background processes.

Once that's complete, type sudo make install-sys

-- z64ovl --

The last thing to do before closing this window is to copy and paste the following:

sudo rm -rf /opt/n64/mips64/include/z64ovl

sudo git clone && sudo mkdir /opt/n64/mips64/include/z64ovl && sudo mv -f z64ovl/* /opt/n64/mips64/include/z64ovl && sudo rm -rf z64ovl

Any time you want to update z64ovl, copy and paste those commands into the Terminal.

-- nOVL --

Now we need to get nOVL

to build it yourself type this one command at a time:

cd ../

sudo hg clone

cd novl



cd src

sudo mv nOVL /opt/n64/bin/novl

or, download (here), and extract novl into /opt/n64/bin/

-- Bashrc --

to export a path in the commandline we will use nano since it works on both ubuntu and wsl. It looks scary but we will venture together. DO NOT EDIT BASHRC IN WINDOW ITSELF DO IT IN WSL ITSELF WSL WILL DIE.

do the following:

sudo nano ~/.bashrc

In nano, you can go to the end of the file by pressing down on your keyboard.

at the end type the following at the last line:

export PATH="/opt/n64/bin/:$PATH"

then press F2, then Y and enter save and quit, then reload bash with the following.

source ~/.bashrc

Now you should be all set.

-- Closing --

To test if your installation works, follow the guide Custom Actor Overlay Workflow*.

* but instead of right clicking you need to cd to your make file
to navigate up a folder just do cd ../
and to go up a folder do a cd folder/