Feedr バージョン 0.8.0 – TUI ラーナーを再発見し、今やターミナルから完全な記事内容を読み取ることができます。

Feedr は、Rust で書かれた機能豊富なターミナルベースの RSS フィードリーダーです。優雅な視覚効果と滑らかなキーボードナビゲーションを備えた、クリーンで直感的な TUI（テキストユーザーインターフェース）を提供し、RSS フィードの管理・閲覧を行います。

デモ

特徴

• ダッシュボードビュー: すべてのフィードにわたる最新の投稿を時系列順に表示
• フィード管理: 複数の RSS/Atom フィードを購読し、整理できます
• フィード自動発見: 任意のウェブページ URL を貼り付けると、Feedr はその RSS/Atom フィードを検出し、購読するよう提示します
• スター付き記事: 専用ビューで後日参照するための記事を保存できます
• カテゴリ: カスタムカテゴリにフィードを整理でき、作成・改名・削除に対応しています
• ツリービュー: カテゴリごとにグループ化されたフィードを階層構造で閲覧できます
• 高度なフィルタリング: カテゴリ、投稿期間、著者、読了ステータス、スター付きステータス、コンテンツ長さによって記事を検索・絞り込めます
• 2 つのテーマ: サイバーパンク風のダークテーマと、禅的なライトテーマの間で切り替えられます（t キー）
• ライブ検索: 全フィードタイトルと記事内容ですぐに検索できます
• サマリービュー: 「What's New」画面は、前回セッション以降に追加された記事と各フィードの統計を表示します
• 読了/未読の追跡: セッション間を超えて読了状態を永続的に保持します
• 全表示済みへの変換: m キーで現在表示されているすべての項目を即座に「読了」とマークできます
• 記事プレビュー: ダッシュボードビュー内でインラインプレビューパネの切り替えが可能です
• リンク抽出: l キーで記事内のすべてのリンクを抽出・閲覧します
• 全文抽出: Mozilla Readability を用いてサマリーを除去し、インラインで実際の本文を読めます（手動：Shift+F で有効/無効切替、自動刷新時の設定：

  fulltext = true

  ）
• ヘルスオーバーレイ: ? キーを押すとスクロール可能なキー割り当て参照のオーバーレイが表示されます
• OPML インポート:

  feedr --import <file.opml>

  コマンドで OPML ファイルから一括インポートが可能です
• ブラウザ連携: デフォルトのブラウザで記事を開きます
• マウス対応: マウスクリックで項目を選択し、ホイールでスクロールできます
• バックグラウンドリフレッシュ: 設定可能な間隔とスマートなレート制限付きの自動フィード更新
• レート制限: ドメインごとのリクエストスロットリングにより、「要求回数が多すぎます」エラーを防ぎます（Reddit フィードなど向いています）
• Vim スタイルのナビゲーション: アラートキーに加え、j/k キーでもナビゲーションが使用できます
• リッチコンテンツ表示: HTML をテキストへの変換を行い、文章をきれいに整形して表示します
• 認証済みフィード: プライベートまたは認証が必要な RSS フィードに対応（例：

  Authorization: Bearer ...

  のようなカスタム HTTP ヘッダ）
• コンパクトモード: 小さなターミナル（≤30 リン）で自動的にコンパクトレイアウトを適用し、設定で「常に/決して」上書きも可能
• CLI 設定管理: コマンドラインから設定の取得・設定・一覧表示が可能（

  feedr config

  ）、または対話型の TUI 設定エディタを使用可能（

  feedr config --tui

  ）
• 設定可能なキー割り当て:

  config.toml

  の

  [keybindings]

  セクションで任意のアクションを再割り当てできます
• 外部コマンドフック: Newsboat 風のマクロ（pipe-to, exec）をキーに割り当てるほか、新規項目ごとの通知フック

  exec_on_new

  もサポートし、シェル不要の引数テンプレート化が可能
• 設定可能: タイムアウト、テーマ、UI アクション、デフォルトフィードなどを TOML 設定でカスタマイズ
• XDG 準拠: 設定とデータ保存の標準ディレクトリ仕様を遵守

インストール

前提条件

Rust と Cargo （https://rustup.rs/ よりインストール）

Cargo install を使用して（推奨）

Arch Linux (AUR)

Feedr は AUR で利用可能です。好きな AUR ヘルパーでインストールしてください：

paru -S feedr
# または
yay -S feedr

