https://github.com/discretetom/stickdeck

Turn your Steam Deck as a bluetooth joystick on PC.
https://github.com/discretetom/stickdeck

Last synced: 3 months ago
JSON representation

Turn your Steam Deck as a bluetooth joystick on PC.

• Host: GitHub
• URL: https://github.com/discretetom/stickdeck
• Owner: DiscreteTom
• License: mit
• Created: 2023-01-26T13:37:23.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-20T13:48:49.000Z (4 months ago)
• Last Synced: 2024-11-02T09:10:29.915Z (4 months ago)
• Language: Python
• Homepage:
• Size: 37.2 MB
• Stars: 15
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Deprecated

See [stickdeck-rs](https://github.com/DiscreteTom/stickdeck-rs) instead.

# Stick Deck

Turn your Steam Deck as a bluetooth joystick(gamepad) on PC.

![demo](img/demo.gif)

> [!NOTE]

> This solution doesn't implement HID (Human Interface Device), so you have to run a receiver program on your PC.

## Prerequisites

For both PC and Steam Deck:

- Python 3.x

- PyBlueZ

> [!WARNING]

> Install PyBlueZ by using its source code, **_DON'T_** just `pip install pybluez`, you should `git clone [email protected]:pybluez/pybluez.git` then `python setup.py install`.

> [!NOTE]

> For PC when installing PyBlueZ, you might need to install Windows C++ SDK. Just follow the tips from the pybluez.

Additional requirements for PC:

- `pip install vgamepad`, this will install a virtual gamepad driver on your PC.

Additional requirements for Steam Deck:

- `pip install pyjoystick`

> [!NOTE]

> During the installations above, you might need to install some additional softwares. Just follow those error messages and install them manually.

## Run the Sender on Steam Deck

First, set your bluetooth visible: Settings - Bluetooth - Configure - Visible

> [!NOTE]

> Or you can use `bluetoothctl` and `discoverable on`.

```bash

python deck.py

```

Then, [switch to Gamepad layout mode from desktop mode with a long press on the right pause button (3 strokes)](https://github.com/ValveSoftware/steam-for-linux/issues/8904).

## Run the Receiver on PC

```bash

python win.py 
 [port=1]

```


> [!NOTE]

> You can debug the joystick by running `joy.cpl` utility on Windows.

## Access from SteamDeck's Desktop

You can create a shell script on the desktop with some contents like:

```bash

#!/bin/bash

konsole -e "/bin/bash -c 'python deck.py'"

```

Then, `chmod +x .sh` makes it executable, then you can start the StickDeck from the desktop!