Ubuntu Manpage: sms4you - Personal gateway connecting SMS with XMPP or email.

NAME

       sms4you - Personal gateway connecting SMS with XMPP or email.

       sms4you  forwards  messages  from  and  to  SMS and connects either with sms4you-xmpp or sms4you-email to
       choose the other mean of communication.  Nice for receiving or sending SMS, independently from carrying a
       SIM card.

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 either a simple email address or a small xmpp server. It will use
       this connection to receive emails or xmpp messages to be sent out as SMS and to send out emails  or  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.

REQUIREMENTS

       sms4you is implemented as a Python daemon, using Asynchronous I/O.  For the connection with the modem  it
       uses  ModemManager.   The  different  gateways  for  email  and xmpp have different depenedencies and are
       wrapped therefore into different sub-projects:

INSTALLATION

       • As an email gateway

       • As a xmpp gateway

   Run sms4you as unprivileged user
          $ 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}

COPYRIGHT AND COPYLEFT

• 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.

SMS4YOU(1)