TomodachiLife Recomp

Tomodachi Life: Living the Dream, native PC port

A static recompilation of Tomodachi Life: Living the Dream (Nintendo Switch) into a native Windows program. The game's own code is translated to C and compiled for your PC: no emulator runs underneath.

Version 1.0.0. You can play it from start to finish as far as we know; see Known issues for what is still open.

Nothing of the game is in this repository or in the release downloads. You build it on your own PC from your own copy of the game, dumped from your own Switch, with your own console keys. Not affiliated with or endorsed by Nintendo.

Game 1.0.4, rendered at 4K in widescreen, shown at 1080p.

What you need

• Windows 10 or 11, 64-bit; about 15 GB free on the drive you install to; 8 GB of RAM or more (16 GB recommended).
• A GPU with OpenGL 4.5. Developed and tested on NVIDIA (RTX 3060); AMD and Intel GPUs run it but are less tested.
• Your game files, dumped from your Switch:
  • the base game (.nsp, .nsz or .xci; title id 010051F0207B2000), and optionally
  • the update 1.0.4 (.nsp or .nsz; 010051F0207B2800, version v262144). Without it you get version 1.0.0.
• Your console's prod.keys (dumped with Lockpick_RCM). The installer finds it in %USERPROFILE%\.switch or in an emulator's key folder; key values are never copied or shown.

Both 1.0.0 and 1.0.4 run. Other updates are not supported yet.

Install

1. Download Tomodachi-Life-PC-Setup.exe from the newest release and run it. Windows may say it protected your PC (the setup is not signed): click More info, then Run anyway.
2. Choose where it goes (C:\Games\TomodachiLife by default; about 15 GB). The launcher opens.
3. It finds your game files and keys by itself (Downloads, Desktop, Documents and emulator folders). Choose anything it missed, then press INSTALL. A dump you already made (a folder with exefs\ and romfs\ inside) works too: OR A DUMP FOLDER; no keys are needed then.
4. Wait. The first install takes about 40 minutes on a recent PC (an hour or more on older ones): it translates the game's code and compiles it (about 25 minutes), then compiles every shader for your graphics card (about 13 minutes). You can stop it, or close the launcher, and go on later: finished steps are not repeated.
5. Press PLAY. Next time, start it with the Tomodachi Life shortcut on your desktop.

The same files as a zip, for those who prefer it: Tomodachi-Life-PC.zip (unpack it into a folder of its own and run build\work\TomodachiLauncher.exe, or Install Tomodachi Life.bat for the older installer window). A zip named tomodachi-runtime-... is not the game: it is a part the installer downloads by itself.

The installer downloads only what it needs, each file checked against a fixed SHA-256: Python 3.13 (python.org), LLVM/clang 9 (the official build, repackaged as a zip), the prebuilt runtime of this release (our own code only), libopus and FFmpeg.

The shaders are ready when the installer finishes, so the game starts in seconds. After a graphics driver update, or when you change the widescreen or resolution-scale setting, the game prepares them once more at its start: the loading screen then shows "preparing shaders (once)" with a count, the time spent and the time left.

The launcher

• PLAY starts the game.
• GAME shows the game version (1.0.0 or 1.0.4) and lets you choose another game folder.
• SETTINGS: window or full screen, resolution (up to 4K and above), widescreen (Off, 16:9, by default; Fit the screen for ultrawide monitors up to 21:9: the 3D view widens, menus keep their 16:9 shape in the middle), frame rate (60 fps by default), vsync, volume, language, Local Play online (saved in build\config\graphics.ini).
• SAVE DATA: back up and restore your save, or import a save dumped from your Switch (the folder with Map.sav, Mii.sav, Player.sav and the Ugc folder of your drawings).
• CONTROLS: the controller it sees and the keyboard keys (build\config\controllers.ini).

In the game, PC Settings opens with F1, the controller's HOME / Guide button, or by holding - and + together for a second (Steam Deck): screen, window size, resolution, widescreen, frame rate, vsync, volume, language and Quit to desktop, on a page in the game's own style and with its own fonts. Played like the game's menus (d-pad or arrow keys, A / Enter, B / Esc); the mouse works too. Fast-forward: hold Tab, or both stick buttons of a controller; the speed (2x, 3x, 4x) is on that page.

Your save lives in build\userdata (or the install location you chose). Playing 1.0.4 upgrades a 1.0.0 save; 1.0.0 cannot read it afterwards. Back it up first (SAVE DATA) if you may go back.

After importing a save, the game may say your system time has changed and ask whether to start with the current time setting: choose Start. (Don't Start asks you to change the console's clock in the HOME Menu, which a PC does not have: close the game and start it again.)

Controls

The game is played as on a docked Switch.

