SMS Launcher
SMS Launcher is a native PC port of Super Mario Sunshine for Windows, macOS, and Linux that guides you through setup and provides a one-click play button.
- Type: PC port
- Game: Super Mario Sunshine
- Runs on Windows, Linux and macOS
- By chasem-dev
- Latest release v1.1.0, 2026-11-06
- Source: https://github.com/chasem-dev/sms-launcher
README
SMS Launcher

Set up and play Super Mario Sunshine on Windows, macOS, and Linux. SMS Launcher guides you through setup, downloads the tools it needs, and gives you one big Play button when you're ready.
Bring your own ROM is required. You need a disc image made from your own supported Super Mario Sunshine disc. The launcher does not include a game or disc image.
Download
Download SMS Launcher from the latest release
Choose the launcher file for your computer:
| Your computer | Download |
|---|---|
| Windows | The .exe installer, or SMS-Launcher-<version>-win-portable.exe for the portable version |
| Mac — Intel or Apple Silicon | SMS-Launcher-<version>-mac-universal.dmg |
| Linux | SMS-Launcher.AppImage |
The launcher requires a 64-bit computer and an internet connection for setup. Required setup tools download automatically.
Install
Windows
Open the .exe installer and follow the steps, then open SMS Launcher.
Portable version: put SMS-Launcher-<version>-win-portable.exe in any folder, such as on a USB drive, and open it. Nothing is installed. The first time it runs, it creates an SMS-Launcher-Portable folder next to the .exe, and keeps everything there: settings, setup files, build tools, the game, its shader and HD texture caches, saves, and save backups. It doesn't ask where to set up. You can move or copy the .exe and that folder together, to another drive or another computer, and keep playing without setting up again. The game reads your disc whenever it runs, so keep your disc file next to the .exe or in SMS-Launcher-Portable and move it along: if the disc you chose isn't on the new computer, the launcher uses the one it finds there. Otherwise, choose your disc again under Settings. Portable versions don't update themselves. To update, download the new portable .exe and put it in place of the old one, next to the same SMS-Launcher-Portable folder. Each portable start takes a few seconds while the launcher unpacks itself.
Mac
- Double-click the
.dmg. - Drag SMS Launcher.app onto Applications in the window that opens.
- Eject the disk image, then open SMS Launcher from Applications.
Use the DMG for the usual drag-and-drop installation. If you download the ZIP instead, move the extracted app into Applications before opening it.
Linux
Download the .AppImage, allow it to run as a program in your file manager's permissions settings, then open it.
To play through Steam (on a Steam Deck, in Desktop Mode), choose the Add to Steam banner on the home screen; see Add to Steam. Launcher updates install over the AppImage in place, keeping its name and folder, so the Steam shortcut and any desktop entry keep working.
Set up your game
The launcher walks you through three steps:
- Download setup files. Use the suggested location, or choose a different folder before downloading.
- Choose disc image. Select a copy of your own original North American Super Mario Sunshine disc — GMSE01, revision 0. Supported files are
.iso(NKit.isotoo),.gcm, and Dolphin.ciso. The launcher checks the file's contents when you choose it: it names RVZ, WIA and GCZ images (convert them to a full.isofirst), archives, other regions and other games, and catches an incomplete copy before anything is built. - Begin setup. The launcher downloads HD textures and prepares your game on your computer. This first setup can take a while.
On Mac, setup may ask you to install Apple's Command Line Tools and, on Apple Silicon, Rosetta. Follow Mac setup help in the launcher.
The progress bar shows what's happening. View build log opens more detail; closing that view keeps setup running.
When setup finishes, press Play.
Play and change settings
After setup, the main screen is just Play and the Settings cog beside it. The game opens in a centered, resizable window.
Open Settings to change screen format, smoothness, resolution, and HD textures. Changes take effect the next time you start the game.
On Windows, macOS, and Linux, the defaults are 64-bit, HD textures on, 4× resolution, icons at the screen edges, and 60 fps gameplay. Existing users keep their saved settings.
Settings → Display → Frame rate offers 30 fps (GameCube native), 60 fps (default), and 120 fps (optional). The previous 60 fps switch migrates to 30 or 60 without changing your saved preference. 120 fps stays available on every display; it needs more CPU/GPU performance, and a display running at 120 Hz or faster shows its full benefit. Logos, menus, and movies stay at 30 fps.
Turn on Settings → Display → Fullscreen to have the game fill your display on its next launch. Fullscreen type chooses Borderless (the default) or Exclusive, which switches your display to the Fullscreen resolution while the game runs (for example 1920×1080 on a 4K screen). Monitor opens the game on the same monitor as the launcher or on the primary one. F11 or Alt+Enter switches full screen while playing.
The launcher also works with a game controller. Move with the left stick or d-pad and press A to select. On a list, A steps to the next choice and X steps back; on a slider, left and right change the value. Press B to go back (to Play, from any other page) and Start to open or close Settings. LB/RB move between the launcher's tabs, or between the Settings tabs on Settings, View/Select shows or hides the activity log, and the right stick scrolls. The launcher ignores the controller while the game is running and while Controls waits for a button to bind. Choosing a file or folder still opens your system's file picker, which needs a mouse or keyboard.
Settings → Display also has Aspect ratio (keep the picture's shape, stretch it, or whole multiples of the original size), Brightness, V-Sync (Off, On or Adaptive) and Performance overlay, which opens the game's frame-rate overlay at start (the backtick key toggles it in game).
Graphics preset sets them all at once, the way PC games do: Low, Medium, High or Ultra set resolution, anti-aliasing, FXAA, anisotropic filtering, sharpening, upscaler and the heat-wave effect, and Steam Deck suits the Deck's 1280×800 screen (2×, 16:10, full screen). Changing any of those yourself switches it to Custom. If the frame rate still drops, try a lower screen resolution: set Full screen type to Exclusive and choose a lower Exclusive resolution.
Settings → Display → HDR (Windows) turns on HDR output for an HDR display (turn on Windows HDR first). Use Windows HDR calibration takes peak brightness from your Windows HDR Calibration profile and paper white from Windows' SDR content brightness, and the panel shows what Windows reports for your display; turn it off to set Paper white and Peak brightness yourself. Contrast, Saturation and Highlights (how far the brightest parts climb toward the peak) shape the picture.
Settings → Graphics has Anti-aliasing (MSAA 2×, 4× or 8×), FXAA, Anisotropic filtering (2× to 16×), Sharpening, Upscaler (bilinear, sharp, nearest, FSR 1, AMD's upscaler, or NIS, NVIDIA Image Scaling: their Upscaling quality, Native, Quality, Balanced, Performance or Ultra Performance, renders at 100%, 67%, 59%, 50% or 33% of your screen's resolution and upscales the rest with clean edges, in place of Picture sharpness; both work on any graphics card) and Heat-wave effect, which turns off the wavy shimmer in hot, sunny areas. All of them are off or unchanged by default (the heat-wave effect stays on).
Settings → Gameplay → Invert camera X / Y flip the C-stick camera left/right and up/down. Both are inverted by default. Free camera keeps the camera where you point it instead of swinging back behind Mario (L recentres it). Camera speed scales how fast it turns. Mouse look turns it with the mouse (F10 releases the mouse, a click takes it back) at the chosen Mouse sensitivity.
Settings → Gameplay → Volume sets the game's master volume, from 0 to 100% (full by default). It takes effect on the next launch. Skip cutscenes there skips every movie, including the intro. Skip intro starts the game at the title screen, without the Nintendo and Dolby logos or the opening movie (A skips each of them anyway). Pause menu tracker shows an area's Shine Sprites and blue coins in the pause menu, got out of all there are, with L and R to switch areas; it is on by default (Super Mario Eclipse has its own tracker instead). Radar shows a round map at the top right while you play: the area close around Mario, north up, with an arrow for the way he faces and the area's Shine Sprites and blue coins on it. It is off by default. Auto Save saves by itself after Shine Sprites, blue coins, nozzle boxes and Yoshi instead of asking, with a Shine turning at the bottom left while it saves and the game's save sound when it's done. It is on by default. When the game can't save without asking (no save file yet, or a file saved over elsewhere), the usual prompt opens; a game over still asks. Super Mario Eclipse keeps its own Save Prompts setting.
- Manage game has game updates, rebuilding, the setup folder and disc file, the game build, and space cleanup.
- Saves backs up and restores your saved games, imports Dolphin saves, and lists your save states.
- Controls sets the keyboard keys and controller buttons for each GameCube button. Switch between Keyboard and Controller at the top; Change uses one key or button (press it, or hold two controller buttons together for a pair like L1 + R1), Add adds another, Reset goes back to the default. Controllers work without any setup. If pressing a button doesn't register (the launcher can't see some controllers the game reads, like a Switch Pro Controller), pick the button from the list in that row instead; a Switch controller's A, B, X and Y are the letters printed on it. Soft L press and Soft R press have no keys by default: bind them for a light trigger press without the click (for example, spraying FLUDD on the move), and set how far with Soft trigger depth. Rumble strength sets how hard your controller rumbles: 50% (the default) matches the console, higher runs the motor more often so light rumbles feel stronger, and 0% turns it off; the controller rumbles as you move the slider so you can feel it. Controller works in the background (off by default) keeps the game reading your controller while another window has focus, for example with the game on a second screen while you use the mouse and keyboard elsewhere; off, the game ignores input until its window has focus again. Button prompts picks the buttons the game shows in its text and on the FLUDD gauge: Original (GameCube) (the default), Xbox, PlayStation 5, Steam Deck, Nintendo Switch, PC keyboard and mouse, or Automatic, which switches between keyboard and controller as you play; with Automatic, Prompt controller can show one style on any controller (PlayStation prompts on an Xbox pad, say), and Match my controller shows Nintendo prompts for Switch controllers. Nintendo button layout is for a controller printed like Nintendo's (A on the right, B at the bottom, X on top, Y on the left) that the game reads as an Xbox pad, as many third-party ones are: with it on, each button does what its letter says, in the game and in the launcher's menus, and Match my controller shows Nintendo prompts. Switch controllers already work this way. The prompts follow your bindings, so a remapped key or button shows as you set it, and a preview shows them. On SteamOS or a Steam Deck, if buttons do two things or your controller buttons don't apply, turn off Steam Input for SMS Launcher (Steam → Properties → Controller → Disable Steam Input); the Controls tab explains this on Linux. A GameCube adapter in Wii U mode (Nintendo's official adapter, or a Mayflash or similar with its switch on Wii U) is read by the game itself and plays exactly as on a GameCube, so the controller buttons set here don't apply to it, and the launcher's menus can't be driven with it. While one is plugged in, the Controls tab says whether the game can open it. On Linux that needs a udev rule, as for Dolphin: Allow access adds it (it asks for your password), or Copy terminal command gives you the command to run yourself, for example on a Steam Deck with no password set.
- Launcher has Dark mode (dark Settings, changelog and other launcher windows), launcher updates, Discord and usage sharing, and shows your launcher, game, and setup tool versions for support.
Windows and Linux offer both 64-bit and 32-bit game builds. Keep the default 64-bit choice unless you need 32-bit. Mac game builds are 64-bit.
HD textures
HD textures are on by default for first-time setup. In Sunshine mode, this also installs all 21 enhanced cutscenes at 3× resolution, preserving their timing and original audio. Textures use about 1 GB to download and 3 GB installed; the movie patches add about 5.7 GB to download and 5.8 GB installed. Movie setup needs about 7.8 GB free, plus room for textures if needed. You can turn HD visuals off in Settings → Graphics. Existing users keep their saved choice.
If HD setup is incomplete, choose Finish HD setup to download and prepare the missing files. Previously installed textures and movies are reused. The launcher shows download progress and checks all movies before activating the pack. Failed or cancelled setup keeps the previous pack. Your original disc and saves stay intact. Eclipse keeps its own movies.
With Super Mario Eclipse on, HD textures also bring Eclipse's own: iZePlayzYT's Super Mario Eclipse HiRes Texture Pack, about 9 GB to download and 16 GB installed, downloaded before Eclipse plays. It unpacks as it downloads, so it never needs room for the zip as well; a stopped download carries on from where it stopped, and every game version shares one copy. Until it is installed, or if your drive has no room for it, Eclipse plays with Sunshine's HD textures.
Settings → Graphics → HD texture loading chooses when HD textures load:
- Before each level (default): a level's textures load while it loads, so they don't appear late while you play.
- Whole pack: the rest of the HD textures load during the first few loading screens and all of them stay loaded, so after that none load at all. This needs a graphics card with at least 6 GB of memory.
- While playing: each texture loads the first time it appears, which uses the least memory. The original texture shows until the HD one is ready.
The first time each HD texture is used, the game also builds its smaller versions for distant surfaces, in the background at low priority, and keeps them for later sessions (about 1 GB once you've seen the whole game).
Shader warm-up (on by default) builds the graphics effects each level is known to use while the level loads, instead of the first time they're drawn. Without it, the first moments in a new level stutter on the first play on each computer. Turn it off to load levels slightly faster on the first play.
Language
Settings → Gameplay → Language plays the game in English (the default), Français, Deutsch, Español, Italiano, Polski or Português (Brasil).
French, German, Spanish and Italian come from the European release: dialogue, cutscene subtitles, menus, the HUD, the title screen and the memory card screens. Polish is a community translation of the text; its menus and pictures stay in English. Brazilian Portuguese is a community translation made for Super Mario 3D All-Stars, with all of the text and the menu, pause and Yes/No pictures in Portuguese; its other pictures stay in Spanish.
Each is a small pack (about 1 MB) that the launcher downloads before the game starts. The list comes from the launcher's src/language-packs.json, so a new language needs a new pack release and a launcher update, not a game update (the game needs to be one that plays any language pack; an older one shows "Update the game to play in …").
You still use your North American disc, and your saves work in every language.
Super Mario Eclipse plays in English.
Updates
When a game update is ready, the main button becomes Update & play (or stays Play with Update automatically off). The ▾ beside it opens the other choices: Update only installs the update and stays in the launcher, and Play now starts your installed version without downloading or rebuilding. Your current game stays available until the new setup succeeds.
If optional HD downloads are unfinished, Play installed version also lets you play now using the packs already installed. Missing HD packs stay off for that launch; your visual preferences remain saved for later setup.
Launcher updates download automatically when Update automatically is enabled and install when you quit. If automatic updates aren't available for your installation, download and install the latest launcher from the releases page.
To manage updates yourself, turn off Update automatically in Settings → Launcher. Use Update game in Settings → Manage game when you're ready.
After the launcher updates, its changelog opens once to show what changed in the launcher and the game since you last opened it. Open it any time with the What's new tab.
Join the Beta
Beta has the newest launcher and the newest game before they are released. It is rebuilt whenever either changes, so you get fixes and new features sooner, but it is for testing and may break. What Beta has that no release has yet is at the top of the changelog.
- Open Settings (the cog), then the Launcher tab.
- Under Updates, set Launcher updates to Beta.
- The launcher downloads the Beta straight away. Choose Install now in the status bar, or it installs when you quit.
Once you're on Beta, new Betas arrive like any other launcher update. If Beta has a newer game than yours, the main button becomes Update & play.
To leave, set Launcher updates back to Stable: the launcher goes back to the latest release the same way. The portable Windows launcher (the win-portable.exe) never updates itself, so Settings has no Launcher updates for it. To try Beta with it, download the win-portable.exe from the [Beta release](https://gith