Giter VIP home page Giter VIP logo

wiitarthing-vigem's Introduction

About WiitarThing

WiitarThing lets you use Wii Guitar Hero guitars (a.k.a. "Wiitars") and Wii Guitar Hero drums (a.k.a. "Wiidrums") wirelessly with a Wii Remote (a.k.a. "Wiimote") on Windows PCs with high performance (built with Clone Hero in mind). To use Wiitars or Wiidrums with a wired connection on your PC without a Wiimote or Bluetooth, you can order the Raphnet adapter. This software is not needed in that case.

WiitarThing is built upon WiinUSoft and WiinUPro's codebase, but not forked because the changes are too significant and messy. All credit for connecting Wiimotes in general and most of the UI goes to Justin Keys.

This fork is based on the original WiitarThing fork, with the ViGEmBus conversion code done by MWisBest in their fork/issue. Aida-Enna merged the ViGEmBus code and built releases for it, and now I (TheNathannator) have taken on the responsibility of maintaining it.

SETUP GUIDE

Introductory Notes

  • This tool is ONLY for connecting Wiitars and Wiidrums wirelessly on Windows PCs. This tool does NOT apply to Mac or Linux or for connecting Wiitars/Wiidrums over a wired connection.

  • A Wiimote is required for this method of connection. Plug the guitar into the Wiimote in the same way you would connect a Nunchuck or Classic Controller.

  • This way of connecting instruments works best on Windows 10 using the Microsoft Bluetooth stack, though it is possible on Windows 7 (but only very rarely works).

  • Third-party Wiimotes are not recommended as they do not work 99% of the time.

    • This is because they cut corners, only providing the data packets that an actual Wii console needs to interact with the Wii Remote. On the other hand, official Wii Remotes go the full way providing everything a PC needs to connect to them, despite the Wii not needing any of that functionality.
  • This tutorial is for 5-fret Guitar Hero guitars and Guitar Hero drums only. Rock Band instruments use different methods of connecting to your computer and will not with using this method.

    • For Wii Rock Band guitars or Wii Rock Band drums, you connect them with the USB dongle in the exact same manner as a PS3 Rock Band guitar. None of this nonsense is needed.
  • You can connect up to 4 Wii instruments using this method.

  • WiitarThing will not work out of the box for the PC versions of Guitar Hero 3, Guitar Hero: Aerosmith, or Guitar Hero: World Tour.

    • This is because WiitarThing makes the guitar show up as a regular Xbox 360 gamepad. These official PC releases of these games expect an Xbox 360 gamepad flagged as a guitar.
    • To get around this, you can use x360ce to emulate a guitar-flagged controller.
    • WiitarThing is currently unable to flag the emulated gamepad as a guitar, this is the only option for now.

Getting Started

  • 1. Remove conflicting software.

    • 1.1. Make sure you do NOT have HIDWiimote installed as it completely overrides the Wiimote's drivers and makes WiitarThing unable to communicate with them. HIDWiimote Uninstallation Instructions (scroll down to "Uninstall Instructions")
    • 1.2. Make sure to remove SCPDriver if you installed it for an older WiitarThing version (or for anything else that uses it):
      • 1.2.1 Open the SCPDriver installer.
      • 1.2.2 Click the Uninstall button.
      • 1.2.3 Once that finishes, close the installer and delete the SCPDriver files.
      • DO NOT TOUCH ANYTHING ELSE IN THE INSTALLER!
    • 1.3. Make sure that Xbox controller configuration is DISABLED in Steam:
      • 1.3.1. Go to the main Settings screen on Steam.
      • 1.3.2. Go to the Controller tab.
      • 1.3.3. Click the GENERAL CONTROLLER SETTINGS button.
      • 1.3.4. UNCHECK the Xbox Configuration Support checkbox.
      • 1.3.5. UNCHECK the Generic Gamepad Configuration Support checkbox.
  • 2. Set up the required virtual Xbox gamepad driver:

    • 2.1. Download the latest release of the ViGEmBus installer.
    • 2.2. Run it as admin and install the driver.
  • 3. Get WiitarThing:

    • 3.1. Visit the "Releases" tab.
    • 3.2. Download the WiitarThing.<version>.zip file for the latest version released.
    • 3.3. Extract the ZIP into a new folder.

Connecting Wiitars and Wiidrums (WITH A STANDARD BLUETOOTH ADAPTER WITH MICROSOFT BLUETOOTH STACK)

  • 1. Run WiitarThing.
  • 2. Plug the Wiimote into the peripheral before continuing.
  • 3. Click the REMOVE ALL WIIMOTES button to make sure you do not have any Wiimotes connected to your computer (click yes if prompted)
  • 4. Click the SYNC Button in the top left corner of WiitarThing
  • 5. Press the red SYNC button on the inside of your Wiimote's battery cover (1+2 may also work if this is giving you issues.)
  • 6. IMPORTANT: If Windows 10 has a popup in the bottom-right corner of the screen that says "Tap to set up your Nintendo-RVL-CNT-01", then you must disable this option.
  • 7. Be patient. Some errors may display in Wiitarthing while connecting, ignore them.
  • 8. If your Wiimote's LEDs stop flashing, simply hit the red SYNC button again (or 1+2)
  • 9. Click OK when the message box pops up telling you that you need to BE PATIENT as the drivers install.
  • 10. If it has been an entire minute and the Wiimote has not connected, press "Refresh connected device list". If it still doesn't show up, restart the program and connection process.
  • 11. Eventually the Wiimote should appear in the list on the left side of the window.
  • 12. Click the CONNECT button on the menu next to the Wiimote you want to use and then choose Player 1, 2, 3, or 4.
  • 13. Press 1+2 on the Wiimote you want to use and click OK on th prompt telling you to do so.
  • The SYNC only needs to be performed on Wiimotes which have not been connected in this way before. If you have a previous connected Wiimote, simply click CONNECT and press 1+2 on the Wiimote to connect it. If your Wiimote does not show up in the left side, pressing 1+2 may cause it to appear.