Switch	Controller	Keyboard
A (confirm)	A; PlayStation: cross (the game then shows the PlayStation symbols)	Enter or Space
B (back)	B; PlayStation: circle	Esc, Backspace or B
X (menu) / Y (residents)	X / Y; PlayStation: square / triangle	X or M / Y or R
L / R, ZL / ZR	shoulders, triggers	Q / E, Z / C
+ / -	Start / Back	= / - (or the number pad's + / -)
Left stick (the hand)	left stick	W A S D or the arrow keys
Right stick (camera)	right stick	J / I / L / K
D-pad	D-pad	number pad 4 / 8 / 6 / 2

Keys move the hand like a stick: a tap nudges it (half speed for the first 0.3 s, for small targets), a held key crosses the screen, and diagonals are no faster than straight moves.

Mouse (off by default; PC Settings, Mouse controls): the hand follows the mouse. Left click = A, right click = B. On the island, drag with the left button to move around (the ground stays under the cursor), click a place to bring it to the middle (the game names what is there), click the hand or that name to go in, hold the button on a Mii to grab them (then point where to carry them and click to put them down), turn the view by dragging with the middle button, and zoom with the wheel. In menus and dialogs (the X menu, Settings, questions) pointing at a button selects it, a click presses it (a click beside the buttons does nothing) and the wheel moves the selection. Anywhere, a click on a button prompt shown on screen ("+ Buy", "L More info", the island's menu and residents icons, the B back arrow) presses that button. On the Palette House canvas the pen follows the mouse's moves and draws while the left button is held. On the keyboard for names and words, pointing selects a key, a left click types it and a right click deletes. Keys and buttons can be changed in the game: PC Settings, Controls (pick the controller with left / right, choose a button, press the new one; it holds for every controller of that kind), or in build\config\controllers.ini, where a button can have up to three keys (A = ENTER, SPACE). A keyboard section still holding the old default keys (Z / X / C / V) is moved to the keys above by itself; one you changed is kept.

Mods

Put each mod in its own folder in build\mods (made at the first start). Mods made for emulators or a modded Switch (LayeredFS) work as they are: the game uses the first romfs folder inside each mod, for example build\mods\MyMod\romfs\... or build\mods\MyMod\atmosphere\contents\010051F0207B2000\romfs\.... When two mods change the same file, the one whose folder name comes first wins. To turn a mod off, move its folder out. exefs code patches cannot work here: the game's code is translated ahead of time.

Local Play (Mii exchange)

The game shares Miis through Local Play. Here Local Play runs over the network: in the launcher's SETTINGS, LOCAL PLAY ONLINE = Same network for PCs at home, or Host (your game shows a room code in its title and copies it) and Join (paste your friend's code) over the internet. It is off by default.

Known issues

• Very large islands (30+ residents) run slowly on some PCs; we are working on it (issues #7, #18).
• Now and then a Mii's line shows without its voice (seen once in Mii News); the session log now records every line and voice, so please send build\work\play_*.log with the time it happened.
• Some sounds are louder or carry farther than on the Switch: shop and ride music without its fade in and out, street lamps heard from far away (issue #8).
• Once, a freeze in the controller input was seen and not reproduced since. If the game stops responding, close it and send build\work\play_*.log of that session.
• Local Play over the internet worked on a simulated link (lag and lost packets) but not yet between two real home routers; some routers will need UPnP on. Sending a Mii works; exchanging creations is not tested yet.
• The launcher shows a plain background (the island picture of the dev builds is game art and is not shipped).
• Windows only for now.

When something goes wrong, the logs are in build\logs (install) and build\work\play_*.log (each game session). Flicker: press F12 while it happens. The game saves the next 8 pictures in build\work\flicker and describes the frames after them in the session log (the game pauses a few seconds for that); send both.

Building by hand

python scripts/setup.py --dump <folder with exefs\ and romfs\> builds everything from a dump folder, with LLVM/clang 9 and either the prebuilt runtime (--runtime <zip>) or the MSVC Build Tools; python scripts/setup.py --help lists the steps and options. tools/extract/dump_folder.py <base> [<update>] <folder> makes that folder from your packages. How the port works and what was done: docs/DEVELOPMENT.md.

Credits and licence

Built on the runtime and tools of ssbu-recomp. GPL-3.0 (see LICENSE). Third-party code: SDL 3 (zlib), Dear ImGui (MIT), stb (MIT / public domain), libopus (BSD), FFmpeg (LGPL, downloaded by the installer), the open-source fonts in runtime/fonts_open (see the README there). The launcher's Mii import (launcher/mii_ltd.h) is a port of the .ltd import of ShareMii by Star-F0rce (GPL-3.0). Tomodachi Life is a trademark of Nintendo. This project contains no Nintendo code or assets.