Idea

Connect a suitable GSM modem or phone containing a SIM card into a computer (e.g. a Raspberry Pi) at a fixed place. Give sms4you access to a small xmpp server. It will use this connection to receive xmpp messages to be sent out as SMS and to send out xmpp messages with received SMS messages.

Concretely - why?

There can be many reasons, why you want to use sms4you. Here are some examples:

• You are living in the internetz, and you just need a gateway to this old thing "SMS", which some people really still seem to use.
• You travel and use local SIM cards, but you still want to be able to receive SMS confirmation codes from banks and services.
• You don't want to carry a (registered) SIM card for good reasons, but still you want to be able to send and receive SMS.

Dependencies

sms4you is implemented as a Python daemon, using Asynchronous I/O and depends on the following python packages:

• dbussy
• sdnotify
• slixmpp

In addition it requires the following services to be installed on the system:

• For the connection with the modem it uses ModemManager it will be accessed via DBus and your modem must, of course, be supported by ModemManager.

• For the connection with XMPP a suitable server must be running on the system, e.g. Ejabberd or Prosody, which at least has s2s

  System Message: ERROR/3 (README.rst, line 63)

  Unexpected indentation.

  connection to the outside world.

• python-systemd

Installation

• pip install .
• sudo cp sms4you-xmpp/sms4you-xmpp.py /usr/local/sbin/sms4you-xmpp
• sudo cp sms4you-xmpp/sms4you-xmpp.service /etc/systemd/system/
• sudo mkdir /etc/sms4you/

Component "sms4you.localhost"
    component_secret = "Mb2.r5oHf-0t"

$ sudo addgroup --force-badname --system _sms4you
$ sudo adduser --force-badname --home /nonexistent \
      --ingroup _sms4you --no-create-home --system _sms4you
$ sudo cp sms4you.conf /etc/dbus-1/system.d/
$ sudo cp sms4you.pkla /var/lib/polkit-1/localauthority/30-site.d/
$ sudo chown root:_sms4you /etc/sms4you/{sim_pin,xmpp_component_password}
$ sudo chmod 640 /etc/sms4you/{sim_pin,xmpp_component_password}

USER_JID=user@jabberserver.foo.bar

Let's Go

• sudo systemctl enable sms4you-xmpp.service
• sudo systemctl start sms4you-xmpp.service

Copyright and copyleft

Copyright (C) 2019-2025

• Felix Delattre felix@delattre.de
• Martin debacle@debian.org

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Also add information on how to contact you by electronic and paper mail.

If your software can interact with users remotely through a computer network, you should also make sure that it provides a way for users to get its source. For example, if your program is a web application, its interface could display a "Source" link that leads users to an archive of the code. There are many ways you could offer source, and different solutions will be better for different programs; see section 13 for the specific requirements.

See the LICENSE for the full license text.