Transférer les notifications macOS vers ntfy

D’abord : de quel sens avez-vous besoin ?

Les recherches sur ntfy macOS désignent deux usages opposés :

• Recevoir un sujet ntfy sur votre Mac : ouvrez l’application web sur ntfy.sh/app dans votre navigateur et autorisez les notifications web, ou utilisez le client CLI ntfy subscribe. Vous n’avez pas besoin de NotiFerry pour cela.
• Envoyer les notifications des applications de votre Mac vers un sujet ntfy : ntfy ne lit pas le Centre de notifications de macOS par lui-même. Pour vos propres scripts, une commande curl suffit. Pour les applications que vous ne pouvez pas scripter, NotiFerry lit les nouvelles entrées du Centre de notifications et les publie sur votre sujet ntfy.

Ce que NotiFerry publie sur ntfy

Pour chaque nouvelle notification non exclue, NotiFerry envoie une requête JSON en POST à la racine du serveur ntfy configuré :

POST https://ntfy.sh/
Content-Type: application/json

{
  "topic": "nf-…",
  "title": "<application source> — <titre de la notification>",
  "message": "<sous-titre et corps>",
  "priority": 3,
  "tags": ["computer"]
}

Le contenu dépend du mode de confidentialité choisi dans NotiFerry :

• Notification complète : le titre combine le nom de l’application et le titre de l’alerte ; le corps contient le sous-titre et le message.
• Titre uniquement (par défaut) : le titre combine l’application et le titre de l’alerte, tandis que le corps est remplacé par « New notification ».
• Alerte générique : seul le nom de l’application est conservé avec la mention « New notification ».

Utiliser son propre serveur ntfy auto-hébergé

Par défaut, NotiFerry utilise https://ntfy.sh avec un nom de sujet aléatoire préfixé par nf-. Dans les réglages, vous pouvez remplacer l’URL du serveur par votre propre instance ntfy.

• NotiFerry exige HTTPS pour tout serveur distant (http:// n’est accepté que pour localhost ou 127.0.0.1 lors de tests locaux).
• Pour que l’application iOS ntfy reçoive les notifications push en arrière-plan depuis un serveur auto-hébergé, configurez upstream-base-url = "https://ntfy.sh" sur votre serveur comme l’explique la documentation iOS de ntfy.
• L’authentification peut être désactivée, utiliser un jeton d’accès (Bearer) ou un identifiant et un mot de passe (Basic), conservés dans le Trousseau macOS. Après toute modification du serveur, du sujet ou des identifiants, le transfert se met en pause jusqu’à la confirmation d’un nouveau test sur l’iPhone.

Limites de débit et file d’attente locale

Sur le service public ntfy.sh, NotiFerry limite ses envois à environ douze notifications par minute afin de respecter les limites du service gratuit, qui documente un plafond de 250 messages par jour. Lorsque l’envoi a au moins 30 secondes de retard et que cinq alertes ou plus d’une même application attendent dans la file, NotiFerry les regroupe dans l’alerte la plus récente en indiquant le nombre des précédentes.

Si le Mac perd temporairement sa connexion ou si le serveur répond par une erreur 429 ou 5xx, NotiFerry conserve jusqu’à 1 000 alertes déjà filtrées dans une file locale et réessaie avec des délais croissants d’au plus une minute. Une alerte toujours en attente 10 minutes après son apparition est abandonnée plutôt qu’envoyée en retard.