tablebird/adb-backup repository overview

⁠Adb Backup

Backup Android SMS via ADB and store in database with webhook notification

⁠How it works

Uses adb shell content query --uri content://sms/ to periodically read SMS messages from the phone.

If a notification address is configured, a POST request will be sent to the notification address every time a new SMS is read

⁠Docker compose

version: '3.8'
services:
  adb-backup:
    container_name: adb-backup
    image: tablebird/adb-backup
    restart: unless-stopped
    env_file:
      - .env
    volumes: 
      - /dev/bus/usb:/dev/bus/usb
    privileged: true

⁠.env

ADB_PORT=5037
DB_HOST=postgres.lan
DB_PORT=5432
DB_USER=backup
DB_PASS=backup
DB_NAME=backup
DB_SSLMODE=disable
DEBUG_LOG=true
READ_INTERVAL=5
WAIT_DEVICE_INTERVAL=10
# NOTIFY_WEBHOOK_URL=https://example.com/api/newSms/webhooks/<token>

⁠Environment Variables and Default Values

• ADB_PORT: adb server port (default: 5037)
• DB_HOST: PostgreSQL database host (default: postgres.lan)
• DB_PORT: Database port number (default: 5432)
• DB_USER: Database user (default: backup)
• DB_PASS: Database password (default: backup)
• DB_NAME: Database name (default: backup)
• DB_SSLMODE: Whether to enable SSL (default: disable)
• DEBUG_LOG: Whether to enable debug logging (default: false)
• READ_INTERVAL: Message reading interval (default: 5s)
• WAIT_DEVICE_INTERVAL: Interval for checking Android device connection (default: 10)
• NOTIFY_WEBHOOK_URL: POST notification URL for new SMS after starting monitoring (default: empty, no notification)

⁠github

adb-backup⁠