buzz-lightsnack-2007/joydance-improved
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
joydance-improved/README.md
redphx 319fa70e3e
Update Usage section
2022-04-14 17:36:26 +07:00

4.6 KiB
Raw Blame History

JoyDance

image

How does it work?

It pretends to be the Just Dance Controller app, sends movements of the Joy-Con to your game console.

Features

  • Play Just Dance 2017 and later on Xbox/Stadia/PS/NSW with Joy-Cons.
  • Playing with a Joy-Con (+ its strap) is safer and more comfortable than holding a phone.
  • No latency.
  • Better score than using a phone.
  • No random disconnection.
  • Support up to 6 players.
  • Support all platforms (in theory):
    • Xbox Series X/S
    • Nintendo Switch
    • Xbox One (not tested)
    • Stadia (not tested)
    • Playstation 4/5 (not tested)

Tested on

Tested on Zero 2 W with 2 Joy-Cons and it worked just fine.

Requirements

  • PC/Mac/Linux with bluetooth support.
  • Python 3.7+ and pip installed.
  • 1 to 6 Joy-Cons.
  • It's RECOMMENDED to:
    • Use a Bluetooth dongle, because built-in Bluetooth sucks (or you will get disconnected constantly while playing). Make sure you buy a dongle with game controllers support, not just for audio devices. Not all dongles support Mac/Linux, so remember to check compatibility before buying.
    • Use a Nintendo Switch to update Joy-Con to the latest firmware & calibate its motion sensors. Ask your friends or bring it to the game shop if you don't have one.

Installation

  1. Download the latest version and extract it into a folder.
  2. Open that folder in Terminal/Command Prompt, then run this command:
pip3 install -r requirements.txt

Extra steps for Linux users

  1. Linux users may need to use hid instead of hidapi (not sure why hidapi couldn't find Joy-Cons on Linux).
pip3 uninstall hidapi

sudo apt install libhidapi-dev
pip3 install hid
  1. Create a new udev rule file at /etc/udev/rules.d/50-nintendo-switch.rules (Source)
# Switch Joy-con (L) (Bluetooth only)
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", KERNELS=="0005:057E:2006.*", MODE="0666"

# Switch Joy-con (R) (Bluetooth only)
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", KERNELS=="0005:057E:2007.*", MODE="0666"

# Switch Pro controller (USB and Bluetooth)
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="2009", MODE="0666"
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", KERNELS=="0005:057E:2009.*", MODE="0666"

# Switch Joy-con charging grip (USB only)
KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="200e", MODE="0666"

Reload udev rules:

sudo udevadm control --reload-rules
sudo udevadm trigger
  1. Install dkms-hid-nintendo (Joy-Con driver) if you're running Linux kernel older than 5.16.

Usage

  1. Open the phone pairing screen on Just Dance.

  2. Connect your PC/Mac/Linux to the same Wi-Fi network as your game console.

  3. Run this command:

python3 dance.py

  1. Open http://localhost:32623 in a web browser (32623 = DANCE).

  2. Turn on Bluetooth and pair with Joy-Con by holding down the SYNC button until the light move up and down. Press the "Refresh" button until your Joy-Con shows up.

  3. Fill the form.

  • Pairing Method:

    • Fast:
      • Only for Xbox One, PlayStation 4/5 and Nintendo Switch.
      • Requires console's private IP address.
      • Doesn't require pairing code.
      • Connect instantly.
    • Default
      • Slower, but supports all platforms (including Xbox Series and Stadia).
      • Requires pairing code.
      • Requires host's private IP address.

  • Host's Private IP Address:

    • The private IP address of your PC/Mac/Linux. Find this in the Wi-Fi settings.
    • Starts with 192.168.

  • Console's Private IP Address:

    • The private IP address of your console. Find this in the Wi-Fi settings on console.
    • Starts with 192.168.

  • Pairing Code: get this from the game.

  1. Press the "Connect" button next to Joy-Con to start the pairing process.

  2. 🕺💃