rtv

该项目不再维护

• RTV 开发正在停止
• 替代项目清单

Reddit 终端查看器 (RTV)

基于文本的界面 (TUI)，用于从终端查看 Reddit 并与之交互。

目录

• 演示
• 安装
• 用法
• 设置
• 主题
• 常问问题
• 贡献
• 执照

演示

您可以使用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

视窗

由于缺乏资源和兴趣，Windows 不支持 RTV。对不起！

用法

要运行该程序，请键入：

$ 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 文件允许您将不同的 MIME 媒体类型（例如image/jpeg或video/mp4与 shell 命令关联起来。默认情况下禁用此功能，因为它需要一些额外的步骤来配置。首先，将默认的 mailcap 模板复制到您的主目录。

$ rtv --copy-mailcap

该模板包含常见 MIME 类型的示例，可与imgur 、 youtube和gfycat等流行的 reddit 网站配合使用。打开 mailcap 模板并按照其中列出的说明进行操作。

设置好 mailcap 文件后，通过使用rtv --enable-media标志启动 rtv 来启用它（或在rtv.cfg中设置）

环境变量

RTV 交互的默认程序可以通过环境变量进行配置：

$RTV_EDITOR	用于撰写文本提交和评论的程序，例如vim 、 emacs 、 gedit 如果未指定，将按顺序回退到 $VISUAL 和 $EDITOR。
$RTV_BROWSER	用于打开外部网站链接的程序，例如firefox 、 google-chrome 、 w3m 、 lynx 如果未指定，将回退到 $BROWSER 或系统的默认浏览器。
$RTV_URLVIEWER	用于从文本块中提取超链接的工具，例如 urlview、urlscan 如果未指定，则将回退到 urlview（如果已安装）。

剪贴板

RTV 支持将提交链接复制到操作系统剪贴板。在 macOS 上，这是开箱即用的支持。在 Linux 系统上，您需要安装 xsel 或 xclip。

主题

主题可用于自定义 RTV 的外观和感觉

晒黑	日光照射
纸色	摩洛凯岛

您可以使用--list-themes命令列出所有已安装的主题，并使用--theme选择一个主题。您可以将您的选择永久保存在 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 许可证分发的。