Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
63 lines (42 sloc) 3.45 KB

McOsu NX

WARNING: Use HBL takeover or NSP HBL to launch, or you WILL run out of memory and crash!


Discord (Feedback, Requests, Bug reports, etc.):

This repository is for the Nintendo Switch port.
For the game code and Desktop version see

An unofficial open-source client for osu! beatmaps, with the main focus on making practicing easier and customizing gameplay.

Runs on McEngine:

(McOsu-NX is a delta repository, i.e. everything you need in addition to the engine code and game code)

How to install:

  1. Download the newest zip file from the releases page
  2. Merge the contents of the zip file with your microSD card (do NOT change any folder/file structures/names!)
  3. Launch HBL via takeover or HBL via the NSP version (to get full RAM access, which this game requires), and start McOsu

How to use:

  • NOTE: You don't have to create any folder structures, everything is already prepared. Follow the guide on extracting beatmaps/skins below, and simply put them into /switch/McOsu/Songs/ or /switch/McOsu/Skins/ on your microSD card. Default beatmaps are already included, so just follow their structure.

  • How to add beatmaps/skins:

  • FAQ:

  • The game will give you a big fat warning on the main menu if it doesn't have access to enough memory (< 1 GB).

  • At least on my system, if you still launch HBL via the Album applet, then only ~400 MB out of 4 GB are available, and some of that is already used up. (This might not even be a problem anymore with newer Atmosphere/ReiNX/etc. versions.)

  • I have only tested this on firmware 5.1, with a pretty old SD setup and RajNX (which is no longer maintained), but never change a running system you know.

  • If you get audio crackling after minimizing the game or going into sleep mode: To fix it, Go to Options > Audio > "Restart SoundEngine (fix crackling)"

  • If you are playing beatmaps with a lot of sliders visible at the same time, and consistently getting less than 60 fps, improve performance by enabling Options > Skin > "Use slidergradient.png"

  • If you get stuck at 0% loading forever, then the resource loader thread could not be created. Try restarting the game, HBL, and your system, in that order. This has only happened to me once, so it shouldn't be a problem.

  • All speed changing mods are unavailable (DT/HT/DC/NC, Speed/BPM Multiplier, Timewarp) because the audio library does not support varying playback speed (yet).


controls screenshot1 screenshot2 screenshot3 screenshot4 screenshot5

Skin Credits:

  • ffffffffffffffffff - "- Jaret - Mish Mosh"
  • irrlux - "Talrava XIV"
  • HazrdMC - "Phaze"
  • Redon - "Aesthetic 1.3"
  • DarkSlayer000 - "xXx_SampleSkin_xXx v1.3"
  • Inori - "Stepmania"
  • taikuta - "Murakumo"
  • Easy - "Burning_Crow V2"
  • Icomoon
  • Freepik
You can’t perform that action at this time.