Scratch Everywhere 3DS

Scratch Everywhere
General
Author	NateXS
Type	Other Apps
Version	0.23
License	MIT License
Last Updated	2025/09/14
Links
Download
Website
Source

Scratch Everywhere! is a work-in-progress runtime written in C++ that lets you run Scratch 3 projects. Initially developed for the 3DS, it now supports a number of 6-8th generation consoles including Wii, Wii U, Vita and Switch.

Features

• Supports executing many Scratch 3 projects, including those created in modded clients like TurboWarp.
• Mouse controls are mapped to the touchscreen: glide a finger or stylus on the bottom screen to move the cursor, tap to click.
• Multiple screen modes available by adjusting project resolution in advanced settings (TurboWarp recommended).
  • Default projects use the top screen.
  • Set resolution to 400x480 for dual-screen mode.
  • Set to 320×240 for bottom screen only.
  • Set to 400×240 for top screen fit.
• Audio support for MP3, Ogg Vorbis, and WAV file formats.
• Special custom blocks exclusive to Scratch Everywhere!
• Modifiable framerate when using TurboWarp.

Installation

Download either the .cia or .3dsx version from the Releases page.

CIA:

• Install the .cia file with fBI.
• Place Scratch projects in 3ds/scratch-everywhere/.
• Launch Scratch Everywhere! from the Home menu.

3DSX:

• Place the .3dsx file in the 3ds/ folder.
• Place Scratch projects in 3ds/scratch-everywhere/.
• Run via the Homebrew Launcher.

Media

Porting Scratch to the 3DS (NateXS)

Limitations

General:

• Text and embedded bitmap images will not show up on vector images containing it.
• Extensions (e.g. pen and music extensions) are not yet supported.
• Some blocks may lead to crashing/unintended behavior (Please open an issue if you know of a block that's causing problems).
• Performance is poor when using many (~30+) clones (memory management issue).

3DS:

• If a sound has to load while other sounds are playing, all sounds will stop playing until the sound is loaded.
• Sounds may fail to load if the length of the sound is too long, or if there's too many sounds loaded at once.
• Performance is poor when lots of blocks are running at once.
• If you have a bunch of large images, some may not load.
• Some vector images will appear bigger than they should.

Changelog

Beta Build 23

• New Features
  • Scratch Everywhere! Custom Blocks!
    • This actually isn't a new feature, but we never talked about them at all so I'll talk about it here :)
    • Similar to TurboWarp's is compiled? and is TurboWarp? blocks, We've made a few new blocks that Scratch Everywhere! can understand!
    • You can still upload your projects to the Scratch website when using these new blocks!
    • is Scratch Everywhere!? block returns true if your project is running on Scratch Everywhere, and returns 0 otherwise.
    • is New 3DS block returns true if your project is being played on a New 3DS, returns false otherwise.
    • Scratch Everywhere! platform returns the platform your game is being played on (3DS,Wii,etc).
    • A project containing these blocks can be downloaded here!
  • Unpack project option in project settings!
    • Instead of the normal way the runtime works by putting the entire scratch project in memory, unpacking a project eliminates this by only loading things when it needs to!
    • Unpacked projects are great for large projects, and projects with a ton of images!
    • Depending on the speed of your SD card, unpacked projects can run way faster than normal projects!
    • Unpacked projects will have a lightning symbol next to it, and will appear towards the bottom of the project menu.
  • Bottom Screen option in project settings!
    • For 3DS, you can enable any project to be played on the bottom screen instead of the top screen!
    • Great for projects where the touchscreen plays a key factor in gameplay!
    • This also means Scratch Everywhere! can be used with a broken top screen! (I know at least 1 person will be happy about this)
• Runtime Changes
  • If you have a project in your Scratch Everywhere! folder named project.sb3, the project will now automatically run when opening the app.
  • Changed D-Pad controls in Main Menu
    • NOTE: If you're using a Wii Remote, this means you now have to use the remote sideways to navigate the Main Menu.
  • Added more splash text to the Main Menu
  • Fixed a ton of memory leaks under the hood
