SMS4YOU(1)

💖 SMS4YOU(1) 💖

okay bestie, welcome to the sms4you(1) manual page, straight out of the General Commands Manual section. sit down, get comfy, we're gonna talk about the cutest little SMS gateway you ever did see. 🎀

---

✨ NAME ✨

sms4you — your personal gateway connecting SMS with XMPP or email. 💌📱

so like, sms4you forwards messages from and to SMS, and it connects with either sms4you-xmpp or sms4you-email to pick the other mean of communication. it's giving "nice for receiving or sending SMS, independently from carrying a SIM card." no SIM in your pocket? no problem, queen. 💅

---

🌈 IDEA 🌈

okay so picture this: you take a suitable GSM modem, or literally a phone that has a SIM card in it, and you plug it into a computer (a Raspberry Pi is the classic move) at a fixed place. it just lives there. it's thriving. 🌸

then you 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 that are meant to be sent out as SMS, and to send out emails or xmpp messages with the SMS messages it received. two-way street, mutual effort, communication slay. 🦋

---

💭 CONCRETELY — WHY? 💭

there can be many reasons why you'd want to use sms4you. here are some examples, bestie:

• 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. and listen — the different gateways for email and xmpp have different depenedencies, and are wrapped therefore into different sub-projects. yes, that's the original spelling, i am simply the messenger. 🙈

---

🛠️ INSTALLATION 🛠️

• As an email gateway 📧
• As a xmpp gateway 💬

🫶 Run sms4you as unprivileged user 🫶

this is the part where you make a whole dedicated little user so your daemon doesn't run as root, because we are responsible main characters. 🎀

$ 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}

look at those permissions on sim_pin and xmpp_component_password though. 640, root-owned, group _sms4you. your secrets are not out here being messy. 🔥

---

📜 COPYRIGHT AND COPYLEFT 📜

Copyright (C) 2019-2020

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

bestie this part is important, do not skim it. it's the legal vibe check. 💜

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.

---

aaaand that's the whole page, bestie! 🌟 this was the SMS4YOU(1) page, from the General Commands Manual — that's the source and the version tag, right there in the corner, and honestly? iconic. go forth and gateway your SMS. periodt. 💅💖✨