pypsxwakebt 0.1.0

A Python library to wake PlayStation consoles via Bluetooth and extract MAC addresses via USB.

pypsxwakebt

A Python library dedicated to PlayStation (PS3, PS4, PS5) Bluetooth operations and wake-up sequences.

🏛️ Legacy Notice

This library is the official, modern successor to the previous pywakepsXonbt and pywakeps4onbt projects. It unifies, updates, and improves the functionality of these older repositories into a single, actively maintained package.

🚀 Current Status: Beta (v0.1.0)

At this stage of development, the library provides a robust utility to extract Bluetooth MAC addresses from PlayStation controllers (DualShock 3, DualShock 4, DualSense) connected via USB.

Future releases will integrate low-level Bluetooth HCI commands, MAC address spoofing, and complete wake-up sequences directly from Python.

⚙️ Installation

To install the library with the USB extraction dependencies, run:

pip install pypsxwakebt[usb]

⚡ Quick Start

Extracting the console and controller MAC addresses via USB:

from pypsxwakebt.usb import extract_psx_bt_macs

# Ensure your controller is connected via USB before running
mac_data = extract_psx_bt_macs()

if mac_data:
    print(f"Controller Type: {mac_data['controller_type']}")
    print(f"Controller MAC:  {mac_data['dsx_mac']}")
    print(f"Console MAC:     {mac_data['psx_mac']}")
else:
    print("No supported Sony controller found on USB.")

🎮 Supported Devices

• DualShock 3 (PS3)
• DualShock 4 (PS4)
• DualSense & DualSense Edge (PS5)

📄 License

This project is licensed under the MIT License.