This is a simple stdout server that listens for incoming SMS messages and prints them out in a JSON format. This is powered using Bluetooth, python-dbus and BlueZ.
This project will prove very useful for those who want to interface their phone's SMS messages with their computer. This is project is also designed to be run on a Raspberry Pi or any other Linux-based system -- allowing you to have a dedicated SMS receiver. This is perfect for intergrating with IoT projects such as one of those smart mirrors or a home automation system.
- Read incoming SMS messages
- Read incoming MMS messages
This is currently a work in progress and in result is not fully stable. But it is designed to be a simple and easy way to interface your phone's texts with your computer using the MAP profile.
- Python 3
- Linux-based OS
- BlueZ
- BlueZ Obex Library
- Bluetooth Adapter
1. Install the Bluez and Bluez Obex Library
sudo apt-get install bluez bluez-obexdsudo pacman -S bluez bluez-utils
#using yay
yay -S bluez-obex2. Enable the Bluetooth services
Personally, I had a really hard time getting the Bluetooth services to work...
sudo systemctl enable bluetooth #works
sudo systemctl start bluetooth #works
#might not work
sudo systemctl enable obex
sudo systemctl start obexIf you have an error with the obex service, try to enable and start the service in the user session
systemctl --user enable obex
systemctl --user start obex3. Pair your phone using bluetoothctl
Run:
git clone https://github.com/Identityofsine/sms-server && cd sms-server && pip install -r requirements.txt After you have paired your phone with your computer, you can run the server using the following command:
python __init__.py --device <device_address>Find the
<device_address>using thebluetoothctlcommand
By default, the server will print out the incoming messages in a redundant JSON format.
{
"sender": "+18885521442",
"subject": "their message",
"timestamp": "2024-07-01 12:00:00"
}You can also enable a more human readable format by adding the
--prettyor-pflag
python __init__.py --device <device_address> --prettyYou can also run the server in verbose mode by adding the --debug flag
python __init__.py --device <device_address> --debugNote: PBAP support is here, I just haven't had the time to implement reading vcards yet.
I plan to add more features to this project such as the ability to send messages, read contacts, send commands through stdio, and more.
Most importantly, I plan to dockerize this project and make it much more easy to setup and use.