# easychen/pushdeer **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/easychen-pushdeer).** 5,006 stars · 510 forks · C · NOASSERTION ## Links - GitHub: https://github.com/easychen/pushdeer - awesome-repositories: https://awesome-repositories.com/repository/easychen-pushdeer.md ## Topics `app` `clip` `notification-service` `push` ## Description Pushdeer is a self-hosted push notification service designed to deliver instant alerts to mobile devices and IoT hardware. It functions as a centralized backend for managing and routing custom notifications via a private server. The system is distinguished by its appless push notification capability, which leverages native operating system features to receive alerts without requiring a dedicated client application installed on the handset. For IoT integration, it operates as a messaging gateway using the MQTT protocol to send real-time text and image notifications to smart hardware. The platform includes a comprehensive management suite for API keys and device registration tokens to secure the notification pipeline. It supports external notification forwarding from third-party platforms via custom JSON formats and provides topic-based routing to direct specific content types to targeted devices. Hardware-specific capabilities include image rendering on device screens, network time synchronization, and the ability to trigger physical alerts like buzzers. The backend is provided as a containerized environment designed for deployment using Docker and Compose. ## Tags ### Networking & Communication - [Cloud Push Notification Deliveries](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services/push-notification-providers/cloud-push-notification-deliveries.md) — Functions as a centralized server for delivering instant push notifications to both mobile devices and IoT hardware. ([source](https://github.com/easychen/pushdeer/blob/main/quickapp)) - [Appless Deliveries](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services/push-notification-providers/mobile-push-notification-deliveries/appless-deliveries.md) — Delivers push notifications to mobile devices without requiring a dedicated client application installed on the handset. - [MQTT Traffic Routing](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/mqtt-message-brokers/mqtt-traffic-routing.md) — Uses an MQTT publish-subscribe model to route real-time text and image notifications to IoT hardware. - [Appless Notification Systems](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services/push-notification-providers/mobile-push-notification-deliveries/appless-notification-systems.md) — Utilizes native OS capabilities to receive notifications via QR code setup instead of app installs. - [Self-Hosted Push Notification Platforms](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/notification-delivery-services/push-notification-providers/multi-platform-push-notifications/self-hosted-push-notification-platforms.md) — Provides a self-hosted server for sending instant alerts to mobile devices and hardware without a dedicated client app. - [Appless Receivers](https://awesome-repositories.com/f/networking-communication/notification-clients/appless-receivers.md) — Provides a lightweight mechanism to receive notifications on mobile devices without installing a dedicated client application. ([source](https://github.com/easychen/pushdeer/tree/main/quickapp)) - [Self-Hosted](https://awesome-repositories.com/f/networking-communication/push-notification-servers/self-hosted.md) — Provides a private, self-hosted backend using containers to manage and route custom alerts. - [Push Notification Forwarding](https://awesome-repositories.com/f/networking-communication/push-notification-forwarding.md) — Routes alerts from third-party platforms to personal devices using custom JSON formats to bridge different systems. - [Topic-Based Messaging](https://awesome-repositories.com/f/networking-communication/topic-based-messaging.md) — Routes specific content types like images or text to targeted devices using themed communication channels. ### DevOps & Infrastructure - [Appless Notifications](https://awesome-repositories.com/f/devops-infrastructure/push-notification-services/appless-notifications.md) — Sends instant alerts to mobile devices without requiring a dedicated application installed on the handset. - [Self-Hosted Deployments](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-deployments.md) — Allows deployment of a private backend instance using containers for full control over data and delivery. ([source](https://github.com/easychen/pushdeer#readme)) ### Hardware & IoT - [IoT Notification Messaging](https://awesome-repositories.com/f/hardware-iot/iot-device-management-platforms/iot-notification-messaging.md) — Sends real-time text and image notifications to smart hardware via the MQTT protocol for physical alerts. - [IoT Notification Delivery](https://awesome-repositories.com/f/hardware-iot/iot-message-ingestion/iot-notification-delivery.md) — Sends real-time text and image notifications to smart hardware using the MQTT protocol for physical alerts. ([source](https://github.com/easychen/pushdeer/blob/main/iot)) - [IoT Image Rendering](https://awesome-repositories.com/f/hardware-iot/iot-image-rendering.md) — Renders images on IoT device screens by sending image URLs to a dedicated topic. ([source](https://github.com/easychen/pushdeer/blob/main/iot)) ### Security & Cryptography - [API Key Management](https://awesome-repositories.com/f/security-cryptography/api-key-management.md) — Provides a management suite for creating and rotating secure API keys to route messages to specific devices. - [Notification Pipeline Authorization](https://awesome-repositories.com/f/security-cryptography/api-key-management/key-validators/notification-pipeline-authorization.md) — Secures the notification pipeline by requiring unique API keys to validate requests from third-party senders. - [Device Registration Services](https://awesome-repositories.com/f/security-cryptography/identity-access-management/access-control/device-connection-authorization/device-access-policies/device-registration-services.md) — Links physical hardware and mobile clients to user accounts using unique registration tokens. - [API Key Lifecycle Management](https://awesome-repositories.com/f/security-cryptography/api-access-security/api-key-generation/api-key-lifecycle-management.md) — Provides administrative tools to create, rename, and rotate API keys used to authorize and route notifications. ([source](https://github.com/easychen/pushdeer#readme)) ### System Administration & Monitoring - [MQTT Notification Integrations](https://awesome-repositories.com/f/system-administration-monitoring/mqtt-notification-integrations.md) — Functions as a messaging bridge that pushes text and image alerts to smart hardware via MQTT. ### Software Engineering & Architecture - [Webhook Integrations](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/programmatic-interfaces/webhook-event-notifications/webhook-integrations.md) — Provides a mechanism to receive and process custom JSON alerts from third-party platforms via webhooks. ([source](https://github.com/easychen/pushdeer#readme))