rtv

このプロジェクトはもう維持されません

• RTV 開発は終了します
• 代替プロジェクトのリスト

Reddit ターミナル ビューア (RTV)

端末から Reddit を表示および操作するためのテキストベースのインターフェイス (TUI)。

目次

• デモ
• インストール
• 使用法
• 設定
• テーマ
• よくある質問
• 貢献する
• ライセンス

デモ

Telnetまたはssh を使用すると、RTV のライト バージョンをインストールせずに端末で直接試すことができます。

• $ telnet redditbox.us
• $ ssh redditbox.us

redditbox.us は Alex Jarmoszuk による独立したプロジェクトです。

インストール

PyPIパッケージ

RTV は PyPI で利用でき、pip でインストールできます。

$ pip install rtv

ネイティブパッケージ

サポートされているディストリビューション パッケージの最新リストについては、「Repology」を参照してください。

 # macOS
$ brew install rtv

# Arch
$ pacman -S rtv

# Nix
$ nix-env -i rtv

# Debian
$ apt install rtv

# FreeBSD
$ pkg install rtv

ソースから

$ git clone https://github.com/michael-lazar/rtv.git
$ cd rtv
$ python setup.py install

窓

RTV は、リソースと関心が不足しているため、Windows ではサポートされていません。ごめん！

使用法

プログラムを実行するには、次のように入力します。

$ rtv --help

コントロール

矢印キーまたはVimスタイルの動きを使用してカーソルを移動します。

• ▲と▼ を押して提出物をスクロールします
• ▶ を押して選択した提出物を表示し、 ◀を押して戻ります。
• スペースバーを押してコメントを展開/折りたたむ
• u を押してログインします (これには OAuth 用の Web ブラウザが必要です)
• プレス？ヘルプ画面を開くには

/を押してナビゲーション プロンプトを開き、次のような内容を入力できます。

• /front
• /r/commandprompt+linuxmasterrace
• /r/programming/controversial
• /u/me
• /u/multi-mod/m/art
• /domain/github.com

コマンドの完全なリストについては、「コントロール」を参照してください。

設定

設定ファイル

構成ファイルは{HOME}/.config/rtv/ディレクトリに保存されます。

構成可能なオプションの完全なリストについては、rtv.cfg を確認してください。次のコマンドを実行すると、このファイルのクローンをホーム ディレクトリに作成できます。

$ rtv --copy-config

メディアリンクの表示

mailcap を使用して、RTV がさまざまなタイプのリンクを開く方法を構成できます。

mailcap ファイルを使用するとimage/jpegやvideo/mp4などのさまざまな MIME メディア タイプをシェル コマンドに関連付けることができます。この機能は、構成にいくつかの追加手順が必要なため、デフォルトでは無効になっています。まず、デフォルトの mailcap テンプレートをホーム ディレクトリにコピーします。

$ rtv --copy-mailcap

このテンプレートには、 imgur 、 youtube 、 gfycatなどの人気のある reddit Web サイトで動作する一般的な MIME タイプの例が含まれています。 mailcap テンプレートを開き、そこに記載されている手順に従います。

mailcap ファイルを設定したら、 rtv --enable-mediaフラグを使用して rtv を起動して、そのファイルを有効にします (またはrtv.cfgに設定します)。

環境変数

RTV が対話するデフォルトのプログラムは、環境変数を通じて構成できます。

$RTV_EDITOR	テキストの送信とコメントを作成するために使用されるプログラム (例: vim 、 emacs 、 gedit ) 指定しない場合は、$VISUAL と $EDITOR の順にフォールバックします。
$RTV_BROWSER	外部 Web サイトへのリンクを開くために使用されるプログラム (例: firefox 、 google-chrome 、 w3m 、 lynx ) 指定しない場合、$BROWSER またはシステムのデフォルトのブラウザにフォールバックします。
$RTV_URLVIEWER	テキストのブロックからハイパーリンクを抽出するために使用されるツール (urlview、urlscan など) 指定しない場合、urlview がインストールされている場合は urlview にフォールバックします。

クリップボード

RTV は、OS クリップボードへの送信リンクのコピーをサポートしています。 macOS では、これはすぐにサポートされます。 Linux システムでは、xsel または xclip をインストールする必要があります。

テーマ

テーマを使用して RTV の外観と雰囲気をカスタマイズできます

ソラライズドダーク	ソラリゼーションライト
ペーパーカラー	モロカイ島

--list-themesコマンドを使用して、インストールされているすべてのテーマを一覧表示し、 --themeを使用して 1 つを選択できます。選択内容を rtv.cfg ファイルに永続的に保存できます。 RTV 内でF2およびF3キーを使用して、利用可能なすべてのテーマを循環することもできます。

独自のテーマの作成とインストールの手順については、THEMES.md を参照してください。

よくある質問

インストール中または rtv の起動時にエラーが発生するのはなぜですか?

ディストリビューションに古いバージョンの Python 2.7 または Python-requests が同梱されている場合、SSL エラーやその他のパッケージの非互換性が発生する可能性があります。これを修正する最も簡単な方法は、Python 3 を使用して rtv をインストールすることです。 pip3 をまだお持ちでない場合は、セットアップ手順について http://stackoverflow.com/a/6587528 を参照してください。それならそうする

$ sudo pip uninstall rtv
$ sudo pip3 install -U rtv

Mb~@M-"や^@などの文字化けしたテキストが表示されるのはなぜですか?

このタイプのテキストは通常​​、Python が Unicode を適切にレンダリングできない場合に表示されます。

1. rtv --asciiを使用して、ASCII 専用モードで RTV を起動してみてください。
2. 使用している端末/フォントが Unicode をサポートしていることを確認してください
3. LOCALEをutf-8に設定してみてください
4. あなたのPythonは間違ったcursesライブラリに対して構築されている可能性があります。詳細については、こことここを参照してください。

リポジトリからコードを直接実行するにはどうすればよいですか?

このプロジェクトは、Pythonモジュールとして実行されるように構造化されています。これは、Python の-mフラグを使用して起動する必要があることを意味します。以下の例を参照してください。この例では、リポジトリをディレクトリ~/rtv_projectに複製したことを前提としています。

$ cd ~ /rtv_project
$ python3 -m rtv

貢献する

すべてのフィードバックや提案を歓迎します。問題を投稿してください。

コードを記述する前に、コントリビューター ガイドラインをお読みください。

ライセンス

このプロジェクトは MIT ライセンスに基づいて配布されています。