emufii README

The project's README from github.com/jojodogm-ctrl/emufii. As one markdown file: README.md.

Emufii

Emufii

Play your emulators online with friends, using a six-character code.
No ports to open, no IP address to share. Built for Android handhelds.

Download Version Android Games License Discord Ko-fi

What it is · How it works · Consoles · Install · Privacy


[!IMPORTANT] DS local wireless needs WatermelonDS Emufii Edition. Starting with Emufii 2.0, DS local wireless games can be played online. This only works with WatermelonDS Emufii Edition, a fork of WatermelonDS that adds the netplay this needs.

It installs next to the official WatermelonDS, so you keep your saves and settings. Once the official WatermelonDS includes the netplay, the fork won't be needed anymore. Online play through Kaeru WFC still works with any melonDS or WatermelonDS.


What Emufii is (and isn't)

Emufii is an Android app that connects your emulators to your friends' emulators over the internet. The emulators think everyone is on the same Wi-Fi, so their own local multiplayer just works.

What it does What it isn't

Connects the players. A private network between the players for the length of a session, through Android's VPN feature. Only game traffic goes through it.

Sets up the emulator. Opens it on its multiplayer screen and fills in the connection details for you.

Shows your games. The games from your own ROM folder, with covers and a compatibility badge, to start a session from.

Brings your friends. Add them with a code, see who's online and what they're playing, and join their sessions.

Not an emulator. Every game runs in the emulator you already use. Emufii doesn't run any game itself.

Not a frontend. The game library is there to start multiplayer sessions. It doesn't replace your usual launcher.

Not a downloader. Emufii doesn't include, download or install games, BIOS files, keys or emulators. You install the emulators and use your own dumps.

Not streaming. Each player runs their own copy of the game on their own device.

Not a way back to official servers. Emufii never connects to Nintendo's or Sony's servers, so games that needed them don't work online. DS games through the Kaeru WFC revival server are the exception.

How it works

1. Host

Pick a game and share the six-character code.

2. Join

Friends enter the code or pick a public session.

3. Connect

Emufii opens the emulator and fills in the address.

4. Play

Everyone plays as if on the same Wi-Fi.

Consoles

Console Emulator Multiplayer mode Version needed
Switch Eden Local wireless Any recent version
3DS Azahar Local wireless Pre-release 2126.0-rc or newer
Wii / GameCube Dolphin Netplay Android build 2606a
PSP PPSSPP Ad hoc Any recent version
PS2 ARMSX2 System Link / LAN Any recent version
DS WatermelonDS Emufii Edition Local wireless 0.8.0.rc2-emufii
DS melonDS or WatermelonDS Online via Kaeru WFC Any recent version

[!NOTE] Which games work? Games that had local multiplayer on the original console, and for the DS online mode, games that used Nintendo Wi-Fi Connection. See the full list of compatible games.

Every player needs the same emulator version and the same copy of the game.


Install

[!WARNING] Beta. Works on Android 13, 14 and 15. Expect bugs, and please report them on Discord.

  1. Install the emulators you want to use.
  2. Download the latest APK and install it.
  3. Open Emufii and follow the setup.
The autofill option is greyed out

Android blocks it for apps installed outside a store. Go to App info → ⋮ → Allow restricted settings, then turn Emufii on in Settings → Accessibility.

Updating

Download the new APK from the releases page and install it over the old one. Your settings are kept.

Checking the APK signature 
21:EF:2D:D6:11:E0:96:5A:70:8F:61:F6:00:77:DE:97:D4:0D:59:FD:56:2F:1D:C5:F6:EF:6C:87:77:5E:81:D5

apksigner verify --print-certs Emufii-2.0.apk

Privacy

What Where it goes
Session code, nickname, game On the server for the length of the session, deleted when it ends
Profile picture On the server, seen by your friends and the players in your sessions. Removing it in the app deletes it
Online status, last game Seen by anyone who has your friend code
Friend code Never shown to the other players of a session
Network traffic Only game traffic goes through Emufii's network
Games, BIOS, keys Never included. Use your own dumps

[!CAUTION] In a public session, other players' devices can reach yours, like on shared Wi-Fi. If you're playing with friends, keep the session private.


License

AGPL-3.0 (details in NOTICE.md). The app's source code is in this repository, but the session server and relay are private.

If you find a security issue, please report it privately on Discord.


How it was built

Emufii is built with Claude Code, and I'd rather tell you upfront. About 90% of the code was written with the AI, along with much of the research into how each emulator handles multiplayer.

That doesn't mean nobody is in charge. I decide the design and how the project is built and tested, I review the code that goes in, and I test every feature on real hardware before it ships.

Since then, a big part of the code has been rewritten.

If you're not comfortable with software made this way, that's completely fair. Just know that the app and the servers have had security reviews, with every issue found fixed, and that experienced developers have started contributing to the project.

If that sounds good to you, grab the latest version and come say hi on Discord!


Credits

Emulators
Eden · Azahar · Dolphin · PPSSPP · ARMSX2 · melonDS


Contributors
@sofianeelhor for the PPSSPP and ARMSX2 network automation
@BrianJr03 for the manual session setup and uncropped covers


Built with
WireGuard · Coil · Rounded M+


Also built on
WatermelonDS by SapphireRhodonite
melonDS Android by rafaelvcaetano
Kaeru WFC, the Nintendo Wi-Fi Connection revival


And everyone on the Discord who tests, reports bugs and plays.

emufii (jojodogm-ctrl/emufii)

Searching Database…

687 ·GitHub
Emufii
Что это?Emufii — приложение для Android, которое соединяет ваши эмуляторы с эмуляторами друзей через интернет, позволяя играть в локальные мультиплеерные игры онлайн по шестизначному коду — без передачи IP-адресов и открытия портов.
Emufii — это эмулятор или фронтенд?Ни то, ни другое: это коннектор на базе VPN, который поднимает частную сеть, чтобы ваши существующие эмуляторы считали, будто они в одной Wi-Fi-сети; каждая игра по-прежнему запускается в вашем эмуляторе.
Как его запустить?Установите нужные эмуляторы, скачайте последний APK со страницы релизов, установите его, затем откройте Emufii и пройдите настройку, чтобы создать сессию или присоединиться к чужой по шестизначному коду.
Какие версии эмуляторов нужны?Для каждой консоли нужен свой эмулятор, а иногда и конкретная сборка — например, Azahar pre-release 2126.0-rc или новее для 3DS и Dolphin Android build 2606a для Wii/GameCube; для локальной беспроводной игры на DS нужен форк WatermelonDS Emufii Edition вместо официального приложения.
Есть ли подводные камни при установке?Приложение в бете и проверено только на Android 13, 14 и 15; опция автозаполнения по умолчанию недоступна, потому что Android ограничивает приложения, установленные не из магазина, — придётся включить ограниченные настройки и разрешение специальных возможностей.
Работает ли это и на iOS?Нет, Emufii создан специально для Android-устройств; о версии для iOS ничего не говорится.
Какие данные Emufii видит или хранит?Сервер хранит только код сессии, ник и текущую игру на время сессии и удаляет их по её завершении; аватарка хранится, пока вы её не удалите, а через VPN-туннель идёт только игровой трафик.
Весь ли проект открыт под AGPL?Код Android-приложения распространяется по AGPL-3.0 и лежит в этом репозитории, но сервер сессий и ретранслятор, которые реально маршрутизируют трафик игроков, закрыты и работают в частном порядке у разработчика.
На каких консолях можно играть онлайн с Emufii?Сейчас поддерживаются Switch (Eden), 3DS (Azahar), Wii/GameCube (Dolphin), PSP (PPSSPP), PS2 (ARMSX2) и DS (WatermelonDS/melonDS) — игры с локальным мультиплеером или Nintendo Wi-Fi Connection.
Что такое Kaeru WFC?Это возрождённый сервер Nintendo Wi-Fi Connection, позволяющий DS-играм играть онлайн через любую сборку melonDS или WatermelonDS — единственное исключение из правила, что Emufii не трогает официальные серверы Nintendo или Sony.
Какая часть кода Emufii написана ИИ?Около 90% кода написано с Claude Code, но разработчик сам проектирует проект, просматривает каждое изменение и тестирует каждую функцию на реальном железе перед выпуском.
Безопасно ли заходить в публичные сессии к незнакомцам?Будьте осторожны: в публичной сессии устройства других игроков могут достучаться до вашего, примерно как в общей Wi-Fi-сети, поэтому разработчик советует держать сессии приватными при игре с друзьями.
What are similar projects?mlmvpn_android, OpenCE, PS5SX2, shadowsocks-android, DroidDeck, Ridge-Racer-Collection, GameNative, OpenRCT2
Which topics is it in?multiplayer, wireguard, emulation, vibe-coding, retrogaming, discord, android-app, vpn, game, kotlin, gaming, agpl
Creator
jojodogm-ctrl
Size
7.1 MB
Stars
687
Updated
CommitOct 09Releasev2.0.3Oct 08
Age
1mo
Commits · 90 Days