{"id":17063320,"url":"https://github.com/agwa/sms-over-xmpp","last_synced_at":"2026-03-03T19:05:10.539Z","repository":{"id":57563142,"uuid":"80454065","full_name":"AGWA/sms-over-xmpp","owner":"AGWA","description":"XMPP Component (XEP-0114) to send and receive SMS","archived":false,"fork":false,"pushed_at":"2024-12-08T15:46:31.000Z","size":161,"stargazers_count":80,"open_issues_count":11,"forks_count":11,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-03-31T09:09:06.689Z","etag":null,"topics":["go","sms","twilio","xmpp-component"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AGWA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-30T19:16:00.000Z","updated_at":"2025-03-16T16:42:00.000Z","dependencies_parsed_at":"2024-06-18T22:57:09.884Z","dependency_job_id":"81952cfe-ba9c-418a-9018-8383cd5649f2","html_url":"https://github.com/AGWA/sms-over-xmpp","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGWA%2Fsms-over-xmpp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGWA%2Fsms-over-xmpp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGWA%2Fsms-over-xmpp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AGWA%2Fsms-over-xmpp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AGWA","download_url":"https://codeload.github.com/AGWA/sms-over-xmpp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640462,"owners_count":20971557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","sms","twilio","xmpp-component"],"created_at":"2024-10-14T10:52:00.880Z","updated_at":"2026-03-03T19:05:10.534Z","avatar_url":"https://github.com/AGWA.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SMS-over-XMPP\n\nsms-over-xmpp is an XMPP component (XEP-0114) that acts as a gateway\nbetween an XMPP (aka Jabber) network and the SMS network.  It allows\nyou to send and receive SMS messages as if they were XMPP messages,\nusing your favorite XMPP client.\n\nYou send an XMPP message and your friend receives an SMS.  When they\nsend you an SMS, you receive an XMPP message.\n\n## Supported SMS Providers\n\n* Twilio (recommended)\n* Nexmo/Vonage\n* Signalwire\n* VoIP.ms (can only send to/receive from numbers with +1 country code)\n\n## Features\n\n### MMS\n\nsms-over-xmpp can send and receive MMS messages containing images.\n\nTo send MMS, your XMPP client/server must support:\n\n* XEP-0363 (HTTP File Upload)\n* XEP-0066 (Out of Band Data)\n\nTo receive MMS, your XMPP client must support:\n\n* XEP-0066 (Out of Band Data)\n\nIf your client does not support XEP-0066, then incoming MMS will\ncontain a URL to the media file.\n\n### CardDAV Roster Synchronization\n\nsms-over-xmpp can optionally synchronize a CardDAV address book with your\nXMPP roster.  Any contact in your address book with a mobile phone number\nis added to your XMPP roster with the necessary address to send them\nan SMS.  When a contact is deleted, it is also deleted from your roster.\n\nThe synchronization is one-way: changes made to your XMPP roster aren't\npropagated to your address book, and may be reverted.\n\nYour XMPP server must support\n[XEP-0321](https://xmpp.org/extensions/xep-0321.html).  For Prosody,\nyou can use [mod_remote_roster](https://modules.prosody.im/mod_remote_roster.html).  (Make\nsure you use a version which incorporates [this commit](https://hg.prosody.im/prosody-modules/rev/ad6e9b0fd15b).)\n\n## Installing\n\nIf you have [Go 1.21.0 or higher](https://go.dev/dl/) installed, you can run:\n\n```\ngo install src.agwa.name/sms-over-xmpp/cmd/sms-over-xmpp@latest\n```\n\nOr, you can download a binary from the [GitHub Releases Page](https://github.com/AGWA/sms-over-xmpp/releases).\n\nsms-over-xmpp is a single statically-linked binary so using Docker or a similar technology is superfluous.\n\n## Configuring\n\nSee the [Config Reference](doc/configuration.md).\n\n## Running\n\nNote that sms-over-xmpp will terminate if it loses its connection to the\nXMPP server.  You should run sms-over-xmpp from a process supervisor\nsuch as systemd or s6 to ensure that sms-over-xmpp is restarted if\nthis happens.\n\n## Tested Configurations\n\nsms-over-xmpp has been tested with the following configuration:\n\n* [Twilio](https://www.twilio.com/) for the SMS provider\n* [Prosody](https://prosody.im/) for the XMPP server\n* [Gajim](https://gajim.org/) for the desktop XMPP client\n* [Monal](https://monal.im/) for the mobile (iOS) XMPP client\n* [Radicale](https://radicale.org/) for the CardDAV server (needed for address book synchronization)\n* [mod_http_upload_s3](https://github.com/abeluck/mod_http_upload_s3) for HTTP file upload in Prosody (needed for sending MMS)\n* [mod_remote_roster](https://modules.prosody.im/mod_remote_roster.html) for remote roster management in Prosody (needed for address book synchronization)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagwa%2Fsms-over-xmpp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagwa%2Fsms-over-xmpp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagwa%2Fsms-over-xmpp/lists"}