{"id":31960183,"url":"https://github.com/gasprinskiy/gammu-message-handler","last_synced_at":"2025-10-14T15:55:49.669Z","repository":{"id":316783447,"uuid":"1063527057","full_name":"Gasprinskiy/gammu-message-handler","owner":"Gasprinskiy","description":"Gammu Message Handler","archived":false,"fork":false,"pushed_at":"2025-09-26T18:07:05.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-26T18:31:37.619Z","etag":null,"topics":["gammu-smsd","sms-handler"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gasprinskiy.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-24T18:44:55.000Z","updated_at":"2025-09-26T18:07:08.000Z","dependencies_parsed_at":"2025-09-26T18:31:42.534Z","dependency_job_id":"0343a42a-913a-473c-974c-603306f72e99","html_url":"https://github.com/Gasprinskiy/gammu-message-handler","commit_stats":null,"previous_names":["gasprinskiy/gammu-message-handler"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Gasprinskiy/gammu-message-handler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gasprinskiy%2Fgammu-message-handler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gasprinskiy%2Fgammu-message-handler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gasprinskiy%2Fgammu-message-handler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gasprinskiy%2Fgammu-message-handler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gasprinskiy","download_url":"https://codeload.github.com/Gasprinskiy/gammu-message-handler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gasprinskiy%2Fgammu-message-handler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019300,"owners_count":26086712,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["gammu-smsd","sms-handler"],"created_at":"2025-10-14T15:55:47.567Z","updated_at":"2025-10-14T15:55:49.662Z","avatar_url":"https://github.com/Gasprinskiy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gammu Message Handler\n\nA Go application that receives SMS messages from a GSM modem via [Gammu SMSD](https://wammu.eu/gammu/), stores them in a database, and forwards them to a Telegram chat.\n\nThis repository contains only the **message handler** service.\nFor a full setup you will also need:\n\n- 📦 [gammu-mysql-db](https://github.com/Gasprinskiy/gammu-mysql-db) — database schema and migrations\n- 📦 [gammu-smsd-container](https://github.com/Gasprinskiy/gammu-smsd-container) — containerized Gammu SMSD service\n\nEach repository contains its own **instructions for setup and running**, so please refer to them individually.\n\n---\n\n## Features\n\n- Integration with **Gammu SMSD** for handling incoming SMS\n- Stores messages in a relational database (MySQL/MariaDB)\n- Forwards SMS to a **Telegram chat or channel**\n- Lightweight, written in **Go**\n\n---\n\n## Prerequisites\n\n- Docker and Docker Compose installed\n- A GSM modem with a working SIM card\n- Cloned repositories:\n  - [gammu-mysql-db](https://github.com/Gasprinskiy/gammu-mysql-db)\n  - [gammu-smsd-container](https://github.com/Gasprinskiy/gammu-smsd-container)\n  - [gammu-message-handler](https://github.com/Gasprinskiy/gammu-message-handler)\n\n---\n\n## Setup \u0026 Run\n\n\n1. **Create a common Docker network** for all SMS services, you can find a script in gammu-mysql-db repository or do it manually:\n\n   ```bash\n   docker network create sms_services\n   ```\n\n2. **Start the database service** (from the `gammu-mysql-db` repository):\n   Instructions are available in that repository.\n   The DB container should also join the `sms_services` network.\n\n3. **Start the SMSD service** (from the `gammu-smsd-container` repository):\n   Instructions are available in that repository.\n   This will run Gammu SMSD inside a container and connect it to the `sms_services` network.\n   If you done it correctly you will have all incoming messages in `inbox` table.\n\n4. **Create a `.env` file** in the root of this repository with the following variables:\n\n   ```env\n   DB_HOST=gammu-mysql-db // it's a name of db service on docker compose file\n   DB_PORT=3306\n   DB_USER=yourdbuser\n   DB_PASSWORD=yourpassword\n   DB_NAME=yourdbname\n\n   TELEGRAM_BOT_TOKEN=your_bot_token\n   TELEGRAM_CHAT_ID=your_chat_id\n   ```\n\n5. **Finally, start the message handler** (from this repository):\n\n   ```bash\n   ./start_docker.sh\n   ```\n\n   It will automatically connect to the database and forward incoming SMS messages to Telegram.\n\n---\n\n## Usage Flow\n\n1. An SMS arrives at the GSM modem.\n2. Gammu SMSD writes the message into the database and runs script that makes http request to this service.\n3. The handler reads new messages from the DB.\n4. The message is forwarded to the configured Telegram chat.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgasprinskiy%2Fgammu-message-handler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgasprinskiy%2Fgammu-message-handler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgasprinskiy%2Fgammu-message-handler/lists"}