ソースからのビルド

git clone https://github.com/bahdotsh/feedr.git
cd feedr
cargo build --release

バイナリは

target/release/feedr

使用方法

アプリケーションを実行します：

OPML インポート

OPML ファイルからフィードをインポート：

feedr --import feeds.opml

設定管理

コマンドラインから設定を表示・編集：

feedr config list                      # 現在の値付きで全設定を一覧
feedr config get ui.theme              # 単一の値を取得
feedr config set ui.theme light        # 値を設定（検証あり）
feedr config --tui                     # 対話型 TUI 設定エディタを開く

利用可能な設定キーはドット記法を使用します（例：

general.max_dashboard_items

network.http_timeout

ui.theme

ui.compact_mode

feedr config list

クイックスタート

初回起動時に Feedr を開くと、

a

1

2

3

j/k

o

t

キーボード操作

以下のすべてのキー割り当てはデフォルト値を示しています。任意のアクションを再割り当てするには、設定ファイルの

[keybindings]

一般ナビゲーション

ダッシュボードビュー

フィード一覧ビュー

フィード項目ビュー

項目詳細ビュー

スター付きビュー

カテゴリビュー

フィルターモード（ダッシュボードで f キーを押す）

マウス対応

設定

Feedr は XDG ベースディレクトリ仕様に基づく TOML 設定ファイルを通じてカスタマイズをサポートします。ファイルを直接編集するか、

feedr config get/set

feedr config --tui

設定ファイルの場所

• Linux/macOS:

  ~/.config/feedr/config.toml

• Windows:

  %APPDATA%\feedr\config.toml

設定ファイルは最初に実行時に存在しない場合、デフォルト値付きで自動生成されます。

利用可能な設定項目

# Feedr 設定ファイル

[general]
max_dashboard_items = 100           # ダッシュボードに表示する最大アイテム数
auto_refresh_interval = 0           # 自動リフレッシュ間隔（秒）（0 で無効化）
refresh_enabled = false             # 自動バックグラウンドリフレッシュの有効/無効
refresh_rate_limit_delay = 2000     # 同じドメインへのリクエスト間の遅延（ミリ秒）

[network]
http_timeout = 15              # フィード取得時の HTTP リクエストタイムアウト（秒）
user_agent = "Mozilla/5.0 (compatible; Feedr/1.0; +https://github.com/bahdotsh/feedr)"

[ui]
tick_rate = 100                # UI 更新間隔（ミリ秒）
error_display_timeout = 3000   # エラーメッセージ表示時間（ミリ秒）
theme = "dark"                 # テーマ："dark" (サイバーパンク) または "light" (禅)
compact_mode = "auto"          # コンパクトレイアウト:"auto", "always", または "never"

# オプション：初回実行時に自動的に読み込むデフォルトフィード
[[default_feeds]]
url = "https://example.com/feed.xml"
category = "News"

# 認証済みフィード（カスタム HTTP ヘッダ付き）
[[default_feeds]]
url = "https://private.example.com/feed.xml"
[default_feeds.headers]
Authorization = "Bearer your_token_here"

設定オプションの説明

一般設定

• max_dashboard_items

  : ダッシュボードに表示するアイテム数を制御（デフォルト：100）

• auto_refresh_interval

  : 指定した間隔でフィードを自動的にリフレッシュ（0 で無効化）

• refresh_enabled

  : 自動バックグラウンドリフレッシュの有効/無効のマスタースイッチ（デフォルト：false）

• refresh_rate_limit_delay

  : 同じドメインへのリクエスト間の遅延（ミリ秒）、"too many requests" エラーを防ぐため（デフォルト：2000ms）。Reddit フィードなどレート制限のあるサービスに特に有用です。

ネットワーク設定

• http_timeout

  : フィード取得時の HTTP リクエストタイムアウト（低速接続の場合に有用）

• user_agent

  : HTTP リクエスト用のカスタム User-Agent 文字列

UI 設定

• tick_rate

  : UI が更新される頻度（ミリ秒）。値が低いほど反応性が向上し、高いほど CPU 使用率が低下します。

• error_display_timeout

  : エラーメッセージが表示される時間（ミリ秒）

• theme

  : 「dark」（ネオンカラーのサイバーパンク風）または「light」（有機色を基調とするミニマリストな禅）。ランタイムで t キーでも切り替え可能です。

