Kanały RSS
Dołączona do Macro DeckObserwuj kanały RSS i Atom, pokazuj ich najnowsze artykuły w widżetach i reaguj na pojawienie się nowych artykułów.
Widżet Lista kanałów i widżet Wyróżniony artykuł z przykładowymi artykułami z kanału Tech News
- Obserwowanie dowolnej liczby kanałów RSS 2.0 lub Atom
- Widżety Lista kanałów i Wyróżniony artykuł
- Otwieranie artykułu na urządzeniu, na którym go dotknięto
- Wyzwalacze dla nowych artykułów i nieudanych aktualizacji
- Filtry słów kluczowych i kategorii dla każdego kanału
Integracja Kanały RSS obserwuje serwisy informacyjne, blogi, podcasty i wszystko inne, co publikuje kanał RSS 2.0 lub Atom. Macro Deck sprawdza kanały w tle, przechowuje ich najnowsze artykuły i pokazuje je w widżetach. Konto nie jest potrzebne, a kanałów można dodać dowolnie wiele.
Widżety, akcje i wyzwalacze
Widżet Lista kanałów wyświetla najnowsze artykuły z tytułem i datą, a opcjonalnie także początek tekstu i mały obraz. Widżet Wyróżniony artykuł pokazuje jeden artykuł w dużym formacie, z obrazem, i może pokazywać na zmianę kilka najnowszych artykułów. Każdy widżet pokazuje wszystkie kanały, jeden kanał lub jedną grupę kanałów. Dotknięcie artykułu otwiera go w przeglądarce urządzenia, na którym go dotknięto, na przykład na telefonie z klientem webowym, albo pokazuje jego szczegóły w oknie.
Akcja Aktualizuj kanały od razu sprawdza jeden kanał lub wszystkie. Wyzwalacze reagują, gdy w kanale pojawi się nowy artykuł (Nowy artykuł w kanale), gdy kanał został zaktualizowany, gdy aktualizacja się nie powiodła i gdy ktoś dotknie artykułu na widżecie. Uruchamiane przez nie akcje mogą korzystać z wartości artykułu, na przykład {{ event.title }} lub {{ event.url }}.
Każdy kanał otrzymuje też zmienne, na przykład feeds_<feed>_latest_title i feeds_<feed>_unread_count, a do tego feeds_all_unread_count dla wszystkich kanałów razem.
Przykładowe zastosowania:
- Widżet Lista kanałów z grupą
News, pokazujący najnowsze artykuły z trzech serwisów informacyjnych. - Widżet Wyróżniony artykuł, który co 10 sekund przechodzi do kolejnego z pięciu najnowszych artykułów.
- Automatyzacja uruchamiana przez Nowy artykuł w kanale dla kanału podcastu, która publikuje tytuł odcinka na kanale Discorda akcją Wyślij wiadomość przez webhook Discorda z integracji Webhooki Discorda.
- Przycisk, który uruchamia Aktualizuj kanały przed poranną rutyną.
Jak działa aktualizacja
Każdy kanał jest sprawdzany we własnym odstępie czasu, domyślnie co 30 minut i nie częściej niż co 5 minut. Macro Deck pyta serwer, czy kanał zmienił się od ostatniego sprawdzenia, więc niezmieniony kanał kosztuje bardzo niewiele. Gdy sprawdzenie się nie powiedzie, Macro Deck próbuje ponownie po 1 minucie, a po każdej kolejnej porażce czeka dłużej, maksymalnie godzinę. Widżety odświeżają się same po każdej aktualizacji i pokazują tylko to, co Macro Deck już pobrał, więc więcej widżetów nie oznacza więcej zapytań.
Artykuły, które kanał zawiera już w chwili dodania, nigdy nie uruchamiają Nowy artykuł w kanale, a ponowne uruchomienie też nie uruchamia ich ponownie. Ze względów bezpieczeństwa Macro Deck odrzuca adresy kanałów w sieciach lokalnych i prywatnych, chyba że zezwolono na nie dla danego kanału.
Czego potrzebujesz
- Macro Deck 3 w systemie Windows, macOS lub Linux
- Połączenie z internetem na komputerze, na którym działa Macro Deck
- Adres kanału RSS 2.0 lub Atom
Konfiguracja krok po kroku
Krok 1: Otwórz integrację Kanały RSS
W Macro Deck kliknij Integracje na pasku bocznym, a następnie Kanały RSS. Na karcie Przegląd kliknij Dodaj konfigurację w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno.
Krok 2: Dodaj kanał
Wypełnij okno Dodaj kanał:
- Adres kanału: adres kanału, zwykle link pod ikoną RSS na stronie internetowej, np.
https://example.com/feed.xml. - Nazwa konfiguracji: nazwa kanału w widżetach, wyzwalaczach i zmiennych. Pozostaw pole puste, aby użyć tytułu samego kanału.
- Grupa: opcjonalnie, np.
News. Kanały z tej samej grupy można pokazać razem w jednym widżecie. - Odświeżaj co (minuty): jak często Macro Deck sprawdza kanał, co najmniej co 5 minut.
W sekcji Konfiguracja zaawansowana można ustawić Tylko artykuły zawierające, Pomijaj artykuły zawierające i Tylko te kategorie (każde jako lista rozdzielona przecinkami) oraz Zezwalaj na adresy w sieci lokalnej dla kanału udostępnianego we własnej sieci. Kliknij Dalej. Macro Deck odczytuje kanał raz przed jego zapisaniem.
- Adres kanału: adres kanału, zwykle link pod ikoną RSS na stronie internetowej, np.
Krok 3: W razie potrzeby dodaj kolejne kanały
Kliknij ponownie Dodaj konfigurację dla każdego kolejnego kanału. Lista konfiguracji pokazuje dla każdego kanału, czy jego ostatnia aktualizacja się udała.
Krok 4: Dodaj widżet kanałów
Na stronie Deck, przy odblokowanym decku (w prawym górnym rogu widać przycisk Zablokuj), dodaj widżet Lista kanałów lub Wyróżniony artykuł. W polu Pokaż wybierz Wszystkie kanały, Jeden kanał lub Jedna grupa i ustaw Artykuły, Pokaż opis, Pokaż obrazy oraz Po dotknięciu.
Krok 5: Dodaj akcję odświeżania do przycisku
Aby sprawdzać nowe artykuły na żądanie, kliknij przycisk na stronie Deck. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz Kanały RSS i wybierz Aktualizuj kanały. Wybierz kanał w polu Kanał albo pozostaw je puste, aby odświeżyć wszystkie kanały.
Krok 6: Sprawdź wynik
Widżet pokazuje najnowsze artykuły, gdy tylko kanał zostanie odczytany. Dotknij artykułu, aby otworzyć go na urządzeniu, na którym go dotknięto. Artykuły, które pojawiły się od dodania kanału i których jeszcze nie dotknięto, są wyświetlane pogrubioną czcionką.
Akcje1
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Aktualizuj kanały
- Natychmiast sprawdza nowe artykuły we wszystkich kanałach lub tylko w wybranym i czeka na wynik do 2 minut.
Wyzwalacze4
Przycisk lub przebieg może reagować na te zdarzenia.
- Nowy artykuł w kanale
- W kanale pojawił się artykuł, którego wcześniej nie było. Przy wielu nowych artykułach naraz uruchamia się dla 20 najnowszych.
- Kanał zaktualizowany
- Artykuły kanału zmieniły się podczas odświeżania. Przekazuje najnowszy artykuł.
- Aktualizacja kanału nie powiodła się
- Nie można odświeżyć kanału, z kodem błędu takim jak
timeoutlubhttp-404. - Otwarto artykuł z kanału
- Dotknięto artykułu na widżecie Lista kanałów lub Wyróżniony artykuł. Opcjonalnie tylko dla jednego widżetu.
Zmienne7
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
feeds_<feed>_latest_title,feeds_<feed>_latest_url,feeds_<feed>_latest_description,feeds_<feed>_latest_author- Tytuł, link, opis i autor najnowszego artykułu kanału.
feeds_<feed>_latest_published- Kiedy opublikowano najnowszy artykuł, jako czas w formacie ISO 8601.
feeds_<feed>_item_count- Ile artykułów Macro Deck przechowuje dla kanału, maksymalnie 50.
feeds_<feed>_unread_count- Artykuły, które pojawiły się od dodania kanału i nie zostały dotknięte w żadnym widżecie.
feeds_<feed>_last_updated- Kiedy kanał został ostatnio pomyślnie sprawdzony, jako czas w formacie ISO 8601.
feeds_<feed>_update_status- Wynik ostatniego sprawdzenia:
ok,not-modified,errorlubpendingprzed pierwszym sprawdzeniem. feeds_all_item_count,feeds_all_unread_count- Liczba artykułów i nieprzeczytanych artykułów we wszystkich kanałach razem.
Widżety2
Dodaj je do decku z selektora widżetów.
- Lista kanałów
- Wyświetla do 10 najnowszych artykułów ze wszystkich kanałów, z jednego kanału lub z jednej grupy.
- Wyróżniony artykuł
- Pokazuje najnowszy artykuł w dużym formacie z obrazem i może pokazywać na zmianę kilka najnowszych artykułów.
Najczęściej zadawane pytania
Gdzie otwiera się artykuł po jego dotknięciu?
Przy ustawieniu Otwórz w przeglądarce artykuł otwiera się w przeglądarce urządzenia, na którym go dotknięto, a nie na komputerze, na którym działa Macro Deck. Jeśli to urządzenie nie może otwierać linków, na przykład sprzętowy deck, Macro Deck pokazuje zamiast tego szczegóły z adresem. Aby to zmienić, wybierz w polu Po dotknięciu opcję Pokaż szczegóły lub Tylko uruchom akcje widżetu.
Dlaczego Macro Deck odrzuca adres kanału?
Macro Deck odrzuca adresy w sieciach lokalnych i prywatnych, takie jak localhost lub 192.168.…, także gdy kanał przekierowuje pod taki adres. Jeśli kanał jest udostępniany samodzielnie, na przykład z serwera NAS, włącz dla tego kanału Zezwalaj na adresy w sieci lokalnej w sekcji Konfiguracja zaawansowana. Inne błędy informują, czy kanał nie odpowiedział na czas, był nieosiągalny, nie jest kanałem RSS ani Atom lub jest większy niż 5 MB.
Jak nazywają się zmienne?
Zmienne każdego kanału są nazwane od nazwy konfiguracji, jaką miał w chwili dodania, na przykład feeds_tech_news_latest_title. Późniejsza zmiana nazwy konfiguracji nie zmienia tych nazw. Karta Zmienne integracji pokazuje dokładne nazwy.
Dlaczego Nowy artykuł w kanale nie uruchomił się dla starszych artykułów?
Artykuły, które kanał zawiera już w chwili dodania, nigdy nie uruchamiają Nowy artykuł w kanale, a artykuły pominięte przez filtry również są traktowane jako widziane. Zmiana adresu kanału zaczyna wszystko od nowa, tak jakby dodano nowy kanał.
Co Macro Deck wysyła do serwerów kanałów?
Macro Deck łączy się tylko z dodanymi kanałami i serwerami, z których pochodzą ich obrazy, wysyłając zwykłe zapytanie o kanał. Tekst artykułów jest wyświetlany jako zwykły tekst, a skrypty i osadzone treści kanału nigdy nie są uruchamiane.
Więcej w kategorii Inteligentny dom i internet
Home Assistant
Dołączona do Macro DeckPrzełączaj światła, uruchamiaj sceny i skrypty oraz wyświetlaj na decku bieżące stany z Home Assistant.
AdGuard Home
Dołączona do Macro DeckWłączaj, wyłączaj i wstrzymuj ochronę AdGuard Home oraz wyświetlaj jego statystyki na decku.
HTTP
Dołączona do Macro DeckWysyłaj żądania HTTP z przycisku i zapisuj wartości z odpowiedzi w zmiennych.
Pogoda
Dołączona do Macro DeckWyświetlaj na decku bieżącą pogodę i prognozę dla wybranych lokalizacji, bez klucza API.