Flux RSS
Incluse avec Macro DeckSuivez des flux RSS et Atom, affichez leurs derniers articles dans des widgets et réagissez à l'arrivée de nouveaux articles.
Un widget Liste de flux et un widget Article à la une affichant des articles d'exemple d'un flux Tech News
- Suivez autant de flux RSS 2.0 ou Atom que vous voulez
- Widgets Liste de flux et Article à la une
- Ouvrez un article sur l'appareil sur lequel vous le touchez
- Des déclencheurs pour les nouveaux articles et les actualisations échouées
- Des filtres par mots-clés et par catégories pour chaque flux
L'intégration Flux RSS suit des sites d'actualités, des blogs, des podcasts et tout ce qui publie un flux RSS 2.0 ou Atom. Macro Deck vérifie vos flux en arrière-plan, conserve leurs derniers articles et les affiche dans des widgets. Vous n'avez besoin d'aucun compte et vous pouvez ajouter autant de flux que vous le souhaitez.
Widgets, actions et déclencheurs
Le widget Liste de flux liste les derniers articles avec leur titre et leur date, et en option le début du texte et une petite image. Le widget Article à la une affiche un article en grand, avec son image, et peut faire défiler à tour de rôle plusieurs des derniers articles. Chaque widget affiche tous les flux, un seul flux ou un groupe de flux. Toucher un article l'ouvre dans le navigateur de l'appareil sur lequel vous l'avez touché, par exemple votre téléphone avec le client web, ou affiche ses détails dans une boîte de dialogue.
L'action Actualiser les flux vérifie immédiatement un flux ou tous les flux. Les déclencheurs réagissent quand un flux a un nouvel article (Nouvel article de flux), quand un flux a été actualisé, quand une actualisation a échoué et quand quelqu'un touche un article sur un widget. Les actions qu'ils lancent peuvent utiliser les valeurs de l'article, comme {{ event.title }} ou {{ event.url }}.
Chaque flux reçoit aussi des variables, par exemple feeds_<feed>_latest_title et feeds_<feed>_unread_count, ainsi que feeds_all_unread_count pour tous les flux réunis.
Quelques exemples de configuration :
- Un widget Liste de flux avec le groupe
News, qui affiche les derniers articles de trois sites d'actualités. - Un widget Article à la une qui passe toutes les 10 secondes au suivant des cinq derniers articles.
- Une automatisation qui se lance sur Nouvel article de flux pour le flux d'un podcast et publie le titre de l'épisode dans un salon Discord avec Envoyer un message par webhook Discord de l'intégration Webhooks Discord.
- Un bouton qui lance Actualiser les flux avant votre routine du matin.
Fonctionnement des actualisations
Chaque flux est vérifié à son propre intervalle, 30 minutes sauf si vous le modifiez, et au plus souvent toutes les 5 minutes. Macro Deck demande au serveur si le flux a changé depuis la dernière vérification, si bien qu'un flux inchangé ne coûte presque rien. Quand une vérification échoue, Macro Deck réessaie au bout d'1 minute, puis attend plus longtemps après chaque nouvel échec, jusqu'à une heure. Les widgets se mettent à jour d'eux-mêmes après chaque actualisation et n'affichent que ce que Macro Deck a déjà récupéré : plus de widgets ne signifie donc pas plus de requêtes.
Les articles qu'un flux contient déjà au moment où vous l'ajoutez ne déclenchent jamais Nouvel article de flux, et un redémarrage ne les déclenche pas non plus. Pour votre sécurité, Macro Deck refuse les adresses de flux situées dans des réseaux locaux et privés, sauf si vous les autorisez pour ce flux.
Ce qu'il vous faut
- Macro Deck 3 sous Windows, macOS ou Linux
- Une connexion Internet sur l'ordinateur qui exécute Macro Deck
- L'adresse d'un flux RSS 2.0 ou Atom
Configuration
Étape 1: Ouvrez l'intégration Flux RSS
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur Flux RSS. Dans l'onglet Aperçu, cliquez sur Ajouter une configuration dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue.
Étape 2: Ajoutez un flux
Remplissez la boîte de dialogue Ajouter un flux :
- Adresse du flux : l'adresse du flux, généralement le lien derrière l'icône RSS d'un site web, par exemple
https://example.com/feed.xml. - Nom de la configuration : le nom du flux dans les widgets, les déclencheurs et les variables. Laissez-le vide pour utiliser le titre propre au flux.
- Groupe : facultatif, par exemple
News. Les flux d'un même groupe peuvent être affichés ensemble dans un widget. - Actualiser toutes les (minutes) : la fréquence à laquelle Macro Deck vérifie le flux, au minimum toutes les 5 minutes.
Sous Configuration avancée, vous pouvez définir Uniquement les articles contenant, Ignorer les articles contenant et Uniquement ces catégories (chacun sous forme de liste séparée par des virgules), ainsi que Autoriser les adresses du réseau local pour un flux servi dans votre propre réseau. Cliquez sur Continuer. Macro Deck lit le flux une fois avant de l'enregistrer.
- Adresse du flux : l'adresse du flux, généralement le lien derrière l'icône RSS d'un site web, par exemple
Étape 3: Ajoutez d'autres flux si nécessaire
Cliquez de nouveau sur Ajouter une configuration pour chaque flux supplémentaire. La liste des configurations indique pour chaque flux si sa dernière actualisation a réussi.
Étape 4: Ajoutez un widget de flux
Sur la page Deck, avec le deck déverrouillé (le bouton Verrouiller s'affiche en haut à droite), ajoutez un widget Liste de flux ou Article à la une. Sous Afficher, choisissez Tous les flux, Un flux ou Un groupe, puis réglez Articles, Afficher la description, Afficher les images et Au toucher.
Étape 5: Ajoutez l'action d'actualisation à un bouton
Pour chercher de nouveaux articles à la demande, cliquez sur un bouton sur la page Deck. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez Flux RSS à gauche de la boîte de dialogue Ajouter une action et choisissez Actualiser les flux. Choisissez un Flux, ou laissez le champ vide pour actualiser tous les flux.
Étape 6: Vérifiez le résultat
Le widget affiche les derniers articles dès que le flux a été lu. Touchez un article pour l'ouvrir sur l'appareil sur lequel vous l'avez touché. Les articles arrivés depuis que vous avez ajouté le flux et que vous n'avez pas encore touchés s'affichent en gras.
Actions1
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Actualiser les flux
- Recherche immédiatement de nouveaux articles, dans tous les flux ou seulement dans celui choisi, et attend le résultat jusqu'à 2 minutes.
Déclencheurs4
Un bouton ou un flux peut réagir à ces événements.
- Nouvel article de flux
- Un flux contient un article qui n'y était pas auparavant. Si de nombreux articles arrivent en même temps, il se déclenche pour les 20 plus récents.
- Flux actualisé
- Les articles d'un flux ont changé lors d'une actualisation. Il transmet l'article le plus récent.
- Échec de l'actualisation du flux
- Un flux n'a pas pu être actualisé, avec un code d'erreur comme
timeoutouhttp-404. - Article de flux ouvert
- Un article a été touché sur un widget Liste de flux ou Article à la une. En option, pour un seul widget.
Variables7
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
feeds_<feed>_latest_title,feeds_<feed>_latest_url,feeds_<feed>_latest_description,feeds_<feed>_latest_author- Le titre, le lien, la description et l'auteur de l'article le plus récent du flux.
feeds_<feed>_latest_published- La date de publication de l'article le plus récent, au format ISO 8601.
feeds_<feed>_item_count- Le nombre d'articles que Macro Deck conserve pour le flux, au maximum 50.
feeds_<feed>_unread_count- Les articles arrivés depuis que vous avez ajouté le flux et qui n'ont été touchés dans aucun widget.
feeds_<feed>_last_updated- La date de la dernière vérification réussie du flux, au format ISO 8601.
feeds_<feed>_update_status- Le résultat de la dernière vérification :
ok,not-modified,error, oupendingavant la première vérification. feeds_all_item_count,feeds_all_unread_count- Le nombre d'articles et d'articles non lus dans tous les flux réunis.
Widgets2
Ajoutez-les à votre deck depuis le sélecteur de widgets.
- Liste de flux
- Liste jusqu'à 10 des derniers articles de tous les flux, d'un flux ou d'un groupe.
- Article à la une
- Affiche en grand l'article le plus récent avec son image, et peut faire défiler à tour de rôle plusieurs des derniers articles.
Questions fréquentes
Où s'ouvre un article quand je le touche ?
Avec Ouvrir dans le navigateur, l'article s'ouvre dans le navigateur de l'appareil sur lequel vous l'avez touché, pas sur l'ordinateur qui exécute Macro Deck. Si cet appareil ne peut pas ouvrir de liens, par exemple un deck matériel, Macro Deck affiche à la place les détails avec l'adresse. Choisissez Afficher les détails ou Exécuter uniquement les actions du widget sous Au toucher pour changer ce comportement.
Pourquoi Macro Deck refuse-t-il l'adresse de mon flux ?
Macro Deck refuse les adresses situées dans des réseaux locaux et privés, comme localhost ou 192.168.…, y compris quand un flux y redirige. Si vous servez le flux vous-même, par exemple depuis un NAS, activez Autoriser les adresses du réseau local pour ce flux sous Configuration avancée. Les autres erreurs indiquent si le flux n'a pas répondu à temps, était injoignable, n'est pas un flux RSS ou Atom, ou dépasse 5 Mo.
Comment les variables sont-elles nommées ?
Les variables de chaque flux portent le nom de configuration qu'il avait quand vous l'avez ajouté, par exemple feeds_tech_news_latest_title. Renommer la configuration plus tard conserve ces noms. L'onglet Variables de l'intégration affiche les noms exacts.
Pourquoi Nouvel article de flux ne s'est-il pas déclenché pour des articles plus anciens ?
Les articles qu'un flux contient déjà quand vous l'ajoutez ne déclenchent jamais Nouvel article de flux, et les articles écartés par vos filtres comptent aussi comme vus. Changer l'adresse d'un flux repart de zéro, comme si vous aviez ajouté un nouveau flux.
Que transmet Macro Deck aux serveurs des flux ?
Macro Deck ne contacte que les flux que vous ajoutez et les serveurs dont proviennent leurs images, avec une requête ordinaire pour le flux. Le texte des articles est affiché en texte brut, et les scripts ou contenus intégrés du flux ne sont jamais exécutés.
Plus dans Maison connectée et web
Home Assistant
Incluse avec Macro DeckAllumez les lumières, lancez des scènes et des scripts, et affichez sur votre deck les états en direct de votre Home Assistant.
AdGuard Home
Incluse avec Macro DeckActivez, désactivez ou mettez en pause la protection AdGuard Home, et affichez ses statistiques sur votre deck.
HTTP
Incluse avec Macro DeckEnvoyez des requêtes HTTP depuis un bouton et enregistrez des valeurs de la réponse dans des variables.
Météo
Incluse avec Macro DeckAffichez sur votre deck la météo actuelle et les prévisions pour vos lieux, sans clé d'API.