Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

ChirunoMod 3DS

From GameBrew
Revision as of 12:40, 8 September 2023 by HydeWing (talk | contribs)
ChirunoMod
3dspc.png
General
AuthorChainSwordCS
Type3DS Streaming
Version0.2.1
LicenseGPL-3.0
Last Updated2023/08/24
Links
Download
Website
Source

ChirunoMod is a continuation of HzMod, built for Chokistream.

A utility background process for the Nintendo 3DS, purpose-built for screen-streaming over WiFi.

Current features

  • Screen streaming from 3DS to PC using the Chokistream client.

Getting started

Get the latest stable release of Chokistream 3DS to run on PC.

On 3DS, use FBI to install the .cia files...

Install ChLoad.cia which is the loader. If you are using an Old-3DS (not a "New" 3DS/XL or "New" 2DS XL) and you're going to play games which use the High Memory Mode (Super Smash Bros, etc.) then also install ChLoad_HIMEM.cia.

For the main ChirunoMod application, you have a few options:

  • The latest Stable release is strongly recommended, and specifically ChirunoMod.cia.
  • There are two alternate cias:
    • ChirunoMod_nodebug.cia omits all debug logging for a tiny performance boost and slightly smaller size. This isn't recommended because the performance improvement is basically unnoticeable.
    • ChirunoMod_verbosedebug.cia has much more debug logging and records frame-time statistics in the PC-side log, but it generally runs a bit slower.
  • Nightly builds can be found in the root directory of this repository, namely ChirunoMod.cia. Nightly builds are usually less stable, and may not function as intended. Note: for the most part, only ChirunoMod.cia is compiled on a regular basis.

Please note, the PC HorizonScreen application in this repository is old and obsolete. Additionally, all release versions of ChirunoMod are strictly incompatible with HorizonScreen.

Changelog

v0.2.1

  • Fixed support for a few games which were broken previously.
    • This includes: Mario Kart 7, Animal Crossing: New Leaf, Luigi's Mansion: Dark Moon, Mario & Luigi: Dream Team, Mario & Luigi: Paper Jam, Nintendogs + Cats, Angry Birds Trilogy, and more.
  • Fixed colors of RGB565 games in TGA mode.
  • Fixed behavior for when both screens are requested in Interlaced mode.
  • Fixed some situations where screen format was outdated. Note: Issues related to incorrect or outdated screen information can still occur, but they should be less common.

v0.2

  • Fixes:
    • Old-3DS now works correctly! Note: you may have to download the latest release (or Nightly) of Chokistream to use this feature.
    • Fixed the banner sound-effect. Please delete and reinstall the ChLoad CIA(s) for the change to take effect.
  • Known Bugs:
    • On o3DS, when launching an application from Home Menu, sometimes it will fail and lock-up the system. The current known cause is because ChirunoMod is using too much CPU in the background (or something like that). A workaround that seems to work is to pause streaming before launching an application, and resume streaming after the 'Nintendo 3DS' bootlogo finishes. A proper fix is in the works.
    • Mario Kart 7 is still broken (and a small handful of other games with the same issue).

v0.1

  • Release Notes:
    • Unlike HzMod, requires the new PC client "Chokistream".
    • Has a different set of TitleIDs, so as not to conflict with any previous HzMod installation on 3DS.
  • Instructions:
    • Download the "ChirunoMod" .cia file or one of its two variants. That's the back-end. It doesn't matter which, but the Standard is recommended. "verbosedebug" is for real-time statistic logging to PC, and "nodebug" disables all debug output for a very small performance boost.
    • Then download "ChLoad.cia", that's the loader and the icon that appears on the Home Menu.
    • "ChLoad_HIMEM.cia" is only for Old-3DS, for using ChirunoMod while playing a game that requires extended-memory mode (such as Super Smash Bros.)
  • Changes:
    • Lots of code restructuring and reorganization.
    • Proper, near-complete basic support for all color modes (namely the problematic 16BPP ones). (Colors are finally accurate for Virtual Console games!)
    • Screen choice: top only, bottom only, or both.
    • New experimental option: interlaced video (not perfect; not recommended for basic users).
  • Known Bugs
    • Old-3DS screen streaming doesn't yet work properly (Chokistream needs to be updated to support it).
    • Mario Kart 7 and a few other games may appear broken. The cause of the bug has not been precisely pinpointed, a manual hotfix is in the works.

v0.pre_beta2

  • Added new error pattern to README

v0.pre_beta2

  • HorizonScreen stability update and added font renderer

v0.pre_beta1

  • Originally released by Sono 2017-05-02.

Credits

  • ChirunoMod Credits
    • ChainSwordCS - C/C++ programming, code comments, logo design.
    • Eiim - Assistance with code logic and commenting, assistance with logo design.
    • herronjo - Assistance with code logic and commenting.
    • savvychipmunk57 - Assistance with code logic and commenting.
    • bol0gna - Assistance with code logic and commenting.
  • Chokistream Credits (Indirect help with this project)
    • Eiim - Documentation and reverse-engineering of HzMod, development of Chokistream
    • herronjo - Documentation and reverse-engineering of HzMod, development of Chokistream
    • ChainSwordCS - Documentation and reverse-engineering of HzMod, development of Chokistream
  • Original Code
    • Sono - for creating the HzMod project and the code from which ChirunoMod was forked.
    • Additional credits for original HorizonM / HzMod
      • Minnow - figuring out how Base processes can be used
      • ihaveamac - pointing me towards the right direction for fixing memory allocation on new3DS and getting HorizonScreen to compile on macOS
      • Stary - help with WinSockets in HorizonScreen
      • flamerds - betatesting
      • 916253 - betatesting
      • NekoWasHere @ Reddit - betatesting
      • JayLine_ @ Reddit - betatesting
  • ChirunoMod Logo assets
    • Cell9 - NTR rocket graphic
    • Mister Man (The Spriters Resource) - Mario sprites from Super Mario World
    • WordedPuppet (The Spriters Resource) - Cirno sprites from "Touhou Kaeizuka (Phantasmagoria of Flower View)"
    • gabrielwoj (The Spriters Resource) - Projectile sprites from "Touhou Koumakyou (The Embodiment of Scarlet Devil)"
    • Saigyou R. (The Spriters Resource) - Stage backgrounds from "Touhou Fuujinroku (Mountain of Faith)" (IIRC the Final Stage background with the moon was used)
    • Ryan914 and MaidenTREE (The Spriters Resource) - Extra Stage background from "Touhou Gensoukyou (Lotus Land Story)" (Pixel stars were used)

External links

Advertising: