RSS kanály
Součást Macro DeckSledujte kanály RSS a Atom, zobrazujte jejich nejnovější články ve widgetech a reagujte na nové články.
Widget Seznam kanálů a widget Vybraný článek s ukázkovými články z kanálu Tech News
- Libovolný počet kanálů RSS 2.0 nebo Atom
- Widgety Seznam kanálů a Vybraný článek
- Článek se otevře na zařízení, na kterém na něj klepnete
- Spouštěče pro nové články a neúspěšné aktualizace
- Filtry podle klíčových slov a kategorií pro každý kanál
Integrace RSS kanály sleduje zpravodajské weby, blogy, podcasty a cokoli dalšího, co zveřejňuje kanál RSS 2.0 nebo Atom. Macro Deck vaše kanály kontroluje na pozadí, uchovává jejich nejnovější články a zobrazuje je ve widgetech. Nepotřebujete žádný účet a kanálů můžete přidat, kolik chcete.
Widgety, akce a spouštěče
Widget Seznam kanálů vypisuje nejnovější články s názvem a datem, volitelně i se začátkem textu a malým obrázkem. Widget Vybraný článek zobrazuje jeden článek ve velkém i s obrázkem a umí střídat několik nejnovějších článků. Každý widget zobrazuje všechny kanály, jeden kanál nebo jednu skupinu kanálů. Klepnutím na článek ho otevřete v prohlížeči zařízení, na kterém jste klepli, například v telefonu s webovým klientem, nebo se jeho podrobnosti zobrazí v dialogu.
Akce Aktualizovat kanály okamžitě zkontroluje jeden kanál nebo všechny. Spouštěče reagují, když má kanál Nový článek v kanálu, když byl kanál aktualizován, když se aktualizace nezdařila a když někdo na widgetu klepne na článek. Akce, které spouštějí, mohou používat hodnoty článku, například {{ event.title }} nebo {{ event.url }}.
Každý kanál má také proměnné, například feeds_<feed>_latest_title a feeds_<feed>_unread_count, a k tomu feeds_all_unread_count pro všechny kanály dohromady.
Několik příkladů použití:
- Widget Seznam kanálů se skupinou
News, který ukazuje nejnovější články tří zpravodajských webů. - Widget Vybraný článek, který každých 10 sekund přepne na další z pěti nejnovějších článků.
- Automatizace, která se spustí při Nový článek v kanálu pro kanál podcastu a pošle název epizody do kanálu na Discordu akcí Odeslat zprávu přes webhook Discordu z integrace Webhooky Discordu.
- Tlačítko, které před vaší ranní rutinou spustí Aktualizovat kanály.
Jak se aktualizuje
Každý kanál se kontroluje ve vlastním intervalu, pokud ho nezměníte, tak každých 30 minut, a nejčastěji každých 5 minut. Macro Deck se serveru ptá, zda se kanál od poslední kontroly změnil, takže nezměněný kanál stojí jen velmi málo. Když kontrola selže, Macro Deck to zkusí znovu po 1 minutě a po každém dalším selhání čeká déle, nejvýše hodinu. Widgety se po každém obnovení aktualizují samy a ukazují jen to, co už Macro Deck načetl, takže více widgetů neznamená více požadavků.
Články, které kanál obsahuje už v okamžiku přidání, nikdy nespustí Nový článek v kanálu a restart je znovu nespustí. Kvůli vaší bezpečnosti Macro Deck odmítá adresy kanálů v místních a soukromých sítích, pokud je pro daný kanál nepovolíte.
Co budete potřebovat
- Macro Deck 3 na Windows, macOS nebo Linuxu
- Připojení k internetu na počítači, na kterém běží Macro Deck
- Adresa kanálu RSS 2.0 nebo Atom
Nastavení
Krok 1: Otevřete integraci RSS kanály
V Macro Deck klikněte na postranním panelu na Integrace a pak na RSS kanály. Na kartě Přehled klikněte v části Konfigurace na Přidat konfiguraci. Stejný dialog otevře i přepínač vpravo nahoře.
Krok 2: Přidejte kanál
Vyplňte dialog Přidat kanál:
- Adresa kanálu: adresa kanálu, obvykle odkaz za ikonou RSS na webu, například
https://example.com/feed.xml. - Název konfigurace: jak se kanál jmenuje ve widgetech, spouštěčích a proměnných. Nechte prázdné a použije se vlastní název kanálu.
- Skupina: volitelné, například
News. Kanály se stejnou skupinou lze zobrazit společně v jednom widgetu. - Obnovovat každých (minut): jak často Macro Deck kanál kontroluje, nejméně po 5 minutách.
V části Pokročilá konfigurace můžete nastavit Pouze články obsahující, Přeskočit články obsahující a Pouze tyto kategorie (každé jako seznam oddělený čárkami) a Povolit adresy v místní síti pro kanál, který běží ve vaší vlastní síti. Klikněte na Pokračovat. Macro Deck kanál před uložením jednou načte.
- Adresa kanálu: adresa kanálu, obvykle odkaz za ikonou RSS na webu, například
Krok 3: Podle potřeby přidejte další kanály
Pro každý další kanál klikněte znovu na Přidat konfiguraci. Seznam konfigurací u každého kanálu ukazuje, zda jeho poslední obnovení proběhlo úspěšně.
Krok 4: Přidejte widget kanálu
Na stránce Deck při odemčeném decku (vpravo nahoře se zobrazuje tlačítko Uzamknout) přidejte widget Seznam kanálů nebo Vybraný článek. V poli Zobrazit zvolte Všechny kanály, Jeden kanál nebo Jedna skupina a nastavte Články, Zobrazit popis, Zobrazit obrázky a Při klepnutí.
Krok 5: Přidejte akci obnovení na tlačítko
Chcete-li nové články kontrolovat na požádání, klikněte na stránce Deck na tlačítko. Otevře se editor s vybranou možností Krátké stisknutí. Klikněte na + Přidat akci, v dialogu Přidat akci vlevo vyberte RSS kanály a zvolte Aktualizovat kanály. V poli Kanál vyberte kanál, nebo ho nechte prázdné a obnoví se všechny kanály.
Krok 6: Zkontrolujte výsledek
Jakmile se kanál načte, widget ukáže nejnovější články. Klepnutím na článek ho otevřete na zařízení, na kterém jste klepli. Články, které přibyly od přidání kanálu a na které jste ještě neklepli, jsou zobrazeny tučně.
Akce1
Umístěte je na tlačítko nebo je spusťte z postupu.
- Aktualizovat kanály
- Okamžitě zkontroluje nové články ve všech kanálech nebo jen ve vybraném a na výsledek čeká až 2 minuty.
Triggery4
Tlačítko nebo postup může na tyto události reagovat.
- Nový článek v kanálu
- Kanál má článek, který v něm předtím nebyl. Při mnoha nových článcích najednou se spustí pro 20 nejnovějších.
- Kanál aktualizován
- Při obnovení se změnily články kanálu. Nese nejnovější článek.
- Aktualizace kanálu selhala
- Kanál se nepodařilo obnovit, s kódem chyby, například
timeoutnebohttp-404. - Článek z kanálu otevřen
- Na widgetu Seznam kanálů nebo Vybraný článek někdo klepl na článek. Volitelně jen pro jeden widget.
Proměnné7
Zobrazte tyto hodnoty na tlačítkách a widgetech nebo je použijte v podmínkách.
feeds_<feed>_latest_title,feeds_<feed>_latest_url,feeds_<feed>_latest_description,feeds_<feed>_latest_author- Název, odkaz, popis a autor nejnovějšího článku kanálu.
feeds_<feed>_latest_published- Kdy byl nejnovější článek zveřejněn, jako čas ve formátu ISO 8601.
feeds_<feed>_item_count- Kolik článků si Macro Deck pro kanál uchovává, nejvýše 50.
feeds_<feed>_unread_count- Články, které přibyly od přidání kanálu a na které nikdo ve widgetu neklepl.
feeds_<feed>_last_updated- Kdy byl kanál naposledy úspěšně zkontrolován, jako čas ve formátu ISO 8601.
feeds_<feed>_update_status- Výsledek poslední kontroly:
ok,not-modified,error, nebopendingpřed první kontrolou. feeds_all_item_count,feeds_all_unread_count- Počet článků a nepřečtených článků ve všech kanálech dohromady.
Widgety2
Přidejte je na svůj deck z výběru widgetů.
- Seznam kanálů
- Vypisuje až 10 nejnovějších článků ze všech kanálů, z jednoho kanálu nebo z jedné skupiny.
- Vybraný článek
- Zobrazuje nejnovější článek ve velkém i s obrázkem a umí střídat několik nejnovějších článků.
Často kladené dotazy
Kde se článek otevře, když na něj klepnu?
S možností Otevřít v prohlížeči se článek otevře v prohlížeči zařízení, na kterém jste klepli, ne na počítači, na kterém běží Macro Deck. Když toto zařízení odkazy otevírat neumí, například hardwarový deck, Macro Deck místo toho zobrazí podrobnosti s adresou. Chcete-li to změnit, zvolte v poli Při klepnutí možnost Zobrazit podrobnosti nebo Pouze spustit akce widgetu.
Proč Macro Deck odmítá adresu mého kanálu?
Macro Deck odmítá adresy v místních a soukromých sítích, například localhost nebo 192.168.…, a to i tehdy, když na ně kanál přesměrovává. Pokud kanál poskytujete sami, například z NAS, zapněte pro tento kanál v části Pokročilá konfigurace možnost Povolit adresy v místní síti. Ostatní chyby říkají, zda kanál neodpověděl včas, nebyl dosažitelný, není kanálem RSS ani Atom, nebo je větší než 5 MB.
Jak se proměnné jmenují?
Proměnné každého kanálu se jmenují podle názvu konfigurace, který měl při přidání, například feeds_tech_news_latest_title. Pozdější přejmenování konfigurace názvy zachová. Přesné názvy ukazuje karta Proměnné integrace.
Proč se Nový článek v kanálu nespustil pro starší články?
Články, které kanál obsahuje už při přidání, nikdy nespustí Nový článek v kanálu, a články vyřazené vašimi filtry se také počítají jako viděné. Změna adresy kanálu začne znovu od začátku, jako byste přidali nový kanál.
Co Macro Deck posílá serverům kanálů?
Macro Deck kontaktuje jen kanály, které přidáte, a servery, ze kterých pocházejí jejich obrázky, a to běžným požadavkem na kanál. Text článků se zobrazuje jako prostý text a skripty ani vložený obsah kanálu se nikdy nespouštějí.
Další v kategorii Chytrá domácnost a web
Home Assistant
Součást Macro DeckPřepínejte světla, spouštějte scény a skripty a zobrazujte živé stavy z Home Assistant na decku.
AdGuard Home
Součást Macro DeckZapínejte, vypínejte a pozastavujte ochranu AdGuard Home a zobrazujte její statistiky na decku.
HTTP
Součást Macro DeckPosílejte z tlačítka HTTP požadavky a ukládejte hodnoty z odpovědi do proměnných.
Počasí
Součást Macro DeckZobrazujte aktuální počasí a předpověď pro svá místa na decku, bez klíče API.