content type

Building a Python Bluetooth Chat Application from Scratch Using PyBluez

Bluetooth remains a highly reliable protocol for short-range, peer-to-peer communication without relying on an internet connection. By leveraging Python and the PyBluez library, you can create a direct, wireless chat application between two devices.

This guide walks you through setting up a server-client architecture to transmit text messages over Bluetooth using Python. 1. Prerequisites and Environment Setup

Before writing the script, you must configure your operating system and Python environment. PyBluez relies on native system Bluetooth development headers. Linux Setup (Ubuntu/Debian)

Install the required Bluetooth development packages via your terminal:

sudo apt-get update sudo apt-get install libbluetooth-dev python3-dev pip install pybluez Use code with caution. Windows Setup

Windows users often require the Microsoft Visual C++ Build Tools installed to compile PyBluez successfully. Once installed, run: pip install pybluez Use code with caution.

Note: Ensure your device’s hardware Bluetooth adapter is turned on and set to “Discoverable” in your system settings before running the application. 2. Understanding the Architecture

Our application uses a standard RFCOMM (Radio Frequency Communication) protocol, which emulates an RS-232 serial port over Bluetooth. The application requires two main components:

The Server: Allocates a communication channel, advertises its specific service UUID, and listens for incoming connection requests.

The Client: Scans for available Bluetooth devices, looks for the server’s specific service UUID, and initiates the connection.

We will use a universally unique identifier (UUID) to ensure the client connects specifically to our chat application and not another Bluetooth peripheral. Our App UUID: 94f39d29-7d6d-437d-973b-fba39e49d4ee 3. Developing the Bluetooth Server

The server script binds to a local Bluetooth adapter, listens on a port, and opens a continuous loop to send and receive text messages once a client connects. Create a file named bt_server.py:

import bluetooth def start_server(): # Define the service UUID and port server_uuid = “94f39d29-7d6d-437d-973b-fba39e49d4ee” port = bluetooth.PORT_ANY # Create a server socket using RFCOMM protocol server_sock = bluetooth.BluetoothSocket(bluetooth.RFCOMM) server_sock.bind((“”, port)) server_sock.listen(1) # Advertise the service so clients can find it bluetooth.advertise_service( server_sock, “BtChatServer”, service_id=server_uuid, service_classes=[server_uuid, bluetooth.SERIAL_PORT_CLASS], profiles=[bluetooth.SERIAL_PORT_PROFILE] ) print(f”Waiting for connection on RFCOMM channel {server_sock.getsockname()[1]}…“) # Accept incoming connection client_sock, client_info = server_sock.accept() print(f”Accepted connection from {client_info}“) try: while True: # Receive data from the client data = client_sock.recv(1024) if not data: break print(f”Client: {data.decode(‘utf-8’)}“) # Send a reply message message = input(“You (Server): “) if message.lower() == ‘exit’: break client_sock.send(message.encode(‘utf-8’)) except IOError: print(“Connection lost.”) finally: # Clean up sockets client_sock.close() server_sock.close() print(“Server disconnected.”) if name == “main”: start_server() Use code with caution. 4. Developing the Bluetooth Client

The client searches for proximity devices broadcasting our specific chat UUID, extracts the hardware MAC address, and connects directly to the server’s channel. Create a file named bt_client.py:

import bluetooth import sys def start_client(): target_uuid = “94f39d29-7d6d-437d-973b-fba39e49d4ee” print(“Searching for BtChatServer service…”) # Find services matching our unique application UUID service_matches = bluetooth.find_service(uuid=target_uuid) if len(service_matches) == 0: print(“Could not find the chat server. Make sure it is running and discoverable.”) sys.exit() # Select the first matching service found first_match = service_matches[0] port = first_match[“port”] name = first_match[“name”] host = first_match[“host”] print(f”Connecting to ‘{name}’ on device {host} via port {port}…“) # Create client socket and connect to the remote host client_sock = bluetooth.BluetoothSocket(bluetooth.RFCOMM) client_sock.connect((host, port)) print(“Connected successfully! Type ‘exit’ to quit.”) try: while True: # Send a message first message = input(“You (Client): “) if message.lower() == ‘exit’: break client_sock.send(message.encode(‘utf-8’)) # Wait for the server’s response data = client_sock.recv(1024) if not data: break print(f”Server: {data.decode(‘utf-8’)}“) except IOError: print(“Disconnected from server.”) finally: client_sock.close() print(“Client disconnected.”) if name == “main”: start_client() Use code with caution. 5. Running the Application

Follow these steps to execute your Bluetooth terminal chat application:

Pair Devices: Ensure both devices are paired at the operating system level.

Start Server: Run python bt_server.py on the host machine. It will pause and display a message stating that it is waiting for a connection.

Start Client: Run python bt_client.py on the second machine. The client will scan, locate the server UUID, and connect.

Chat: Take turns typing messages in your terminal interfaces. 6. Limitations and Next Steps

This script provides a fundamental synchronous architecture where users must take turns sending messages (similar to a walkie-talkie). To transform this into a robust, real-time chat client, consider adding these enhancements:

Threading: Implement Python’s threading library to separate the data receiving loop (recv) from the user input loop (input). This allows you to receive messages at any moment without waiting for your turn to type.

Graphical User Interface (GUI): Wrap the sockets inside a simple tkinter or PyQt frame to build a visual messaging interface instead of relying entirely on the command line.

To help me tailor any specific enhancements for your script, could you let me know:

What Operating System (Windows, Linux, macOS) are you planning to run this on?

Are you interested in adding a graphical user interface like Tkinter? AI responses may include mistakes. Learn more