Metadata-Version: 2.4
Name: pypsxwakebt
Version: 0.1.0
Summary: A Python library to wake PlayStation consoles via Bluetooth and extract MAC addresses via USB.
Home-page: https://github.com/FreeTHX/pypsxwakebt
Author: FreeTHX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: usb
Requires-Dist: pyusb; extra == "usb"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-python
Dynamic: summary

# 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](https://github.com/FreeTHX/pywakepsXonbt)** and **[pywakeps4onbt](https://github.com/FreeTHX/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:

```bash
pip install pypsxwakebt[usb]
```

## ⚡ Quick Start

Extracting the console and controller MAC addresses via USB:

```python
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.
