patrickwide/mpesa_sms_printer

Automatic M-Pesa SMS receipt printing app for Nyx POS devices, built with Flutter. # M-Pesa SMS Printer A Flutter application that automatically prints M-Pesa transaction receipts using Nyx POS thermal printers. Built on the PrinterClient SDK by SZNoryox. ## Features - 📱 **Automatic SMS Detection** - Listens for incoming M-Pesa SMS messages - 🖨️ **Auto-Print** - Automatically prints receipts when M-Pesa messages arrive - 🏢 **Business Customization** - Add your company name, address, contact info, and footer - 🔒 **Privacy Options** - Hide M-Pesa balance on printed receipts - ✅ **Test Print** - Preview your receipt format before going live - 📋 **Message History** - View all M-Pesa transactions in the app ### App Preview #### Home Screen #### Customize Business Info #### Print Preview / Main Feature ## 📥 Download Download the latest APK: 🔗 Latest Release) ## Requirements - Android device (Nyx POS device with thermal printer) - Flutter SDK - M-Pesa account receiving transaction SMS ## Installation 1. Clone the repository: ```bash git clone github.com cd mpesa_sms_printer ``` 2. Install dependencies: ```bash flutter pub get ``` 3. Run the app: ```bash flutter run ``` ## Configuration ### Business Information Navigate to the **Settings** tab to configure: - Company Name - Website - Address - Phone Number - Email - Custom Footer Message ### Print Settings - **Auto-print M-Pesa messages**: Toggle to enable/disable automatic printing - **Hide M-Pesa balance**: Toggle to show/hide your balance on receipts ## Usage 1. Grant the app SMS permissions when prompted 2. Configure your business information in Settings 3. Enable "Auto-print M-Pesa messages" 4. Use "Test Print" to verify your receipt format 5. Save settings The app will now automatically print receipts when M-Pesa SMS messages arrive. ## Permissions The app requires the following permissions: - `READ_SMS` - To read incoming M-Pesa messages - `RECEIV …