swob - RelaySMS

swob - RelaySMS

Purpose and Core Functionality

• RelaySMS enables users to send and receive online‑style messages (e.g., emails, tweets, Telegram chats) via traditional SMS, eliminating the need for an active internet connection.

• The application works by converting outbound messages into SMS payloads that are delivered to a gateway, which then forwards them to the target service using stored credentials.

• Inbound messages from the services are similarly pulled, converted to SMS, and delivered to the user’s phone, providing a seamless two‑way channel.

Secure Credential Storage

• OAuth2 tokens for supported platforms—Gmail, Twitter, and Telegram—are encrypted locally and then backed up to secure online Vaults.

• Encryption employs industry‑standard AES‑256 with a user‑defined passphrase, ensuring that tokens remain unreadable even if the Vault is compromised.

• Token refresh flows are handled automatically, maintaining long‑term access without requiring repeated user logins.

Multi‑Account Management

• Users can register multiple accounts for each service (e.g., personal and work Gmail, several Twitter handles) within a single RelaySMS instance.

• Each account is isolated by its own encrypted token set, preventing cross‑account leakage.

• A simple selector interface lets users choose the originating account before composing a message, streamlining workflow for power users.

Message Sending Flexibility

• Messages can be dispatched with or without attaching a verified phone number as the sender ID, allowing for anonymous or branded outreach as needed.

• When a phone number is omitted, the gateway uses a shared pool number; when included, the user’s own number appears as the origin, facilitating reply‑to capabilities.

• The tool supports plain text, basic markdown (for services that accept it), and attaches media files up to the carrier’s MMS size limit.

Open‑Source Availability and Community

• RelaySMS is released under an open‑source license and hosted on GitHub at https://github.com/smswithoutborders.

• The repository includes full source code, build scripts, Dockerfiles, and detailed contribution guidelines, encouraging audits, feature extensions, and localization.

• Regular releases are tagged, and an issue tracker facilitates bug reporting and feature requests.

Target Use Cases

• Individuals in regions with unstable or costly data connectivity who need reliable access to email, social media, or chat platforms.

• Professionals requiring offline‑first communication for field work, disaster response, or travel where internet access is intermittent or prohibited.

• Developers seeking a reference implementation for bridging web APIs with SMS gateways in secure, token‑based applications.

FAQ

Q: What security measures protect my OAuth2 tokens?

A: Your OAuth2 tokens for Gmail, Twitter, and Telegram are encrypted locally using AES‑256 with a passphrase you choose. The encrypted tokens are then backed up to a secure online Vault. Even if the Vault is compromised, the tokens remain unreadable without your passphrase, and automatic refresh flows keep them valid without requiring you to log in repeatedly.

Q: Can I manage multiple accounts for the same service?

A: Yes. RelaySMS lets you register several accounts per service—such as a personal and a work Gmail or multiple Twitter handles—within a single instance. Each account has its own isolated set of encrypted tokens, preventing any cross‑account leakage, and a simple selector lets you pick the originating account before you send a message.

Q: How do I choose which account to send from?

A: Before composing a message, you tap the account selector, which displays a list of your configured accounts. Selecting one tells RelaySMS to use that account’s credentials for the outbound SMS, making it easy to switch between personal and professional identities on the fly.

Version History

v0.45.0——17 Sep 2026

Communicate with online services using SMS messaging Download the latest version of swob - RelaySMS to enjoy new features and updates immediately!

*0.45.0

Minor bug fixes and improvements. Install or update to the newest version to check it out!

*0.43.0

Minor bug fixes and improvements. Install or update to the newest version to check it out!

*0.40.0

Minor bug fixes and improvements. Install or update to the newest version to check it out!