Homebrew Channel: Difference between revisions

no edit summary
No edit summary
No edit summary
 
(57 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{Infobox VG
{{Infobox VG
|image       = [[File:Homebrew_Channel.png|300px]]
|image     = [[File:Homebrew_Channel.png|350px]]
|developer  = Team Twiizers
|genre = Utility
|channeltype = Downloadable (third party)
|channeltype = Downloadable (third party)
|input = Wii Remote, GameCube Controller
|developer = Team Twiizers
|forumlink   = http://forums.dolphin-emu.org/Thread-wii-channel-homebrew-channel
|released  = {{vgrelease|JP/NA/EU/KO|April 2, 2008}}{{vgrelease|TW|July 2, 2008}}
|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
}}
}}


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 select an application to launch by using a Wii Remote or the GameCube controller. It also accepts application uploads via a USB Gecko or TCP/IP (over WiFi 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 '''''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.
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).


<!-- The traps to prevent the HBC from working on Dolphin were put in place a long time ago, apparently between 3.0 and 3.5. Until someone tests all of the HBC versions in Dolphin and allows this page to go into full detail, it will focus on the latest version: which does not boot. Accordingly, this makes it 1 star in the ratings template and version compatibility. -->
== 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 ==
{{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.


=== Blackscreen ===
=== <s>Networking</s> ===
The developers of the Homebrew Channel have [https://forums.dolphin-emu.org/Thread-homebrew-channel-installation?pid=310212#pid310212 placed traps into the program] specifically to prevent the HBC from loading in Dolphin. All versions of the HBC launched after the traps were put into place will show a blackscreen. The version in which the traps were first put into place is unknown, but there have been no recorded instances of the HBC booting since before Dolphin 3.5.
Network initialization never completes. Fixed since at least {{revision|5.0-10472}}.


=== Unable to Install/Load Homebrew ===
=== <s>Direct3D</s> ===
In versions of the Homebrew Channel created before the traps were put into place, the HBC will start and load; but it will be unable to install or load any homebrew.
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}}.


=== Home Button Reset Hang ===
}}}}
Starting the Homebrew Channel, then reloading through the Home button may cause Dolphin to hang up randomly.


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


Line 33: Line 45:
{{VersionCompatibility}}
{{VersionCompatibility}}
<!--Use this template for compatibility entries: {{VersionCompatibilityVersion|revision|****|notes}}-->
<!--Use this template for compatibility entries: {{VersionCompatibilityVersion|revision|****|notes}}-->
{{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]]