RSS-ленты
Входит в Macro DeckСледите за лентами RSS и Atom, показывайте их новейшие статьи в виджетах и реагируйте на появление новых статей.
Виджет «Список лент» и виджет «Избранная статья» с примерами статей из ленты Tech News
- Любые ленты RSS 2.0 или Atom в любом количестве
- Виджеты «Список лент» и «Избранная статья»
- Статья открывается на том устройстве, на котором вы её нажали
- Триггеры для новых статей и неудачных обновлений
- Фильтры по ключевым словам и категориям для каждой ленты
Интеграция «RSS-ленты» следит за новостными сайтами, блогами, подкастами и всем остальным, что публикует ленту RSS 2.0 или Atom. Macro Deck проверяет ваши ленты в фоне, хранит их новейшие статьи и показывает их в виджетах. Аккаунт не нужен, а лент можно добавить сколько угодно.
Виджеты, действия и триггеры
Виджет Список лент показывает новейшие статьи с заголовком и датой, а при желании и с началом текста и небольшим изображением. Виджет Избранная статья показывает одну статью крупно, с изображением, и может по очереди показывать несколько новейших статей. Каждый виджет показывает все ленты, одну ленту или одну группу лент. Нажатие на статью открывает её в браузере того устройства, на котором вы нажали, например на телефоне с веб-клиентом, или показывает подробности о ней в диалоге.
Действие Обновить ленты сразу проверяет одну ленту или все. Триггеры срабатывают, когда в ленте появилась Новая статья в ленте, когда лента обновлена, когда обновление не удалось и когда кто-то нажал на статью в виджете. Запускаемые ими действия могут использовать значения статьи, например {{ event.title }} или {{ event.url }}.
У каждой ленты также есть переменные, например feeds_<feed>_latest_title и feeds_<feed>_unread_count, а также feeds_all_unread_count для всех лент вместе.
Несколько примеров:
- Виджет Список лент с группой
News, который показывает новейшие статьи трёх новостных сайтов. - Виджет Избранная статья, который каждые 10 секунд переключается на следующую из пяти новейших статей.
- Автоматизация, которая запускается по триггеру Новая статья в ленте для ленты подкаста и публикует название выпуска в канал Discord действием Отправить сообщение через вебхук Discord из интеграции «Вебхуки Discord».
- Кнопка, которая выполняет Обновить ленты перед вашей утренней рутиной.
Как происходит обновление
Каждая лента проверяется со своим интервалом: каждые 30 минут, если вы его не измените, и не чаще чем раз в 5 минут. Macro Deck спрашивает сервер, изменилась ли лента с последней проверки, поэтому неизменённая лента почти ничего не стоит. Если проверка не удалась, Macro Deck повторяет её через 1 минуту, а после каждой следующей неудачи ждёт дольше, до часа. Виджеты обновляются сами после каждого обновления и показывают только то, что Macro Deck уже загрузил, поэтому больше виджетов не означает больше запросов.
Статьи, которые уже есть в ленте при её добавлении, никогда не вызывают Новая статья в ленте, и перезапуск не вызывает их снова. В целях безопасности Macro Deck отклоняет адреса лент в локальных и частных сетях, если вы не разрешите их для этой ленты.
Что понадобится
- Macro Deck 3 на Windows, macOS или Linux
- Подключение к интернету на компьютере, где работает Macro Deck
- Адрес ленты RSS 2.0 или Atom
Настройка
Шаг 1: Откройте интеграцию «RSS-ленты»
В Macro Deck нажмите Интеграции на боковой панели и выберите RSS-ленты. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог.
Шаг 2: Добавьте ленту
Заполните диалог Добавить ленту:
- Адрес ленты: адрес ленты, обычно это ссылка за значком RSS на сайте, например
https://example.com/feed.xml. - Название настройки: как лента называется в виджетах, триггерах и переменных. Оставьте поле пустым, чтобы использовать собственный заголовок ленты.
- Группа: необязательно, например
News. Ленты с одной группой можно показывать вместе в одном виджете. - Обновлять каждые (минуты): как часто Macro Deck проверяет ленту, не чаще чем раз в 5 минут.
В разделе Дополнительная настройка можно задать Только статьи, содержащие, Пропускать статьи, содержащие и Только эти категории (каждое поле принимает список через запятую), а также Разрешить адреса в локальной сети для ленты, которая размещена в вашей собственной сети. Нажмите Продолжить. Перед сохранением Macro Deck один раз читает ленту.
- Адрес ленты: адрес ленты, обычно это ссылка за значком RSS на сайте, например
Шаг 3: При необходимости добавьте другие ленты
Снова нажмите Добавить настройку для каждой следующей ленты. Список настроек показывает для каждой ленты, успешно ли прошло её последнее обновление.
Шаг 4: Добавьте виджет ленты
На странице Панель при разблокированной панели (в правом верхнем углу показана кнопка Заблокировать) добавьте виджет Список лент или Избранная статья. В поле Показывать выберите Все ленты, Одна лента или Одна группа и задайте Статьи, Показывать описание, Показывать изображения и При нажатии.
Шаг 5: Добавьте действие обновления на кнопку
Чтобы проверять новые статьи по запросу, нажмите на кнопку на странице Панель. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите RSS-ленты и затем Обновить ленты. Выберите ленту в поле Лента или оставьте его пустым, чтобы обновить все ленты.
Шаг 6: Проверьте результат
Как только лента прочитана, виджет показывает новейшие статьи. Нажмите на статью, чтобы открыть её на том устройстве, на котором вы нажали. Статьи, которые появились после добавления ленты и на которые вы ещё не нажимали, выделены жирным.
Действия1
Назначьте их на кнопку или запускайте из цепочки действий.
- Обновить ленты
- Сразу проверяет новые статьи во всех лентах или только в выбранной и ждёт результата до 2 минут.
Триггеры4
Кнопка или цепочка действий может реагировать на эти события.
- Новая статья в ленте
- В ленте появилась статья, которой раньше не было. Если новых статей сразу много, срабатывает для 20 новейших.
- Лента обновлена
- При обновлении изменились статьи ленты. Передаёт новейшую статью.
- Не удалось обновить ленту
- Ленту не удалось обновить, с кодом ошибки, например
timeoutилиhttp-404. - Статья из ленты открыта
- Кто-то нажал на статью в виджете «Список лент» или «Избранная статья». При желании только для одного виджета.
Переменные7
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
feeds_<feed>_latest_title,feeds_<feed>_latest_url,feeds_<feed>_latest_description,feeds_<feed>_latest_author- Заголовок, ссылка, описание и автор новейшей статьи ленты.
feeds_<feed>_latest_published- Когда опубликована новейшая статья, в виде времени ISO 8601.
feeds_<feed>_item_count- Сколько статей Macro Deck хранит для ленты, не больше 50.
feeds_<feed>_unread_count- Статьи, которые появились после добавления ленты и на которые ещё не нажимали в виджете.
feeds_<feed>_last_updated- Когда лента в последний раз успешно проверялась, в виде времени ISO 8601.
feeds_<feed>_update_status- Результат последней проверки:
ok,not-modified,errorилиpendingдо первой проверки. feeds_all_item_count,feeds_all_unread_count- Число статей и непрочитанных статей во всех лентах вместе.
Виджеты2
Добавляйте их на свою панель в окне выбора виджета.
- Список лент
- Показывает до 10 новейших статей из всех лент, одной ленты или одной группы.
- Избранная статья
- Показывает новейшую статью крупно, с изображением, и может по очереди показывать несколько новейших статей.
Часто задаваемые вопросы
Где открывается статья, когда я на неё нажимаю?
С вариантом Открыть в браузере статья открывается в браузере того устройства, на котором вы нажали, а не на компьютере, где работает Macro Deck. Если это устройство не умеет открывать ссылки, например аппаратная панель, Macro Deck вместо этого показывает подробности с адресом. Чтобы изменить это, выберите в поле При нажатии вариант Показать подробности или Только выполнить действия виджета.
Почему Macro Deck отклоняет адрес моей ленты?
Macro Deck отклоняет адреса в локальных и частных сетях, например localhost или 192.168.…, в том числе когда лента перенаправляет туда. Если вы размещаете ленту сами, например на NAS, включите для этой ленты Разрешить адреса в локальной сети в разделе Дополнительная настройка. Другие ошибки сообщают, что лента не ответила вовремя, оказалась недоступна, не является лентой RSS или Atom или больше 5 МБ.
Как называются переменные?
Переменные каждой ленты называются по названию настройки, которое было у неё при добавлении, например feeds_tech_news_latest_title. Если позже переименовать настройку, названия сохранятся. Точные названия показывает вкладка Переменные интеграции.
Почему «Новая статья в ленте» не сработала для старых статей?
Статьи, которые уже есть в ленте при её добавлении, никогда не вызывают Новая статья в ленте, а статьи, отсеянные вашими фильтрами, тоже считаются просмотренными. Изменение адреса ленты начинает всё заново, как если бы вы добавили новую ленту.
Что Macro Deck отправляет серверам лент?
Macro Deck обращается только к добавленным вами лентам и к серверам, с которых загружаются их изображения, обычным запросом ленты. Текст статей показывается как простой текст, а скрипты и встроенное содержимое ленты никогда не выполняются.
Ещё в группе «Умный дом и веб»
Home Assistant
Входит в Macro DeckВключайте свет, запускайте сцены и скрипты и показывайте на панели живые состояния из Home Assistant.
AdGuard Home
Входит в Macro DeckВключайте, выключайте или приостанавливайте защиту AdGuard Home и показывайте его статистику на панели.
HTTP
Входит в Macro DeckОтправляйте HTTP-запросы одной кнопкой и сохраняйте значения из ответа в переменные.
Погода
Входит в Macro DeckПоказывайте на панели текущую погоду и прогноз для своих мест без ключа API.