4.0.0b8

This is the fourth revision of beta 8.

Changes

• The Dolphin core has been updated to 2412.
  • Save states made in previous beta versions are not compatible. GameCube memory cards and Wii in-game save files are not affected.
• Added new app icons based off the macOS icon introduced in Dolphin 2407. (thanks Kongolabongo and @brand175 for the new iOS icons, and thanks MayImilae for the original macOS icon)
• No JIT mode (very slow) has been added. (thanks @brand175)
  • When launching a game without JIT enabled, you can now choose to start it in No JIT mode.
  • The "waiting for JIT" screen can be bypassed entirely by manually changing the CPU Emulation Engine in Settings -> Config -> Advanced to Cached Interpreter.
  • No JIT mode is very slow. You will need a high-end device (like a recent iPhone or iPad Pro) and to enable speed hacks (VBI Skip, CPU underclock, etc) to achieve playable speeds.
• Added a button to import BootMii NAND backups in the software list.
  • This is useful for those who want to play Wiimmfi online.
  • No JIT users beware: Wiimmfi will ban devices that run below 100% emulation speed in Mario Kart Wii. We recommend that Wiimmfi should only be used in JIT mode.
• Added experimental support for rootless jailbreaks.
• Added a menu to check which buttons are being pressed on physical controllers when mapping buttons.
• Ported "Respect Silent Mode" toggle from Delta.
  • This setting controls whether DolphiniOS obeys the Ring/Silent switch on your device. If disabled, then audio will play even if silent mode is enabled.
  • Find it in Settings -> Config -> Audio.
• Added Game Mode for devices running iOS 18.
• Re-implemented the touch screen Wii pointer.
  • A new default mode has been added: "drag". This mode allows you to use your touch screen like a laptop trackpad when moving the Wii pointer.
  • The mode used in 3.2.1 and earlier is still available as "follow" mode.
  • Choose the mode you want as default in the top bar menu during emulation or in Settings -> Controllers -> Touchscreen.
• Re-implemented automatic disc changing.
  • When a game asks for a different disc, DolphiniOS will automatically insert the correct disc into the emulated disc drive.
  • Both disc files must be imported (i.e. in the Software folder and visible in the software list) for this feature to work properly.
  • If it still does not work, ensure that "Change Disc Automatically" is enabled in Settings -> Config -> General.
• Re-implemented the touch screen transparency level slider.
• Re-implemented support for multiple save state slots.
• Re-implemented the Open button in the software list.
• Re-implemented the Delete button in the software list.
• Re-implemented the Launch GameCube Main Menu button in the software list.
• Matched the refresh rate of the MTKView to the display's refresh rate.
  • GameCube and Wii games do not run above 30/60Hz.
  • This is only for testing purposes.
• Fixed many crashes, freezes, physics bugs, etc when using Cached Interpreter.
  • The fix for this bug (disabling "fast math" mode in Xcode) will likely result in a slight performance decrease.
  • While fast math does make math calculations run faster, it also causes some calculations to return incorrect answers.
  • Accuracy is vital when emulating software. When fast math returns a wrong answer for a calculation, it can cause crashing and other bugs in the emulated software, as they always expect to receive correct answers.
  • For example, the Wii's System Menu immediately crashes when using Cached Interpreter in previous 4.0.0 beta builds, as the math used to calculate whether the pointer is hovering over a channel or not returns incorrect results. Disabling fast math fixes this issue.
• Fixed an issue where the bottom of the "waiting for JIT" screen was cut off on some devices. (thanks @brand175)
• Fixed an issue where booting Wii software during the first launch of the app could cause DolphiniOS to crash.
• Fixed an issue where the state of the "Enabled" switch in the menu shown when mapping controller buttons does not save properly.
• Fixed an issue where the toggle for VBI Skip in Settings was still using its old name, VI Skip.
• Fixed an issue where the top bar could get dismissed while using the menu.
  • This was fixed by removing the code which dismissed the top bar after 5 seconds.
  • You now need to manually dismiss the top bar by pressing the "eye with a slash through it" icon.
  • Unfortunately, there is no way to check to see if the menu is open, so this was the best solution I could come up with.
• Fixed an issue where the software list was not refreshed when importing new software.
• Fixed an issue where device motion did not apply to the Nunchuk.
  • Users who are updating from an older beta version will need to re-import the Touchscreen default profile in Controllers to apply this bug fix.
• Hid some options in the debug menu when DolphiniOS is built in release mode.
• Updated MoltenVK to 1.2.8.
  • The latest version of MoltenVK is incompatible with Dolphin due to a bug.

Revisions

• Revision 2 was released shortly after the initial revision was published.
  • Fixed a problem with the build creation process which caused builds to not show up on GitHub.
• Revision 3 was released on Jan 17.
  • Fixed a problem with the app icon not showing up on SpringBoard.
  • Fixed a problem where the version number was not updated to beta 8.
  • Fixed a problem where using Vulkan would cause colours to appear oversaturated until the app was restarted. (thanks @brand175)
• Revision 4 was released shortly after Revision 3.
  • Fixed a problem where the touch screen controller button images were not included in the app.

Full Changelog: v4.0.0b7...v4.0.0b8

4.0.0b7

The full changelog can be found here: v4.0.0b6...v4.0.0b7.

This version fixes several critical bugs found in 4.0.0b6.

Enabling JIT is still required on non-jailbroken devices. However, Apple made changes in iOS 17 which broke all JIT enablers. Please be aware that, as of the time of writing, all JIT enablers that support iOS 17 require a Mac.

We are currently monitoring the situation with sideloading in Europe. We will have more to share once Apple and/or the European Commission releases information about how it will be implemented.

