Homebrew Channel: Difference between revisions

no edit summary
(→‎Version Compatibility: Please only list revisions only where a compatibility change occurred.)
No edit summary
 
(69 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{Infobox VG
{{Infobox VG
|image    = [[File:Homebrew_Channel.png|350px]]
|channeltype = Downloadable (third party)
|developer = Team Twiizers
|developer = Team Twiizers
|channeltype = Downloadable (third party)
|released  = {{vgrelease|JP/NA/EU/KO|April 2, 2008}}{{vgrelease|TW|July 2, 2008}}
|image = [[File:Homebrew_Channel.png|300px]]
|genre    = Utility
|input    = Wii Remote, Wii Remote + Nunchuk, Classic Controller, GameCube Controller, Guitar Controller
|forumlink = https://forums.dolphin-emu.org/Thread-wii-channel-homebrew-channel
}}
}}


This channel allows users to install or launch homebrew, or third-party applications, from a variety of media without having to run an exploit every time. Ideally the functionality of this channel, inside Dolphin, would allow the install or launch of any homebrew or third-party application without the "IOCTL_ES_LAUNCH: Game tried to reload ios or a title that is not available in your nand dump TitleID xxxxxxxxxxxxxxxx. Dolphin will likely hang now." or "Unknown pointer 0x83e10000 Continue?" errors appearing.
The '''''Homebrew Channel''''' is a freeware homebrew application loader that was developed to provide a way of easily running unofficial software on the [[Wii]] console. Once installed, it appears as a standard [[Wii Channels|Wii Channel]] on the [[Wii Menu]]. When launched, it displays a list of applications found on an SD card or USB drive. The user then selects an application to launch by using a Wii Remote or GameCube controller. It also accepts application uploads via a USB Gecko or TCP/IP (over Wi-Fi or Ethernet), which allows for quick application testing during development. When launched from the Wii Menu, the Homebrew Channel will check for updates to itself and automatically download them if the user chooses to do so.
 
The functionality provided by the Homebrew Channel is provided by Dolphin directly, so the HBC is not needed (except to work around Dolphin's broken Wii homebrew detection in some cases; and a very few homebrew apps that cannot be run directly from Dolphin's game list, including the [[Priiloader]] installer).
 
== Emulation Information ==
{{Problems/SD Adapter|use=store applications to launch}} The Homebrew Channel also supports the Wii SD slot, which is properly emulated.
 
{{Problems/Missing USB Storage Support}}
 
===Problems with TCP upload to Homebrew Channel===
As of {{revision|5.0-21088}}, trying to send .dol files to Homebrew Channel, presumably to Homebrew Channel's default TCP port 4299, won't work. ''WiiTCPLoad'' 0.05 claims "The remote host ''(i.e. Dolphin)'' closed the connection"; and while it will report a successful transfer if the transfer happens while Homebrew Channel is in its main menu, it won't show up when returning to Homebrew Channel's app menu.
 
A possible factor is that Homebrew Channel may not have expected to receive TCP transfers from the same IP as itself, but information on this is very scarce.


