RSS フィード
Macro Deck に同梱RSS フィードや Atom フィードをフォローし、最新の記事をウィジェットに表示して、新しい記事が届いたときに反応します。
Tech News フィードのサンプル記事を表示するフィード一覧ウィジェットと注目記事ウィジェット
- RSS 2.0 や Atom のフィードを、いくつでもフォロー可能
- フィード一覧と注目記事のウィジェット
- タップしたデバイスで記事を開く
- 新着記事と更新失敗のトリガー
- フィードごとのキーワードとカテゴリーのフィルター
RSS フィード連携は、ニュースサイト、ブログ、ポッドキャストなど、RSS 2.0 または Atom フィードを公開しているものをフォローします。Macro Deck はバックグラウンドでフィードを確認し、最新の記事を保持してウィジェットに表示します。アカウントは不要で、フィードはいくつでも追加できます。
ウィジェット、アクション、トリガー
フィード一覧 ウィジェットは、最新の記事をタイトルと日付付きで一覧表示し、本文の冒頭と小さな画像も表示できます。注目記事 ウィジェットは 1 つの記事を画像付きで大きく表示し、最新の記事のいくつかを順番に表示することもできます。各ウィジェットには、すべてのフィード、1 つのフィード、またはフィードの 1 つのグループを表示できます。記事をタップすると、タップしたデバイス (たとえば Web クライアントを使っているスマートフォン) のブラウザーで記事が開くか、ダイアログに詳細が表示されます。
フィードを更新 アクションは、1 つのフィードまたはすべてのフィードをすぐに確認します。トリガーは、フィードに フィードの新着記事 があったとき、フィードが更新されたとき、更新に失敗したとき、ウィジェットで記事がタップされたときに反応します。実行されるアクションでは、{{ event.title }} や {{ event.url }} など、記事の値を使えます。
各フィードには変数もあります。たとえば feeds_<feed>_latest_title や feeds_<feed>_unread_count のほか、すべてのフィードの合計を表す feeds_all_unread_count があります。
設定例:
- グループ
Newsを表示し、3 つのニュースサイトの最新記事を並べる フィード一覧 ウィジェット。 - 最新の 5 つの記事を 10 秒ごとに切り替えて表示する 注目記事 ウィジェット。
- ポッドキャストのフィードの フィードの新着記事 で動作し、Discord Webhook 連携の Discord Webhook メッセージを送信 でエピソードのタイトルを 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: フィードを追加する
フィードを追加 ダイアログに入力します:
- フィードのアドレス: フィードのアドレスです。通常は Web サイトの RSS アイコンのリンク先で、たとえば
https://example.com/feed.xmlです。 - 設定名: ウィジェット、トリガー、変数でのフィードの名前です。空欄にするとフィード自体のタイトルが使われます。
- グループ: 任意です (例:
News)。同じグループのフィードは 1 つのウィジェットにまとめて表示できます。 - 更新間隔 (分): Macro Deck がフィードを確認する頻度です。最短 5 分です。
詳細な設定 では、次を含む記事のみ、次を含む記事をスキップ、次のカテゴリーのみ (それぞれカンマ区切りのリスト) と、自分のネットワーク内で配信されているフィード用の ローカルネットワークのアドレスを許可 を設定できます。続行 をクリックします。Macro Deck は保存する前にフィードを一度読み込みます。
- フィードのアドレス: フィードのアドレスです。通常は Web サイトの RSS アイコンのリンク先で、たとえば
ステップ 3: 必要に応じてフィードを追加する
他のフィードごとに、もう一度 設定を追加 をクリックします。設定の一覧には、各フィードの最後の更新が成功したかどうかが表示されます。
ステップ 4: フィードのウィジェットを追加する
デッキ ページで、デッキのロックが解除された状態 (右上に ロック ボタンが表示されている状態) で、フィード一覧 または 注目記事 ウィジェットを追加します。表示 で すべてのフィード、1 つのフィード、1 つのグループ のいずれかを選び、記事数、説明を表示、画像を表示、タップしたとき を設定します。
ステップ 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
ウィジェットの選択画面からデッキに追加できます。
- フィード一覧
- すべてのフィード、1 つのフィード、または 1 つのグループから、最新の記事を最大 10 件表示します。
- 注目記事
- 最新の記事を画像付きで大きく表示し、最新の記事のいくつかを順番に表示することもできます。
よくある質問
記事をタップすると、どこで開きますか?
ブラウザーで開く の場合、記事は Macro Deck を実行しているコンピューターではなく、タップしたデバイスのブラウザーで開きます。ハードウェアのデッキなど、そのデバイスでリンクを開けない場合は、代わりにアドレス付きの詳細が表示されます。これを変更するには、タップしたとき で 詳細を表示 または ウィジェットのアクションのみ実行 を選びます。
Macro Deck がフィードのアドレスを拒否するのはなぜですか?
Macro Deck は、localhost や 192.168.… など、ローカルネットワークやプライベートネットワーク内のアドレスを拒否します。フィードがそこへリダイレクトする場合も同じです。NAS などでフィードを自分で配信している場合は、そのフィードの 詳細な設定 で ローカルネットワークのアドレスを許可 をオンにしてください。その他のエラーでは、フィードが時間内に応答しなかった、接続できなかった、RSS や Atom のフィードではない、5 MB を超えている、のいずれかが表示されます。
変数はどのように名付けられますか?
各フィードの変数は、フィードを追加したときの設定名にちなんで名付けられます (例: feeds_tech_news_latest_title)。後で設定名を変更しても、変数の名前は変わりません。正確な名前は、連携の 変数 タブで確認できます。
古い記事でフィードの新着記事が動作しなかったのはなぜですか?
フィードを追加した時点でそのフィードにすでにある記事では フィードの新着記事 は動作しません。フィルターで除外された記事も既読として扱われます。フィードのアドレスを変更すると、新しいフィードを追加したときと同じように最初からやり直しになります。
Macro Deck はフィードのサーバーに何を送信しますか?
Macro Deck が接続するのは、追加したフィードと、その画像を配信しているサーバーだけで、フィードを取得する通常のリクエストを送るだけです。記事の本文はプレーンテキストとして表示され、フィードのスクリプトや埋め込みコンテンツが実行されることはありません。
スマートホームと Webのその他の連携
Home Assistant
Macro Deck に同梱Home Assistant のライトの切り替え、シーンやスクリプトの実行を行い、ライブの状態をデッキに表示します。
AdGuard Home
Macro Deck に同梱AdGuard Home の保護をオン、オフ、一時停止し、その統計をデッキに表示します。
HTTP
Macro Deck に同梱ボタンから HTTP リクエストを送信し、応答の値を変数に保存します。
天気
Macro Deck に同梱API キーなしで、登録した場所の現在の天気と予報をデッキに表示します。