Build your own Mailfob

from gpiozero import DigitalInputDevice
from signal import pause
from datetime import datetime
import time
import os
import paho.mqtt.publish as publish

SENSOR_GPIO = 17

MQTT_ENABLED = True
MQTT_HOST = "homeassistant.local"
MQTT_PORT = 1883
MQTT_USERNAME = ""
MQTT_PASSWORD = ""

MQTT_TOPIC_STATE = "mailfob/mailbox/state"
MQTT_TOPIC_EVENT = "mailfob/mailbox/event"

CAMERA_ENABLED = False
PHOTO_DIR = "/home/pi/mailfob/photos"

DEBOUNCE_SECONDS = 60
last_trigger_time = 0

sensor = DigitalInputDevice(SENSOR_GPIO, pull_up=False)

def send_mqtt(topic, payload):
    if not MQTT_ENABLED:
        return

    auth = None

    if MQTT_USERNAME and MQTT_PASSWORD:
        auth = {
            "username": MQTT_USERNAME,
            "password": MQTT_PASSWORD
        }

    publish.single(
        topic,
        payload,
        hostname=MQTT_HOST,
        port=MQTT_PORT,
        auth=auth
    )

def take_photo():
    if not CAMERA_ENABLED:
        return None

    os.makedirs(PHOTO_DIR, exist_ok=True)

    timestamp = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
    photo_path = f"{PHOTO_DIR}/mail_{timestamp}.jpg"

    os.system(f"libcamera-still -o {photo_path} --width 1280 --height 720 --timeout 1000")

    return photo_path

def mail_detected():
    global last_trigger_time

    now = time.time()

    if now - last_trigger_time < DEBOUNCE_SECONDS:
        return

    last_trigger_time = now

    timestamp = datetime.now().isoformat()
    print(f"Mailfob detected mailbox movement at {timestamp}")

    photo_path = take_photo()

    send_mqtt(MQTT_TOPIC_STATE, "mail_detected")
    send_mqtt(MQTT_TOPIC_EVENT, f"time={timestamp}, photo={photo_path if photo_path else 'none'}")

sensor.when_activated = mail_detected

print("Mailfob is running...")
print("Using SW-420 on GPIO17 / physical pin 11")
print("Waiting for mailbox vibration...")

send_mqtt(MQTT_TOPIC_STATE, "online")

pause()