• 3DS Changes
  • Fixed buttons in the Main Menu sometimes not loading correctly
• Switch Changes
  • Changed resolution to the handheld's native 1280 x 720, instead of being a weird stretched resolution

Beta Build 22

• New Features
  • Brightness costume effect added!
  • Logs now get saved to a log file
    • Log file is located in the same spot your scratch projects are placed
    • [3DS] Logs are only saved when holding Select while launching the app
• Runtime Fixes
  • Fixed When this sprite clicked being ran for every sprite instead of only the sprite that's clicked
  • Fixed When this sprite clicked being able to click multiple sprites in one click
  • Fixed a few crashes that could happen related to audio
  • Fixed backdrop rendering
  • Added some new Main Menu splash text
  • A bunch of code refactoring under the hood
• 3DS Changes
  • Fixed bottom screen not rendering correctly

Beta Build 21

• New Features
  • Main menu splash text!
    • A random message will appear at the bottom of the logo!
• Runtime Changes
  • Reverted vector image collision fix
    • This caused many issues with image rendering, so vector image collision will be inaccurate until we find a better fix.
  • Fixed collision not working on clones
  • Broadcast and Broadcast and wait blocks should work more consistently
  • Fixed sprites sometimes rendering behind the backdrop
  • Added version number in main menu
  • Changed font in main menu
  • Fixed controls menu not saving or loading properly
  • Removed .sb3 extension in the project menu
• 3DS Changes
  • CIA release!
    • Highly requested feature finally brought together!
    • Via pull request #317!
  • New RAM_AMOUNT compile variable
    • Used for old 3DS to specify the maximum amount of RAM it can use
    • More info in the README
  • Changed executable name from Scratch to scratch-3ds
  • Optimized text rendering
• PS Vita Changes
  • Significantly improved performance!
    • Via pull request #321!
• Known Issues
  • Backdrop images may not render correctly
  • [3DS] File size is much larger due to using new fonts

Beta Build 20

