{"id":29009766,"url":"https://github.com/nirmalab-codes/audalimo-sms","last_synced_at":"2026-04-14T15:33:56.120Z","repository":{"id":300897462,"uuid":"1007250533","full_name":"nirmalab-codes/audalimo-sms","owner":"nirmalab-codes","description":"Audalimo SMS Reader for Webhook","archived":false,"fork":false,"pushed_at":"2025-06-26T09:02:54.000Z","size":2853,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-03T13:43:32.335Z","etag":null,"topics":["android","ionic-framework","js","sms","sms-webhook","ts","webhooks"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nirmalab-codes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"josephvoxone","patreon":null,"open_collective":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://paypal.me/josephvoxone"]}},"created_at":"2025-06-23T17:38:04.000Z","updated_at":"2025-06-26T09:02:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"522293d0-0906-4c3c-935d-0ed5ff5af190","html_url":"https://github.com/nirmalab-codes/audalimo-sms","commit_stats":null,"previous_names":["nirmalab-codes/audalimo-sms"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/nirmalab-codes/audalimo-sms","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirmalab-codes%2Faudalimo-sms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirmalab-codes%2Faudalimo-sms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirmalab-codes%2Faudalimo-sms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirmalab-codes%2Faudalimo-sms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nirmalab-codes","download_url":"https://codeload.github.com/nirmalab-codes/audalimo-sms/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nirmalab-codes%2Faudalimo-sms/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31803521,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T11:13:53.975Z","status":"ssl_error","status_checked_at":"2026-04-14T11:13:53.299Z","response_time":153,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["android","ionic-framework","js","sms","sms-webhook","ts","webhooks"],"created_at":"2025-06-25T15:21:41.741Z","updated_at":"2026-04-14T15:33:56.115Z","avatar_url":"https://github.com/nirmalab-codes.png","language":"TypeScript","funding_links":["https://github.com/sponsors/josephvoxone","https://paypal.me/josephvoxone"],"categories":[],"sub_categories":[],"readme":"# 📱 SMS Webhook - Real-time SMS Forwarding App\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Android](https://img.shields.io/badge/Platform-Android-green.svg)](https://developer.android.com/)\n[![Ionic](https://img.shields.io/badge/Framework-Ionic-blue.svg)](https://ionicframework.com/)\n[![React](https://img.shields.io/badge/Frontend-React-61DAFB.svg)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/Language-TypeScript-blue.svg)](https://www.typescriptlang.org/)\n[![Release](https://img.shields.io/github/v/release/nirmalab-codes/audalimo-sms)](https://github.com/nirmalab-codes/audalimo-sms/releases)\n\n\u003e **Professional SMS to Webhook Forwarder** - Forward incoming SMS messages to your webhook endpoints instantly with persistent background monitoring, deduplication, and VPN-like foreground service.\n\n## 📱 **Download**\n\n### **Latest Release**\n[![Download APK](https://img.shields.io/badge/Download-APK-brightgreen.svg?style=for-the-badge\u0026logo=android)](https://github.com/nirmalab-codes/audalimo-sms/releases/latest)\n\n**Quick Install:**\n1. Download the latest APK from [Releases](https://github.com/nirmalab-codes/audalimo-sms/releases)\n2. Enable \"Install from Unknown Sources\" in Android settings\n3. Install the APK file\n4. Grant SMS permissions when prompted\n\n## 🚀 **Features**\n\n### 📨 **SMS Management**\n- ✅ **Real-time SMS monitoring** with persistent background service\n- ✅ **Instant webhook forwarding** for incoming SMS messages\n- ✅ **Duplicate prevention** system to avoid multiple webhook calls\n- ✅ **Message history** with comprehensive logging\n- ✅ **OTP \u0026 notification forwarding** perfect for automation\n\n### 🔧 **Advanced Configuration**\n- ✅ **Custom webhook URLs** with HTTPS support\n- ✅ **Secret key authentication** for secure webhook calls\n- ✅ **Webhook testing** with detailed response logging\n- ✅ **Auto-retry mechanism** for failed webhook deliveries\n- ✅ **Request signature generation** for webhook verification\n\n### 🛡️ **Background Processing**\n- ✅ **VPN-like foreground service** for persistent monitoring\n- ✅ **Battery optimization handling** to prevent service termination\n- ✅ **Background task management** with automatic restart\n- ✅ **System boot auto-start** capability\n- ✅ **Android 14+ compatibility** with latest foreground service APIs\n\n### 📊 **Monitoring \u0026 Analytics**\n- ✅ **Real-time statistics** and message counters\n- ✅ **Webhook delivery status** tracking\n- ✅ **Service health monitoring** with automatic diagnostics\n- ✅ **Activity logs** with detailed error reporting\n- ✅ **Performance metrics** and response time tracking\n\n## 🛠️ **Technology Stack**\n\n### **Frontend Framework**\n- **[Ionic Framework 8](https://ionicframework.com/)** - Cross-platform mobile app development\n- **[React 18](https://reactjs.org/)** - Modern UI library with hooks\n- **[TypeScript 5](https://www.typescriptlang.org/)** - Type-safe JavaScript development\n\n### **Mobile Platform**\n- **[Capacitor 7](https://capacitorjs.com/)** - Native mobile app runtime\n- **[Android SDK](https://developer.android.com/)** - Native Android functionality\n- **[Cordova Plugins](https://cordova.apache.org/)** - Device API access\n\n### **Core Plugins \u0026 Services**\n- **[@capawesome-team/capacitor-android-foreground-service](https://github.com/capawesome-team/capacitor-plugins)** - Persistent foreground service\n- **[@anuradev/capacitor-background-mode](https://github.com/anuradev/capacitor-background-mode)** - Background processing\n- **[@capawesome/capacitor-background-task](https://github.com/capawesome-team/capacitor-plugins)** - Background task management\n- **[capacitor-sms-inbox](https://github.com/abritopach/capacitor-sms-inbox)** - SMS reading capabilities\n\n### **Development Tools**\n- **[Vite 5](https://vitejs.dev/)** - Fast build tool and dev server\n- **[ESLint](https://eslint.org/)** - Code linting and quality\n- **[Yarn](https://yarnpkg.com/)** - Package management\n- **[Cypress](https://www.cypress.io/)** - End-to-end testing\n\n### **Build \u0026 Deployment**\n- **[Capacitor Assets](https://github.com/ionic-team/capacitor-assets)** - Icon and splash screen generation\n- **[Android Gradle](https://gradle.org/)** - Android build system\n- **[ProGuard](https://www.guardsquare.com/proguard)** - Code obfuscation\n\n## 📦 **Installation**\n\n### **Prerequisites**\n- Node.js 18+ and Yarn\n- Android Studio with SDK 33+\n- Java 17+ (for Android builds)\n\n### **Quick Setup**\n```bash\n# Clone the repository\ngit clone https://github.com/nirmalab-codes/audalimo-sms.git\ncd audalimo-sms\n\n# Install dependencies\nyarn install\n\n# Build the app\nyarn build\n\n# Add Android platform\nnpx cap add android\n\n# Sync and open in Android Studio\nnpx cap sync android\nnpx cap open android\n```\n\n### **Development Mode**\n```bash\n# Start development server\nyarn dev\n\n# Run with live reload on device\nnpx cap run android --livereload --external\n```\n\n## 🔧 **Configuration**\n\n### **Webhook Setup**\n1. **Configure Webhook URL**: Enter your server endpoint (https://your-server.com/webhook)\n2. **Set Secret Key**: Optional authentication key for webhook verification\n3. **Test Connection**: Use built-in webhook testing functionality\n4. **Save Configuration**: Settings are persisted locally\n\n### **Android Permissions**\nThe app requires the following permissions:\n```xml\n\u003cuses-permission android:name=\"android.permission.READ_SMS\" /\u003e\n\u003cuses-permission android:name=\"android.permission.RECEIVE_SMS\" /\u003e\n\u003cuses-permission android:name=\"android.permission.FOREGROUND_SERVICE\" /\u003e\n\u003cuses-permission android:name=\"android.permission.FOREGROUND_SERVICE_DATA_SYNC\" /\u003e\n\u003cuses-permission android:name=\"android.permission.WAKE_LOCK\" /\u003e\n\u003cuses-permission android:name=\"android.permission.POST_NOTIFICATIONS\" /\u003e\n```\n\n## 📡 **Webhook API**\n\n### **Request Format**\n```typescript\ninterface WebhookPayload {\n  message: string;      // SMS message content\n  sender: string;       // Sender phone number\n  timestamp: number;    // Unix timestamp\n  signature: string;    // HMAC signature for verification\n}\n```\n\n### **HTTP Headers**\n```\nContent-Type: application/json\nX-SMS-Signature: \u003chmac-signature\u003e\nX-SMS-ID: \u003cmessage-id\u003e\nUser-Agent: SMS-Webhook-App/1.0\n```\n\n### **Example Webhook Endpoint**\n```javascript\n// Node.js Express example\napp.post('/webhook', (req, res) =\u003e {\n  const { message, sender, timestamp, signature } = req.body;\n  \n  // Verify signature\n  const expectedSignature = generateSignature(message, sender, timestamp, SECRET_KEY);\n  if (signature !== expectedSignature) {\n    return res.status(401).json({ error: 'Invalid signature' });\n  }\n  \n  // Process SMS\n  console.log(`SMS from ${sender}: ${message}`);\n  \n  res.json({ status: 'received' });\n});\n```\n\n## 🎯 **Use Cases**\n\n### **Business Applications**\n- **OTP Forwarding**: Automatically forward verification codes to your systems\n- **Customer Communication**: Route customer SMS to CRM or support systems\n- **Transaction Alerts**: Forward banking/payment SMS to accounting systems\n- **Order Notifications**: Integrate SMS confirmations with e-commerce platforms\n\n### **Development \u0026 Testing**\n- **API Testing**: Receive SMS-based API responses during development\n- **Webhook Testing**: Test SMS-triggered workflows and automations\n- **Integration Testing**: Validate SMS-dependent application features\n- **Monitoring**: Track SMS-based alerts and notifications\n\n### **Personal Automation**\n- **Smart Home**: Trigger home automation based on SMS commands\n- **Backup Communications**: Forward important SMS to multiple channels\n- **Travel Notifications**: Route travel confirmations to itinerary apps\n- **Security Alerts**: Forward security codes to password managers\n\n## 🔒 **Security Features**\n\n- **HMAC Signature Verification**: Cryptographic webhook authentication\n- **HTTPS Enforcement**: Secure webhook communication\n- **Local Data Encryption**: Sensitive settings stored securely\n- **Permission Management**: Granular Android permission controls\n- **Request Deduplication**: Prevent replay attacks and duplicate processing\n\n## 📱 **Platform Support**\n\n| Platform | Status | Version |\n|----------|--------|---------|\n| Android | ✅ Supported | 7.0+ (API 24+) |\n| iOS | 🚧 Planned | Coming Soon |\n| Web | ✅ Development | PWA Ready |\n\n## 🤝 **Contributing**\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n### **Development Guidelines**\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 **License**\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 👨‍💻 **Author**\n\n**Joseph** - *Full Stack Developer \u0026 Mobile App Specialist*\n\n- 🌐 GitHub: [@josephvoxone](https://github.com/josephvoxone)\n- 📧 Email: joseph@nirmalab.com\n- 🏢 Company: [Nirmalab](https://nirmalab.com)\n- 💼 LinkedIn: [Joseph Shandy](https://www.linkedin.com/in/joseph-shandy/)\n\n## 💝 **Support This Project**\n\nIf this SMS Webhook app helps your business or development workflow, consider supporting its development:\n\n### **💰 GitHub Sponsors**\n[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-pink.svg)](https://github.com/sponsors/josephvoxone)\n\n### **🎯 PayPal**\n[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/josephvoxone)\n\u003e Send to: `joseph@nirmalab.com`\n\n### **🪙 Cryptocurrency**\n- **USDT (BSC/BEP20)**: `0x096b0fc77a87d5e1d0a1184df656b83dfb2984d5`\n\n## 🌟 **Star History**\n\n[![Star History Chart](https://api.star-history.com/svg?repos=nirmalab-codes/audalimo-sms\u0026type=Date)](https://star-history.com/#nirmalab-codes/audalimo-sms\u0026Date)\n\n## 📈 **Project Stats**\n\n![GitHub stars](https://img.shields.io/github/stars/nirmalab-codes/audalimo-sms?style=social)\n![GitHub forks](https://img.shields.io/github/forks/nirmalab-codes/audalimo-sms?style=social)\n![GitHub issues](https://img.shields.io/github/issues/nirmalab-codes/audalimo-sms)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/nirmalab-codes/audalimo-sms)\n\n## 🔍 **Keywords**\n\n`sms webhook` `android sms forwarder` `sms to webhook` `real-time sms` `sms automation` `ionic sms app` `capacitor sms` `webhook forwarding` `sms monitoring` `background sms service` `foreground service android` `sms api integration` `otp forwarding` `sms bridge` `webhook relay` `sms gateway` `mobile webhook` `android background service` `sms notification forwarding` `real-time messaging`\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repository if it helps you! ⭐**\n\n*Made with ❤️ by [Joseph](https://github.com/josephvoxone) from Indonesia 🇮🇩*\n\n\u003c/div\u003e ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnirmalab-codes%2Faudalimo-sms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnirmalab-codes%2Faudalimo-sms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnirmalab-codes%2Faudalimo-sms/lists"}