• compact_mode

  : 小さなターミナル向けのコンパクトレイアウトを制御します。「auto」（デフォルト）はターミナルの高さが ≤30 ラインの場合にコンパクトモードを有効にし、「always」は常にコンパクトモード、「never」は無効にします。コンパクトモードでは単一行項目、最小のタイトルバー、略式のヘルプバーを使用し、画面スペースを最大化します。

バックグラウンドリフレッシュ例

5 分ごとにレート制限付きで自動的にリフレッシュするには：

[general]
refresh_enabled = true
auto_refresh_interval = 300  # 5 分
refresh_rate_limit_delay = 2000  # 同じドメインへのリクエスト間で 2 秒の遅延

備考: レート制限ではフィードをドメインごとにグループ化し、API リミットに到達しないようリクエストの順序をずらします。複数の Reddit フィードを持つ場合も、各リクエスト間に 2 秒の遅延が適用されブロック回避されます。

デフォルトフィード

初回実行時に自動的に読み込むフィードを定義できます：

[[default_feeds]]
url = "https://news.ycombinator.com/rss"
category = "Tech"

[[default_feeds]]
url = "https://example.com/feed.xml"
category = "News"

# オプション: フィードごとのリフレッシュ閾値（秒）。最後のリフレッシュ以降にこの期間が経過すると、
# 次の自動リフレッシュティックがトリガーされます。現時点では全フィードを同時にリフレッシュするため、
# フィードごとの選択的リフレッシュは機能しません。
# `general.refresh_enabled = true` を必要とします。
[[default_feeds]]
url = "https://example.com/fast-feed.xml"
refresh_interval = 60

認証済みフィード

一部の RSS フィードは認証またはカスタム HTTP ヘッダが必要です。フィードごとのヘッダを設定できます：

[[default_feeds]]
url = "https://private.example.com/feed.xml"
[default_feeds.headers]
Authorization = "Bearer your_api_token"

[[default_feeds]]
url = "https://another-api.example.com/rss"
[default_feeds.headers]
X-API-Key = "your_api_key"
Cookie = "session=abc123"

ヘッダは各フィードのリクエスト（リフレッシュを含む）に付与されます。

全文抽出

多くの RSS フィードでは短いサマリーしか含まれていません。Feedr はリンクされた記事 URL を取得し、Mozilla Readability（

dom_smoothie

• 手動: 記事詳細ビューで焦点のある記事を抽出するには

  Shift+F

  キーを押します。再度

  Shift+F

  で元のサマリーに戻るか、失敗後にもう一度試すことができます。
• 刷新時の自動:

  fulltext = true

  をフィードに設定すると、各リフレッシュ時に見つかった新規項目を自動的に抽出します（

  exec_on_new

  と同様「パイプホースルール」——最初の観測はサイレントです）。

[[default_feeds]]
url = "https://example.com/summary-only-feed.xml"
fulltext = true

備考:

• 抽出されたコンテンツはメモリ上にのみ保持され、ディスクに永続化されません。再起動ではオンデマンドで再抽出されます。
• フィードごとの認証ヘッダは記事 URL に送信されません（記事 URL は通常サードパーティホストであり、

  Authorization

  をフォワードすると認証情報が漏洩します）。
• 非常に短い抽出された本文を持つページ（JS 渲染または壁に保護されている可能性）は適切にエラー処理され、元のサマリーを表示するようフォールバックします。

外部コマンドフック

Feedr は Newsboat 風の外部コマンドをサポートし、2 つのワークフローに対応します：マクロ（焦点にある記事に対するキートリガーチェーン）と

exec_on_new

%X

テンプレート変数

マクロおよびフックコマンドの全 argv トークンで展開：

%t

%u

%a

%d

%f

%F

%%

マクロ

マクロはキーに順序されたステップのチェーンを割り当てます。トリガーするには

<prefix><key>

,

;

-- "説明"

[macros]
y = 'open-in-browser ; pipe-to "yt-dlp %u"'
w = 'pipe-to "wallabag-cli add %u" -- "Save to Wallabag"'
n = 'pipe-to "tee /tmp/out.txt" stdin=metadata'

[macro_options]
prefix = ","                  # マクロプレフィックスキー
pipe_default_stdin = "body"   # body | title | url | metadata | none

ステップ種別:

• <action>

  — 組み込みアクションを呼び出す。マクロで使用可能なもの：

  open-in-browser

  ,

  toggle-star

  ,

  toggle-read

  ,

  mark-all-read

  ,

  refresh

  ,

  toggle-theme

  ,

  extract-links

  ,

  fetch-full-text

  ,

  help

  。