User-Facing Changes

• Worked around an issue which causes fastmem initialization to fail (#115).
• Fixed an issue which causes the app to freeze and/or crash when changing graphics settings.

Developer-Facing Changes

• The UI thread is now the host thread while emulation is not running. When emulation is running, the host thread is whatever thread is executing for the host queue.
• Calling DOLHostQueueRunSync on the host thread is now possible.
• Calling DOLHostQueueRunAsync while on the host thread is now an illegal operation.

4.0.0b6

DO NOT USE THIS VERSION! USE 4.0.0b7 INSTEAD!

---

The full changelog can be found at v4.0.0b5...v4.0.0b6.

Enabling JIT is still required on non-jailbroken devices. However, Apple made changes in iOS 17 which broke all JIT enablers. Please be aware that, as of the time of writing, all JIT enablers that support iOS 17 require a Mac.

We are currently monitoring the situation with sideloading in Europe. We will have more to share once Apple and/or the European Commission releases information about how it will be implemented.

User-Facing Changes

• Updated the Dolphin core to 5.0-19708.
• Added the Software Properties menu (tap and hold on a game in the game list).
• Added the Gecko and Action Replay cheats menus in Software Properties.
• Improved the updater to not prompt for an update if the currently running version is newer than the one reported by the server.

Developer-Facing Changes

• Fixed an issue where using shared zstd would cause a build error on recent Xcode versions. (potentially issue #109)
• Made the host thread be dynamically set to whatever thread is currently executing for a special dispatch queue.
• Disabled the JitCache fast block map optimization to prevent fastmem issues.

4.0.0b5

The full changelog can be found at v4.0.0b4...v4.0.0b5.

NOTE: If you are upgrading from the TrollStore build of 4.0.0b2, your save files, settings, and imported games will appear to have been deleted. Due to a bug, DolphiniOS was putting the data in the wrong folder. If you want to recover your data, move the contents of the folder /private/var/mobile/Documents/DolphiniOS to the folder listed in Settings -> Debug -> Environment -> User Folder.

User-Facing Changes

• The status bar is now hidden during emulation. (issue #54, PR #58 by @icelaglace)
• Removed the Software Renderer from the list of available graphics backends.
  • This backend never worked in the first place because OpenGL is not supported.
• Fixed a bug which could cause the app to crash when attempting to clear the screen while stopping emulation. (issue #56)
• Fixed a bug which caused the graphics backend menu to not set the correct backend. (issue #57)

4.0.0b4

The full changelog can be found at v4.0.0b3...v4.0.0b4.

NOTE: If you are upgrading from the TrollStore build of 4.0.0b2, your save files, settings, and imported games will appear to have been deleted. Due to a bug, DolphiniOS was putting the data in the wrong folder. If you want to recover your data, move the contents of the folder /private/var/mobile/Documents/DolphiniOS to the folder listed in Settings -> Debug -> Environment -> User Folder.

User-Facing Changes

• Removed OpenGL ES from the list of available video backends.
• Removed cubeb from the list of available audio backends.
• Added the ability for DolphiniOS to shutdown the Dolphin core if the app is being terminated.
• Fixed a bug where the video output would not extend past the area where the home indicator is on devices without a home button.
• Fixed a bug where "Extensions" in Wii Remote configuration would show as a regular ControlGroup editing view controller on release builds instead of an extension editor.

Developer Changes

• Replaced a call to [UIDocumentPickerViewController initWithDocumentTypes:inMode:], which was deprecated in iOS 14.
  • The app now links with UniformTypeIdentifiers.framework to be able to use UTTypes.

4.0.0b3

The full changelog can be found at v4.0.0b2...v4.0.0b3.

NOTE: If you are upgrading from the TrollStore build of 4.0.0b2, your save files, settings, and imported games will appear to have been deleted. Due to a bug, DolphiniOS was putting the data in the wrong folder. If you want to recover your data, move the contents of the folder /private/var/mobile/Documents/DolphiniOS to the folder listed in Settings -> Debug -> Environment -> User Folder.

User-Facing Changes

• Added new performance statistics options from the latest official Dolphin builds (courtesy of samb).
  • If you are looking for the "Show FPS" option, it has now been moved to the "Advanced" menu.
• Added new texture filtering options from the latest Dolphin builds (#41).
• Added a prompt for importing the default profile when changing the default device for a controller.
• Added an About screen.
• Added settings for fastmem (#29) and Sync on Idle Skip to the Debug menu.
• The home indicator on devices without a home button is now hidden during emulation (#39).
• A device refresh is now automatically requested when entering the Devices menu while configuring a controller.
• Fixed a bug where TrollStore builds would use the user folder intended for builds installed via Sileo / Cydia / etc.
• Fixed a bug where builds installed via Sileo / Cydia / etc. crashed on launch.
• Fixed a bug where the gyroscope and accelerometer on physical controllers was inverted.
• Fixed a bug where closing the app and reopening it after manually pausing emulation would unpause emulation automatically.
• Fixed a bug where gcm, tgc, and gcz files were not detected as valid disc images.

Developer Changes

• Fix bartycrouch not being detected on Apple silicon computers when installed via Homebrew (#36).

4.0.0b2

• Updated Dolphin core version to 5.0-18273.
• Added option for VI Skip to Settings -> Graphics -> Hacks.
• Fixed the app container not being created on TrollStore builds (#21 - thanks opa331).
• Fixed the CPU clock override text not updating correctly (#22).
• Added mitigations against crashes in JITMemoryTracker (#33).
• Added mitigations against crashes when stopping emulation (#32).

4.0.0b1

Pre-beta for Discord.