Connecting Wiitars (WITH A DOLPHINBAR)

  • This method works flawlessly on Windows 10 and may work well on Windows 7/8/8.1 but has not been tested much on those operating systems. This method was not tested for Wiidrums.
  • 1. Buy a DolphinBar here if you don't already have one.
  • 2. Plug the DolphinBar into a USB port on your PC and click the MODE button on the DolphinBar until it goes to MODE 4.
  • 3. If you have NOT previously synced the Wiimote to the DolphinBar, press SYNC on the DolphinBar, then press SYNC on your Wiimote. If you have, then skip this step.
  • 4. Close WiitarThing if it was already running.
  • 5. Run WiitarThing AS AN ADMINISTRATOR.
  • 6. 4 Wiimotes will show up in the list on the left (even if there aren't 4 Wiimotes connected.)
  • 7. Click the ID button on each Wiimote in the list until the one you want to connect vibrates for a second and click CONNECT on that Wiimote in the list.
  • 8. Click OK on the prompt telling you to press 1+2 (on DolphinBar you don't actually need to press 1+2)
  • The SYNC only needs to be performed on Wiimotes which have not been connected in this way before. If you have a previous connected Wiimote, simply click CONNECT and press 1+2 on the Wiimote to connect it. If your Wiimote does not show up in the left side, pressing 1+2 may cause it to appear.

Connecting Wiitars (WITH A STANDARD BLUETOOTH ADAPTER USING THE TOSHIBA BLUETOOTH STACK)

  • Not recommended except as a last resort as it does not work on Windows 10 and often doesn't work on Windows 7 for no reason. This method was not tested for Wiidrums.
  • 1. If your Bluetooth receiver is an official Toshiba branded one, then skip to step 3.
  • 2. For non-Toshiba Bluetooth receivers, you must follow this long list of instructions (driver test mode required etc) to install the Toshiba bluetooth drivers and software on non-Toshiba adapters.
  • 3. Connect the Wiimote via Toshiba bluetooth (no specific methods required, it just works like any other bluetooth device)
  • 4. Close WiitarThing if it was already running.
  • 5. Run WiitarThing AS AN ADMINISTRATOR.
  • 6. Click the CONNECT button on the menu next to the Wiimote you want to use and then choose Player 1, 2, 3, or 4.
  • 7. Press 1+2 on the Wiimote you want to use and click OK on the prompt telling you to do so.

Calibrating Your Wiitar Before Playing

  • This must be done because Wiimotes and Wiitars all have their own unique value ranges that cannot be programmed into the app itself.
  • 1. Calibrate the whammy bar's range, by moving the whammy bar all the way down, then back up.
  • 2. Calibrate the tilt functionality.
    • 2.1. Lay the guitar flat with the frets on top and the neck pointing to your left.
    • 2.2. Press the 1 button on the Wiimote to set the minimum of the tilt range.
    • 2.3. Stand the guitar up with the neck pointing directly upward and the frets in front, facing toward the screen, sort of like you're activating Star Power.
    • 2.4. Press the 2 button on the Wiimote to set the maximum of the tilt range.
    • There is no specific menu for these steps, simply pressing the buttons will set the calibration values automatically.
  • 3. Calibrate the joystick range by pressing it all the way toward the outer edge, then sliding it all along the outer edge in one circular motion, like walking in a circle in most third person video games.

Closing Notes

  • If you wish to disconnect your Wiimote and stop playing, click the DISCONNECT button on the menu next to the remote you want to disconnect, then hold down the POWER button on the face of the Wiimote for a couple seconds to turn off your Wiimote.
    • Be careful not to bump the wiitar as the B button will get pressed onto the backplate, turning your Wiimote back on and draining your battery very stupidly.
  • You can enable auto-connect on Wiimotes if you click the properties button on it and choose that option.
    • Auto-connect might only work on the first 3 Wiimotes listed.
  • Wiimotes send data at around 100Hz, in case you were wondering how responsive Wiitars are with this method.
    • A bad Bluetooth adapter or Bluetooth signal interference (way more of a problem than you might realize!) may cause packets to be dropped resulting in less than 100 updates per second actually reaching WiitarThing.
  • This application supports the Classic Controller and Classic Controller Pro extensions as well. When using these, the buttons are mapped to the corresponding Xbox 360 gamepad buttons.
  • The touch bar can be enabled and disabled by pressing the +/- buttons on the wiimote. When enabled, the touchbar will be mapped to the regular frets.
    • Please note that the touchbar is not the best and may be very finnicky! WiitarThing has no ability to fix this, as it just simply takes the data it gets and translates it directly.
  • The tilt functionality actually comes from the Wiimote on Wiitars so changing Wiimotes will actually change your tilt sensitivity and responsiveness as Wiimote accelerometers are very inconsistently produced.

Getting More Help If Needed

Consult the #help-line channel in the official Clone Hero server on Discord if you need help following the instructions, advice on what to buy, or any other questions.

wiitarthing-vigem's People

Contributors

aida-enna avatar cristobalpenaloza avatar meowmaritus avatar thenathannator avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.