• pipe-to "cmd %u" [stdin=…]

  — TUI を一時停止し、コマンドを実行し、記事内容をその標準入力に渡す。

  stdin

  は

  body

  （デフォルト）,

  title

  ,

  url

  ,

  metadata

  , または

  none

  のいずれか。

• exec "cmd %u"

  — 非分離プロセスでコマンドを起動（標準入出力なし、ターミナル取得なし）。

チェーンは最初のステップのエラーで停止します。プレフィックス後には Esc を押してキャンセルできます。未割り当ての追加ステップは「マクロ未割り当て」エラーを表面化させます。マクロもヘルプオーバーレイ（?）に表示されます。

exec_on_new 通知

各リフレッシュ後に見つかった新規項目ごとに一度コマンドを発火します。各フィードの最初の成功した取得がシilent に seen-set を種付けするため、初期ロードや初回実行時にパイプホースは発生しません。

[hooks]
exec_on_new = 'notify-send "New: %t" "%f"'

子プロセスは非分離で起動するため、TUI はそれらにブロックされません。クラッシュセマンティクスは「最多 1 回」です：feedr は起動前に seen-set を永続化するため、中道での kill は通知の喪失のみを招き、次の起動で再発火しません。冪等なコマンドを好むこと（例：

wallabag-cli add

mail-me

セキュリティに関する注記

• シェルは決して呼び出されず、

  %t

  /

  %a

  などのフィードコンテンツが引数の範囲から抜け出ることはありません。
• コマンドを

  sh -c "... %t ..."

  のようにラップしないでください——これでアイテムタイトルを通じたシェルインジェクションが再導入されます。スクリプトファイルを作成してそれを実行する代わりに使用してください。

• ~

  /

  $HOME

  /

  $VAR

  は展開されません——絶対パスを使用してください。
• マクロのコマンドテンプレートにアンバランスな引用符があるか、未知のアクションを指定した場合、feedr は起動時に警告を表示し、トリガー時点で沈黙して失敗しません。

設定可能なキー割り当て

設定ファイルに

[keybindings]

[keybindings]
quit = "x"                          # 単一のキー
move_up = ["Up", "k", "w"]         # 複数のキー
force_quit = "Ctrl+x"              # モディファイア付き
toggle_theme = "F5"                # ファンクションキー

利用可能なアクション

サポートされるキー形式：単一文字（

q

?

/

Enter

Space

Tab

Esc

Backspace

Up

Down

Left

Right

Home

End

PageUp

PageDown

Delete

F1–F5

Ctrl+q

Shift+Tab

Alt+x

データの保存

Feedr はブックマーク、カテゴリ、読了/未読状態、スター付き記事を以下に保存します：

• Linux/macOS:

  ~/.local/share/feedr/feedr_data.json

• Windows:

  %LOCALAPPDATA%\feedr\feedr_data.json

下位互換性: Feedr は古いバージョンからのデータを自動的に新しい XDG 準拠の場所へマイグレーションします。既存のデータは保持され、初回実行時に自動的に正しい場所へ移動されます。

依存関係

• ratatui: ターミナル UI フレームワーク
• crossterm: ターミナル操作ライブラリ
• reqwest: HTTP クライアント（gzip/deflate/brotli サポート付き）
• feed-rs: RSS および Atom フィードの解析
• html2text: HTML からテキストへの変換
• chrono: 日付と時間の処理
• serde: シリアライズ/デシリアライズ
• clap: コマンドライン引数の解析
• opml: OPML インポートサポート
• toml: 設定ファイルの解析
• scraper: フィード自動発見用の HTML 解析
• url: URL の解析と操作
• dom_smoothie: 全文抽出用の Mozilla Readability ポート
• encoding_rs: UTF-8 以外の記事ページに対する文字セット検出
• shlex: マクロ/フックコマンドテンプレート用のシェル風トークン化

ライセンス

MIT

コントリビュート

コントリビュートをお待ちしています！プルリクエストの提出を歓迎します。

1. リポジトリをフォーク
2. 機能ブランチを作成（

   git checkout -b feature/amazing-feature

   ）
3. 変更をコミット（

   git commit -m 'Add some amazing feature'

   ）
4. ブランチにプッシュ（

   git push origin feature/amazing-feature

   ）
5. プルリクエストを開く