dev builds
themes manual
device status forums
mailing lists
IRC bugs
dev guide

Search | Go
Wiki > Main > RockboxDevelopment > Windows10CrossCompiler

Building a cross compiler on Windows 10

Compiling Rockbox on Windows 10 is a lot easier using the new linux subsystem than using a VM or cygwin.

Setup Ubuntu environment in Windows 10

Install Windows Subsystem for Unix

Enable developer mode and then check the Windows Subsystem for Unix option. More instructions:

Install Ubuntu from the Windows Store

Open the Windows store, search for Ubuntu, and then install it or a similar linux distribution. Choose a username and password when prompted

Install build dependencies

From the Ubuntu console, type:

sudo apt-get update

sudo apt-get install git build-essential texinfo bison libtool autoconf flex zip libtool-bin

Checkout the rockbox source

git clone git://

This will create a local checkout of rockbox on your Windows hard drive. We'll access it later to get binaries.

Build the cross compiler

After the above command, navigate to the rockbox folder you just checked out (cd rockbox). Then type:

cd rockbox

sudo tools/

Type the password you selected and then choose which compilers you want (probably ARM). MIPS does not currently build under Windows.

This will run for 10-30 minutes depending on how fast your computer is. Disabling Windows defender will speed up compiling if you are impatient.

Compile Rockbox

Find Rockbox folder

At this point you have the dev tools setup and you can compile rockbox like on any other platform. However, once built, your binaries will appear in a subfolder of:


In this folder will be a CanonicalGroupLimited? folder containing your local Ubuntu file system. By default rockbox will have been checked out to rootfs\home\USERNAME\rockbox\ where USERNAME is the name you selected above. Note that while Windows can read these folders, editing files in Windows software may corrupt them, so do not write to the Ubuntu file system from Windows.

More information is available here:

-- MichaelGiacomelli - 08 Jul 2018
r3 - 27 Apr 2019 - 18:17:44 - JohannesRauh

Copyright by the contributing authors.