• New Features
  • PS Vita port!
    • Via pull request (#274)
• Scratch Parity
  • Added When this sprite clicked block
  • Added When backdrop switched to block
  • Added Show list and Hide List blocks (Via #295)
  • Added support for dragging sprites
• Runtime Changes
  • Added support for more clones when Infinite Clones is enabled in TurboWarp or other Scratch Mods
  • Mouse position is now more consistent
  • Fixed collision on vector images being half the size it should be
  • Fixed Move __ steps block not fencing the sprite correctly
• Wii Changes
  • Fixed projects not searching in the right location in the SD card
• 3DS Changes
  • Changed icon

Beta Build 19

• Scratch Parity
  • Added support for hidden While block
  • Support last, all, and random as list indexes
  • Support Infinity and -Infinity
  • The default distance in the distance to block is now 10000
  • The mod block now works like Scratch does
  • Support scientific notation
  • Support octal, hex, and binary numbers
  • Support string comparisons
  • List block items no longer get separated by a space if all items are one character long
• Runtime Changes
  • Fixed crash when custom block arguments are used outside of the custom block definition
  • Fixed layering working incorrectly
• 3DS Changes
  • Stereoscopic 3D support!
    • Uses Scratch's layering system to determine 3D depth
    • NOTE: using 3D may result in worse performance. I'm working to fix this.
  • Fixed unzipped projects crashing after some time
• Wii U / Switch Changes
  • Added stick click support!
    • Left stick click is c
    • Right stick click is v
• Wii Changes
  • [EDIT quick fix] fixed projects searching in SD card root instead of searching in apps/scratch-wii

Beta Build 18

• New Features
  • Scratch Everywhere! logo
  • Added support for more image types
• 3DS Changes
  • When compiling an unzipped project, all bitmap images get converted to .t3x format
    • This means images will load way faster, and the problem with images not loading is gone!
  • Fixed audio cracking (again)
    • Note: audio may still crack in certain scenarios.
• Wii U Changes
  • Fixed icon and boot splash not showing up on the home screen
• Wii Changes
  • Fixed audio not working
  • Fixed wrong date in meta.xml
• Switch Changes
  • Fixed audio not working

Beta Build 17

• • Scratch Everywhere!
• The name has been changed to Scratch Everywhere!
  • That's Scratch Everywhere! with the exclamation point btw..
  • It made 0 sense to keep the name Scratch 3DS as this is now on 5 different platforms...
  • speaking of which...
• Switch Port!
  • For all 1.5 people who own a modded Switch, you can now enjoy Scratch games!
  • Via pull request (#97)!
• All new main menu screen!
  • The Main Menu has gone through a huge refactor under the hood!
  • It should be a smoother and better experience overall!
  • It's still a work in progress, but now it should be a little easier to add stuff to it in the future!
• Custom controls!
  • In the Project menu is a new option to remap the controls of any project!
  • Control mappings get loaded and saved to scratch-everywhere/'project_name'.json
    • Wii U is sd:/wiiu/scratch-wiiu/'project_name.json'
• Runtime changes
  • Sprite fencing has been implemented!
    • Can be disabled with TurboWarp or other Scratch mods.
  • The Stop 'All' block now takes you back to the Main Menu instead of the homebrew menu!
    • Note: The Wii U will still exit the app, as it would freeze when going back to the Main Menu for some reason.
  • Booleans (anything set to true or false) now doesn't get set to 1 or 0 by the runtime mistakenly
  • Fixed a couple of crashes that could happen while loading
  • Custom blocks with no definition now works as intended
    • Logging blocks created by Scratch Addons Debugging Addon can now be used.
  • The runtime can now be compiled with ENABLE_AUDIO=0.
    • For the 3DS, this means smaller file size, and you no longer need SDL2 to compile.
• 3DS Changes
  • Fixed crash when closing the app
  • Fixed audio cracking issue
  • Sprites are no longer rendered in fractional positions, fixing some image weirdness
  • Changed image filtering from nearest to linear
    • This fixes the image fuzziness and weirdness issues, with a tradeoff to some images looking slightly blurry. I might add a filtering option to the Main Menu in the future.
• Wii Changes
  • Fixed projects not showing up in Main Menu
  • Fixed images sometimes not being able to load
  • [Quick Edit 16 Aug 2025] Fixed meta.xml showing the wrong date
• Wii U Changes
  • Fixed projects not showing up in Main Menu

Beta Build 16

• Wii and Gamecube port!
  • The runtime has been ported to 2 new consoles!
  • More information in the README!
• [3DS and Wii U] Cloud Variable support!
  • Cloud Variables now sync over the network with anyone also playing the same game!
  • Syncs across both Wii U and 3DS
  • Note: does NOT sync with people playing on the Scratch website or Turbowarp.
  • Via pull request (#145)
• Runtime Changes
  • Broadcast blocks now have more consistent behavior
  • Disabling Fencing in advanced settings now disables size limitations
  • Variables set to True or False no longer gets set to 1 or 0
  • Images in any project now only load whenever it's needed, instead of loading every image in memory while loading the project
  • [Wii U] Main Menu with no projects should now work correctly
  • [Wii U] Unzipped projects now load images and sounds correctly
  • [3DS] when compiling, the final executable will now be in build/3ds/ instead of the root directory.

Beta Build 15

• New Features
  • Vector Image Support
    • You no longer have to convert your vector images to bitmap!
  • [3DS] Mouse Mode
    • Mouse mode has been removed and replaced with Trackpad-like behavior on the bottom screen!
    • Glide your finger/stylus on the bottom screen to move the mouse, and quickly tap to click
    • The old "holding L and using the D-pad" has been removed
    • If your scratch project uses the bottom screen, trackpad mode is disabled and replaced with normal touchscreen behavior
• Runtime Changes
  • Fixed "If" blocks continuing if it should've been stopped by a Stop 'this script' block
  • Fixed "List" blocks not working correctly if set to For this sprite only
  • [3DS] fix Main Menu error text being cut off
  • [Wii U] Mouse position is now calculated accurately
• Known Issues
  • [3DS] Some vector images may appear bigger than they should
  • If a vector image contains text, the text will not render

Beta Build 14

• New Features
  • "Show variable" and "Hide variable" blocks added!
  • Variables can now show on screen!
• Runtime Changes
  • Fix broadcast blocks not working correctly sometimes
  • Fix Stop "this script" and Stop "other scripts in this sprite" blocks not working correctly sometimes
  • Fix invalid sounds crashing the app
  • [Wii U] Unselected projects in Main Menu are now black instead of red
  • [3DS] if compiling an unzipped project, more images can now be loaded without failing
  • [3DS] You no longer crash/get kicked to the homebrew menu while loading images initially
    • If your project has many images, some will not load and render as a black square. A fix for this is in the works.
  • [3DS] when compiling, you now have the option to disable the loading screen visuals. Run make ENABLE_BUBBLES=0 when compiling.

Beta Build 13

• New Features
  • [Wii U] Main Menu and file picker!
    • You no longer have to name your project "project.sb3", and can have as many projects as you want!
    • You still need to put all your projects in sdcard:/wiiu/scratch-wiiu/.
• Runtime Changes
  • [3DS] Loading sounds now run in the background and no longer freezes the game!
    • Known issue: loading a sound while other sounds are playing will mute all sounds until the sound is done loading.
  • [3DS] Fixed crash if an image failed to load
  • "Set Volume to", "Change Volume by", and "Volume" blocks added
  • Fixed Play Sound until done block not working correctly if played in the Stage

Beta Build 12

• New Features
  • [3DS] Audio Support!
    • "Sound effect" (volume, pitch) blocks still not implemented yet
    • See README for more limitations
• Runtime Changes
  • Fixed repeat blocks behaving weirdly if run from a broadcast block
  • Fixed "If on edge, bounce" block not taking into account the scale of the sprite
  • Fix collision sometimes not working
  • [3DS] Fix project names sometimes not rendering in Main Menu
  • [3DS] Fix projects not being able to go above 30 FPS
  • [3DS] You now need 3DS versions of SDL2 and SDL2_mixer to compile
  • [Wii U] Sound loading now runs in the background and doesn't freeze the game
  • [Wii U] Images now work on unzipped projects
  • [Wii U] Fixed screen tearing

Beta Build 11

• New Features
  • [Wii U] Audio Support!
    • Supports mp3, wav, and ogg currently
    • "Start sound" "Play Sound Until Done" and "Stop all Sounds" implemented
    • "Sound effects" (volume, pitch) not yet implemented
    • 3DS audio support was going to be this beta, but there's still a couple of things to fix there unfortunately.
• Runtime Changes
  • [3DS] Fixed crashing when sometimes loading an image for the first time
    • this fix could also fix the Main Menu crashing, but again I didn't have that issue in the first place and can't test if this is true.
  • [3DS] Doubled the amount of time an image can go unused before being freed
  • [3DS] Fixed rotation and scaling inconsistencies (via #137 )
  • [Wii U] Added support for 'ghost' effect block

Beta Build 10

• Costumes now prioritize names over index
• Fixed empty costume inputs causing the app to close
• Fixed "Key Pressed" block with other blocks as input causing crashes
• [Wii U] Fix freeze when going to home menu and back in game
• Fix weird behavior when multiple custom blocks have the same argument variable names

Beta Build 9

• Fix "wait" block not working
• Added black bars to the sides of the screen if the aspect ratio of the project and screen don't match

Beta Build 8

• Wii U Port!
  • @gradylink was epic enough to port the runtime to Wii U!
  • Features basically everything the 3DS port currently does!
• Runtime Changes
  • [3DS] Fixed long names in the Main Menu being cut off
  • Fixed 'if' Blocks with time-based blocks inside not working properly
  • Fixed some blocks returning "0" when they should have returned nothing
  • Fixed some sprites not rendering in the correct position
  • Fixed "Pick Random" block not working as intended sometimes
  • Fixed certain costumes not being set correctly
  • Fixed sometimes not having any "advanced settings" get enabled
  • Fixed size not getting set if sprite has never been rendered yet
  • "Wait" block now waits for at least 1 frame, matching Scratch's behaviour

Beta Build 7

• Parity Changes
  • Costume Blocks with numeric values as input now sets the correct costume
  • Non-centered sprites now correctly* detect collision
• Runtime Changes
  • Fixed a crash caused by 'Repeat Until' block
  • Fixed being unable to close the app while in the Main Menu
  • Fixed advanced settings not working if setting 'disable fencing' 'infinite clones' etc
• Known issues
  • non-centered sprites still do not correctly detect collision if dual-screen mode is enabled
  • Some blocks causing unintended bahaviour, I'm currently investigating which ones
  • Some images may fail to load and render as a black square if your project has many images

Beta Build 6

• Runtime Changes
  • Fixed loading images sometimes causing crashes
  • Flipped sprites now render in the correct position*
  • The collision of sprites is now correctly detected when scaled
  • The collision box no longer rotates when rotation mode is "don't rotate"
  • If VRAM usage is too high, new images will wait to load instead of going over the VRAM limit and crashing
  • fixed crash caused by 'repeat until' block
• Known Issues
  • some flipped sprites still wont render in the right position
  • Image loading for some reason is still having issues sometimes
  • Some people last Beta reported the main menu crashing their system, but I couldn't reproduce it for myself. I did a slight optimization this Beta with text rendering, but I don't know if that fixes the crashes or not.

Beta Build 5

• Additions
  • New Main Menu screen! If there's no project in the RomFS, this will be what loads!
    • You no longer have to rename your projects "project.sb3," and you can now have as many projects as you want on your SD card!
    • The menu is pretty simple right now, more to be added here in future releases.
    • If you're compiling, you still need to name your project "project.sb3"
  • Bottom Screen only support! it gets enabled if you set your project dimensions to 320x240 with Scratch mods like TurboWarp.
  • 'Ghost' Costume effect block added
  • 'Clear graphic effects' block added
  • Changed name from "Scratch 3DS Runtime" to just "Scratch 3DS"
• Bug Fixes
  • Fixed empty operator blocks causing crashes
  • Images less than 255x255 in size should load faster
  • Sprites' minimum and maximum scale has been changed to match Scratch
  • Sprites can now be rotated with values smaller than 1, matching Scratch's behavior
  • Fixed certain blocks and large projects in general causing the app to close
• Known Issues
  • Image related crashes and bugs are still a thing in this beta :(

Beta Build 4

• Runtime Changes
  • Projects now load and run much faster!
    • My test project on old 3DS now runs with no lag!
    • This is thanks to me turning on some compiler optimizations, not sure if this will cause issues down the road so I'll be monitoring this as time goes on.
  • New homebrew app icon! (via #31)
  • Changed homebrew app Description
  • Fixed image flickering issue
  • Fixed loading multiple large images at the same time causing crashes
  • Images now properly get freed from memory after 4 seconds of being unused, or when crossing a memory threshold
  • Repeat blocks inside of Repeat blocks now work correctly again
    • this also includes blocks like wait until, forever, glide to, etc
  • "username" block works properly again; it uses your 3DS's nickname
  • Fixed Custom Blocks sometimes making the app close during loading
• Known Issues
  • There are still a ton of bugs and crashes related to images and image loading, I'm working hard to fix these but for now I recommend keeping your image sizes small.
  • sometimes sprites could get rendered in the wrong place

Beta Build 3

• Parity
  • The "When Key Pressed" block now works correctly
  • The "If On Edge, Bounce" block now works correctly
• Runtime Changes
  • the ZR button is now mapped to the 'F' key on the keyboard
  • fixed a bug where deleting and making a new clone at the same time caused crashes
  • fixed an issue causing large images to crash
    • (known issue) this fix introduced flickering when constantly switching costumes. Will be fixed in a later Beta
  • fixed vector images sometimes causing crashes

Beta Build 2

• Runtime Changes
  • Projects now run 3-10x faster on New 3DS, thanks to now using the New 3DS's extra power!
    • my test project went from 10 - 50 ms of frametime to 4-10 ms of frametime!
  • Loading projects is now run on a seperate thread
  • added a very simple loading screen while loading a project
  • Loading screen will now show errors if it cant find a project, instead of just crashing
  • reverted the 1000 block at a time limit
  • fixed "switch costume to" and "switch backdrop to" blocks sometimes causing crashes
  • the new image freeing method actually works now and doesn't crash
  • pressing start no longer closes the app

Beta Build 1

• Runtime changes
  • BIG code refactoring under the hood! projects should run faster on average!
    • There may be some crashing and bugs that I haven't seen yet, so beware...
  • any block that repeats across multiple frames (repeat blocks, forever, etc) now run way faster and is WAY less bug-prone.
  • custom blocks are now way less bug-prone.
  • Changed the behavior of images.
    • In the old system, when changing costumes, the old image would immediately be deleted and have to be reloaded.
    • The new system allows for a certain amount of images to stay loaded in memory before being deleted.
    • This means performance is way better if you're constantly switching costumes and backdrops.
  • you can now see debug text if hold SELECT while launching
  • blocks now get skipped if over 1000 blocks are running at the same time (may remove this later tbh)
• Parity Changes
  • "touching sprite" block now only works if the sprite is visible
  • fixed "move _ steps" block moving sprites in the wrong direction

Alpha Build 4

• New Features
  • Added "If on edge, bounce" block
  • Added "days since 2000" block
  • Added "Current (year,month,etc)" blocks
  • Added "Ask and wait" and "answer" blocks
  • Added "glide x seconds to" blocks (known bug causing them to not work as intended.)
  • Added "When key pressed" hat block
  • Increased max clone count to 300 (though honestly right now you shouldn't go over like 5 💀)
• Bug Fixes
  • Fixed unzipped projects crashing on startup
  • Fixed crash when using a variable block
  • Fixed nested repeat blocks not working correctly
  • Fixed custom blocks and repeat blocks not working together correctly

Alpha Build 3

• New Features
  • Scratch projects can now load when unzipping it in romfs beforehand. Doing it this way allows for faster loading times, less image limits, and the ability for me to add audio support later down the line.
  • slight performance boost
• Fixed Bugs
  • Rendering is now correct when bottom screen is enabled
  • Sprites are now rendered in the correct position
  • Fixed sprites not correctly rendering its transparent areas
  • Mouse pointer now only shows if holding the L button, no longer all the time
  • Fixed touch screen not touching in the correct position
  • Fixed blocks under a custom block not being run
  • Fixed blocks under a custom block being run twice in a single frame
  • Fixed clones having incorrect collision
  • Sprite X and Y values are now doubles instead of ints for greater precision
  • Fixed wait block crashing game
  • Fixed wait block running more than once per frame
  • Integer variables are now correctly integers instead of doubles
  • general source code refactoring

Alpha Build 2

• New Features
  • Bottom screen support! You must use a modded scratch client like TurboWarp to set the project's size to 400 x 480 to enable this.
  • You can now set custom FPS. You also need Turbowarp or other to set project FPS.
  • "Set Rotation Style" block added
• Bug Fixes
  • fixed conditionals not being read if put in the inputs of blocks
  • rendering now takes the project's width and height into account
  • fixed bug causing crash if a variable was inside of a "Switch Costume To" block
  • fixed repeat blocks not working
  • fixed a crash caused by deleting clones
  • equals block now correctly works
  • fixed repeat blocks sometimes not repeating when a clone uses them
  • fixed sprites not rendering if their size was less than 100%
  • fixed blocks run after a custom block having "Run Without Screen Refresh" enabled
  • fixed bug causing custom blocks to crash on real hardware

Alpha Build 1

• First Release.

External links

• GitHub - https://github.com/NateXS/Scratch-Everywhere
• GBAtemp - https://gbatemp.net/threads/wip-scratch3ds-scratch-for-the-3ds.536651/