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분 후 다시 시도하고, 그 뒤로는 실패할 때마다 최대 1시간까지 더 오래 기다립니다. 위젯은 새로 고칠 때마다 저절로 업데이트되며 Macro Deck이 이미 가져온 내용만 표시하므로, 위젯이 많아져도 요청이 늘지 않습니다.
피드를 추가할 때 이미 피드에 있던 글은 새 피드 글을 실행하지 않으며, 다시 시작해도 다시 실행되지 않습니다. 안전을 위해 Macro Deck은 해당 피드에서 허용하지 않는 한 로컬 및 사설 네트워크의 피드 주소를 거부합니다.
준비물
- Windows, macOS 또는 Linux의 Macro Deck 3
- 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 피드가 아닌지, 5MB보다 큰지를 알려 줍니다.
변수 이름은 어떻게 정해지나요?
각 피드의 변수 이름은 피드를 추가할 때의 구성 이름을 따릅니다(예: 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 키 없이 원하는 위치의 현재 날씨와 예보를 덱에 표시하세요.