== Problems ==
== Problems ==
As of {{revision|3.0-376}}, the Homebrew Channel starts without error. Any previous revision or release version may cause Dolphin to crash or hang up randomly.
{{Problems|{{#vardefineecho:problems|
=== Pre-1.1.3 Black Screen ===
The developers of the Homebrew Channel have [https://forums.dolphin-emu.org/Thread-homebrew-channel-installation?pid=310212#pid310212 placed traps into the program] to prevent the Homebrew Channel from loading in Dolphin. There are other problems in pre-1.1.3 versions, which won't be documented here. The 1.1.3 release of the Homebrew Channel, which is now open source, has removed the anti-Dolphin code.


As of {{revision|3.0-376}}, starting the Homebrew Channel, then reloading through the Home button may cause Dolphin to hang up randomly.  
=== <s>Networking</s> ===
Network initialization never completes. Fixed since at least {{revision|5.0-10472}}.


As of {{revision|3.0-376}}, starting the Homebrew Channel, then exiting through the Home button causes Dolphin to crash without showing panic handlers. Any previous revision or release version will see the following error: "Unknown pointer 0x83e10000 Continue?" Saying yes or no causes Dolphin to crash.
=== <s>Direct3D</s> ===
Using Direct3D with XFB enabled will cause the screen go black, but the app stills work normally otherwise. Use OpenGL to solve this. Fixed since at least {{revision|5.0-10472}}.
 
}}}}


== Configuration ==
== Configuration ==
<!--A full list of options is available at Template:Config/doc-->
{{Config
{{Config
|type = channel
 
}}
}}


== Version Compatibility ==
== Version Compatibility ==
{{VersionCompatibility}}
{{VersionCompatibility}}
<!--Use this template for compatibility entries: {{VersionCompatibilityVersion|revision|****}}-->
<!--Use this template for compatibility entries: {{VersionCompatibilityVersion|revision|****|notes}}-->
<!--Replace 'revision' with an SVN revision number (like 6789), a Dolphin release (like 3.0), or a git revision number (like 3.0-50)-->
{{VersionCompatibilityVersion|7598|*|}}
{{VersionCompatibilityVersion|7598|***}}
{{VersionCompatibilityVersion|5.0-1399|****|Marcan's fixes to IOS and IPC HLE}}
{{VersionCompatibilityVersion|5.0-5874|****|XFB tweaks should no longer be needed to launch apps}}
{{VersionCompatibilityVersion|5.0-10472|*****|No issues}}
{{VersionCompatibilityClose}}
{{VersionCompatibilityClose}}


== Testing ==
== Testing ==
{{testing/start|type=channel}}
{{testing/start}}
<!--Use this template for test entries: {{testing/entry|revision=|OS=|CPU=|GPU=|result=|tester=}}-->
<!--Use this template for test entries: {{testing/entry|revision=|OS=|CPU=|GPU=|result=|tester=}}-->
{{testing/entry|revision=7598|OS=Windows 7 x64|CPU=Intel Quad Core Xeon @ 2.8GHz|GPU=ATI Radeon HD 5770|result=All issues in the Problems section are present.|tester=SephirothFanatic}}
{{testing/entry|revision=7598|OS=Windows 7|CPU=Intel Quad Core Xeon @ 2.8 GHz|GPU=ATI Radeon HD 5770|result=All issues in the Problems section are present.|tester=SephirothFanatic}}
{{testing/entry|revision=3.0|OS=Windows 7 x64|CPU=Intel Quad Core Xeon @ 2.8GHz|GPU=ATI Radeon HD 5770|result=All issues in the Problems section are present.|tester=SephirothFanatic}}
{{testing/entry|revision=3.0|OS=Windows 7|CPU=Intel Quad Core Xeon @ 2.8 GHz|GPU=ATI Radeon HD 5770|result=All issues in the Problems section are present.|tester=SephirothFanatic}}
{{testing/entry|revision=3.0-376|OS=Windows 7 x64|CPU=Intel Quad Core Xeon @ 2.8GHz|GPU=ATI Radeon HD 5770|result=Starts and runs normally, except when reloading or exiting with the Home button.|tester=SephirothFanatic}}
{{testing/entry|revision=3.0-376|OS=Windows 7|CPU=Intel Quad Core Xeon @ 2.8 GHz|GPU=ATI Radeon HD 5770|result=Starts and runs normally, except when reloading or exiting with the Home button.|tester=SephirothFanatic}}
{{testing/entry|revision=5.0-1422|OS=Linux (Debian sid)|CPU=Intel Core i5-4210H @ 3.5 GHz|GPU=NVIDIA GeForce GT 940|result=Everything works (including launching homebrew, returning to Wii menu, shutting down) except networking.|tester=Léo}}
{{testing/entry|revision=5.0-2742|OS=Windows 7|CPU=Intel Celeron G1610 @ 2.6 GHz|GPU=Intel HD Graphics|result=With D3D and XFB disabled looks normal but cannot launch homebrew; enabling XFB to real made it look black, but didn't crash. Using OGL and XFB to real seems to work normally, except for network.|tester=EblfIYH}}
{{testing/entry|revision=5.0-3951|OS=Windows 10|CPU=Intel Celeron G1610 @ 2.6 GHz|GPU=Intel HD Graphics|result=Now, it crashes with D3D. OpenGL still work|tester=EblfIYH}}
{{testing/entry|revision=5.0-3965|OS=Windows 10|CPU=Intel Celeron G1610 @ 2.6 GHz|GPU=Intel HD Graphics|result=D3D works again, with the same problems|tester=EblfIYH}}
{{testing/entry|revision=5.0-10472|OS=Windows 10|CPU=Intel Core i5-4670K @ 4.3 GHz|GPU=NVIDIA GeForce GTX 1060|result=D3D issues seems to be fixed, couldn't reproduce it with D3D11/12. Works without any graphical issues. Difference between graphics backends is huge though. D3D12=1000FPS, D3D11=900FPS, OpenGL=600FPS, Vulkan=500FPS|tester=Miksel12}}
{{testing/entry|revision=5.0-21088|OS=Windows 11|CPU=AMD Ryzen 5 3600 @ 3.6 GHz|GPU=NVIDIA GeForce RTX 3060|result=Was only able to get the emulated SD card to work, and even then with my focus only being on the ImDisk method, which wasn't exactly easy to figure out either.|tester=DandelionSprout}}
{{testing/end}}
{{testing/end}}


== Gameplay Videos ==
== Gameplay Videos ==
<!--A full list of options is available at Template:VideoGallery/doc-->
{{VideoGallery
|vid1=QLycpVxtsCg|cap1=Homebrew Channel Showcase
}}


[[Category:Wii Channels]]
[[Category:Wii Channels]]