Feeds RSS
Incluída no Macro DeckAcompanhe feeds RSS e Atom, mostre os artigos mais recentes em widgets e reaja quando chegam artigos novos.
Um widget Lista de feeds e um widget Artigo em destaque com artigos de exemplo de um feed Tech News
- Acompanhe qualquer feed RSS 2.0 ou Atom, quantos quiser
- Widgets Lista de feeds e Artigo em destaque
- Abra um artigo no dispositivo em que você tocou nele
- Gatilhos para artigos novos e atualizações com falha
- Filtros por palavra-chave e categoria em cada feed
A integração Feeds RSS acompanha sites de notícias, blogs, podcasts e qualquer outra coisa que publique um feed RSS 2.0 ou Atom. O Macro Deck verifica os seus feeds em segundo plano, guarda os artigos mais recentes e os mostra em widgets. Não é preciso conta, e você pode adicionar quantos feeds quiser.
Widgets, ações e gatilhos
O widget Lista de feeds lista os artigos mais recentes com título e data e, se quiser, o início do texto e uma pequena imagem. O widget Artigo em destaque mostra um artigo em tamanho grande, com a imagem, e pode alternar entre vários dos artigos mais recentes. Cada widget mostra todos os feeds, um feed ou um grupo de feeds. Tocar em um artigo o abre no navegador do dispositivo em que você tocou, por exemplo o seu celular com o cliente web, ou mostra os detalhes dele em uma caixa de diálogo.
A ação Atualizar feeds verifica um feed ou todos na hora. Os gatilhos reagem quando um feed tem um Novo artigo do feed, quando um feed foi atualizado, quando uma atualização falhou e quando alguém toca em um artigo em um widget. As ações executadas podem usar os valores do artigo, como {{ event.title }} ou {{ event.url }}.
Cada feed também ganha variáveis, por exemplo feeds_<feed>_latest_title e feeds_<feed>_unread_count, além de feeds_all_unread_count para todos os feeds juntos.
Alguns exemplos de uso:
- Um widget Lista de feeds com o grupo
News, mostrando os artigos mais recentes de três sites de notícias. - Um widget Artigo em destaque que passa para o próximo dos cinco artigos mais recentes a cada 10 segundos.
- Uma automação que roda em Novo artigo do feed para o feed de um podcast e publica o título do episódio em um canal do Discord com Enviar mensagem por webhook do Discord, da integração Webhooks do Discord.
- Um botão que executa Atualizar feeds antes da sua rotina da manhã.
Como é atualizado
Cada feed é verificado no seu próprio intervalo, 30 minutos se você não mudar, e no máximo a cada 5 minutos. O Macro Deck pergunta ao servidor se o feed mudou desde a última verificação, então um feed sem mudanças custa muito pouco. Quando uma verificação falha, o Macro Deck tenta de novo depois de 1 minuto e espera mais a cada nova falha, até uma hora. Os widgets se atualizam sozinhos depois de cada atualização e só mostram o que o Macro Deck já buscou, então mais widgets não significam mais requisições.
Os artigos que um feed já tem quando você o adiciona nunca disparam Novo artigo do feed, e reiniciar não os dispara de novo. Para a sua segurança, o Macro Deck recusa endereços de feed em redes locais e privadas, a menos que você os permita para aquele feed.
O que é necessário
- Macro Deck 3 no Windows, macOS ou Linux
- Uma conexão com a internet no computador em que o Macro Deck está rodando
- O endereço de um feed RSS 2.0 ou Atom
Configuração
Passo 1: Abra a integração Feeds RSS
No Macro Deck, clique em Integrações na barra lateral e depois em Feeds RSS. Na aba Visão geral, clique em Adicionar configuração na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo.
Passo 2: Adicione um feed
Preencha a caixa de diálogo Adicionar um feed:
- Endereço do feed: o endereço do feed, geralmente o link por trás do ícone de RSS de um site, por exemplo
https://example.com/feed.xml. - Nome da configuração: como o feed se chama em widgets, gatilhos e variáveis. Deixe vazio para usar o título do próprio feed.
- Grupo: opcional, por exemplo
News. Feeds do mesmo grupo podem ser mostrados juntos em um widget. - Atualizar a cada (minutos): com que frequência o Macro Deck verifica o feed, no mínimo a cada 5 minutos.
Em Configuração avançada, é possível definir Somente artigos contendo, Ignorar artigos contendo e Somente estas categorias (cada um como uma lista separada por vírgulas), e Permitir endereços da rede local para um feed servido na sua própria rede. Clique em Continuar. O Macro Deck lê o feed uma vez antes de salvá-lo.
- Endereço do feed: o endereço do feed, geralmente o link por trás do ícone de RSS de um site, por exemplo
Passo 3: Adicione mais feeds, se precisar
Clique de novo em Adicionar configuração para cada feed adicional. A lista de configurações mostra, para cada feed, se a última atualização funcionou.
Passo 4: Adicione um widget de feed
Na página Deck, com o deck desbloqueado (o botão Bloquear aparece no canto superior direito), adicione um widget Lista de feeds ou Artigo em destaque. Em Mostrar, escolha Todos os feeds, Um feed ou Um grupo e defina Artigos, Mostrar descrição, Mostrar imagens e Ao tocar.
Passo 5: Adicione a ação de atualização a um botão
Para verificar artigos novos quando quiser, clique em um botão na página Deck. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Feeds RSS à esquerda da caixa de diálogo Adicionar ação e escolha Atualizar feeds. Escolha um Feed, ou deixe vazio para atualizar todos os feeds.
Passo 6: Confira o resultado
O widget mostra os artigos mais recentes assim que o feed é lido. Toque em um artigo para abri-lo no dispositivo em que você tocou. Os artigos que chegaram desde que você adicionou o feed e em que você ainda não tocou aparecem em negrito.
Ações1
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Atualizar feeds
- Verifica na hora se há artigos novos, em todos os feeds ou só no escolhido, e espera até 2 minutos pelo resultado.
Gatilhos4
Um botão ou fluxo pode reagir a estes eventos.
- Novo artigo do feed
- Um feed tem um artigo que não estava lá antes. Com muitos artigos novos de uma vez, dispara para os 20 mais recentes.
- Feed atualizado
- Os artigos de um feed mudaram em uma atualização. Traz o artigo mais recente.
- Falha ao atualizar o feed
- Não foi possível atualizar um feed, com um código de erro como
timeoutouhttp-404. - Artigo do feed aberto
- Alguém tocou em um artigo em um widget Lista de feeds ou Artigo em destaque. Opcionalmente só para um widget.
Variáveis7
Mostre estes valores em botões e widgets ou use-os em condições.
feeds_<feed>_latest_title,feeds_<feed>_latest_url,feeds_<feed>_latest_description,feeds_<feed>_latest_author- O título, o link, a descrição e o autor do artigo mais recente do feed.
feeds_<feed>_latest_published- Quando o artigo mais recente foi publicado, como horário ISO 8601.
feeds_<feed>_item_count- Quantos artigos o Macro Deck guarda para o feed, no máximo 50.
feeds_<feed>_unread_count- Artigos que chegaram desde que você adicionou o feed e em que ninguém tocou em um widget.
feeds_<feed>_last_updated- Quando o feed foi verificado com sucesso pela última vez, como horário ISO 8601.
feeds_<feed>_update_status- O resultado da última verificação:
ok,not-modified,error, oupendingantes da primeira verificação. feeds_all_item_count,feeds_all_unread_count- O número de artigos e de artigos não lidos em todos os feeds juntos.
Widgets2
Adicione estes widgets ao seu deck pelo seletor de widgets.
- Lista de feeds
- Lista até 10 dos artigos mais recentes de todos os feeds, de um feed ou de um grupo.
- Artigo em destaque
- Mostra o artigo mais recente em tamanho grande, com a imagem, e pode alternar entre vários dos artigos mais recentes.
Perguntas frequentes
Onde um artigo abre quando toco nele?
Com Abrir no navegador, o artigo abre no navegador do dispositivo em que você tocou, não no computador em que o Macro Deck está rodando. Quando esse dispositivo não consegue abrir links, por exemplo um deck físico, o Macro Deck mostra os detalhes com o endereço. Escolha Mostrar detalhes ou Executar somente as ações do widget em Ao tocar para mudar isso.
Por que o Macro Deck recusa o endereço do meu feed?
O Macro Deck recusa endereços em redes locais e privadas, como localhost ou 192.168.…, também quando um feed redireciona para lá. Se você mesmo serve o feed, por exemplo de um NAS, ative Permitir endereços da rede local para esse feed em Configuração avançada. Os outros erros dizem se o feed não respondeu a tempo, não pôde ser acessado, não é um feed RSS ou Atom ou tem mais de 5 MB.
Como as variáveis são nomeadas?
As variáveis de cada feed recebem o nome da configuração que ele tinha quando foi adicionado, por exemplo feeds_tech_news_latest_title. Renomear a configuração depois mantém os nomes. A aba Variáveis da integração mostra os nomes exatos.
Por que Novo artigo do feed não disparou para artigos mais antigos?
Os artigos que um feed já tem quando você o adiciona nunca disparam Novo artigo do feed, e os artigos que os seus filtros deixam de fora também contam como vistos. Mudar o endereço de um feed recomeça do zero, como se você tivesse adicionado um feed novo.
O que o Macro Deck envia aos servidores dos feeds?
O Macro Deck só contata os feeds que você adiciona e os servidores de onde vêm as imagens deles, com uma requisição comum pelo feed. O texto dos artigos é mostrado como texto simples, e scripts ou conteúdo incorporado do feed nunca são executados.
Mais em Casa inteligente e web
Home Assistant
Incluída no Macro DeckAcione luzes, execute cenas e scripts e mostre no seu deck os estados ao vivo do seu Home Assistant.
AdGuard Home
Incluída no Macro DeckAtive, desative ou pause a proteção do AdGuard Home e mostre as estatísticas dele no seu deck.
HTTP
Incluída no Macro DeckEnvie requisições HTTP a partir de um botão e salve valores da resposta em variáveis.
Clima
Incluída no Macro DeckMostre no deck o clima atual e a previsão para os seus locais, sem chave de API.