rtv

ESTE PROYECTO YA NO SE MANTIENE

• El desarrollo de RTV se está cerrando
• Lista de proyectos alternativos

Visor de terminal de Reddit (RTV)

Una interfaz basada en texto (TUI) para ver e interactuar con Reddit desde tu terminal.

Tabla de contenido

• Manifestación
• Instalación
• Uso
• Ajustes
• Temas
• Preguntas frecuentes
• Contribuyendo
• Licencia

Manifestación

Puedes usar telnet o ssh para probar una versión lite de RTV directamente en tu terminal, sin necesidad de instalarlo:

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

redditbox.us es un proyecto independiente de Alex Jarmoszuk

Instalación

Paquete PyPI

RTV está disponible en PyPI y se puede instalar con pip:

$ pip install rtv

Paquetes nativos

Consulte Repología para obtener una lista actualizada de los paquetes de distribución compatibles:

 # macOS
$ brew install rtv

# Arch
$ pacman -S rtv

# Nix
$ nix-env -i rtv

# Debian
$ apt install rtv

# FreeBSD
$ pkg install rtv

De la fuente

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

ventanas

RTV no es compatible con Windows debido a la falta de recursos e interés. ¡Lo siento!

Uso

Para ejecutar el programa, escriba:

$ rtv --help

Controles

Mueva el cursor usando las teclas de flecha o el movimiento estilo Vim :

• Presione ▲ y ▼ para desplazarse por las presentaciones
• Presione ▶ para ver el envío seleccionado y ◀ para regresar
• Presione la barra espaciadora para expandir/contraer comentarios
• Presione u para iniciar sesión (esto requiere un navegador web para OAuth)
• Prensa ? para abrir la pantalla de ayuda

Presione / para abrir el mensaje de navegación, donde puede escribir cosas como:

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

Consulte CONTROLES para obtener la lista completa de comandos.

Ajustes

Archivo de configuración

Los archivos de configuración se almacenan en el directorio {HOME}/.config/rtv/ .

Consulte rtv.cfg para obtener la lista completa de opciones configurables. Puede clonar este archivo en su directorio de inicio ejecutando:

$ rtv --copy-config

Ver enlaces de medios

Puede utilizar mailcap para configurar cómo RTV abrirá diferentes tipos de enlaces.

Un archivo mailcap le permite asociar diferentes tipos de medios MIME, como image/jpeg o video/mp4 , con comandos de shell. Esta función está deshabilitada de forma predeterminada porque requiere algunos pasos adicionales para configurarla. Para comenzar, copie la plantilla de tapa de correo predeterminada en su directorio de inicio.

$ rtv --copy-mailcap

Esta plantilla contiene ejemplos de tipos MIME comunes que funcionan con sitios web populares de Reddit como imgur , youtube y gfycat . Abra la plantilla de tapa de correo y siga las instrucciones que se indican en el interior.

Una vez que haya configurado su archivo mailcap, habilítelo iniciando rtv con el indicador rtv --enable-media (o configúrelo en su rtv.cfg ).

Variables de entorno

Los programas predeterminados con los que interactúa RTV se pueden configurar a través de variables de entorno:

$RTV_EDITOR	Un programa utilizado para redactar envíos de texto y comentarios, por ejemplo, vim , emacs , gedit. Si no se especifica, recurrirá a $VISUAL y $EDITOR en ese orden.
$RTV_BROWSER	Un programa utilizado para abrir enlaces a sitios web externos, por ejemplo , Firefox , Google Chrome , W3M , Lynx. Si no se especifica, recurrirá a $BROWSER o al navegador predeterminado de su sistema.
$RTV_URLVIEWER	Una herramienta utilizada para extraer hipervínculos de bloques de texto, por ejemplo, urlview, urlscan. Si no se especifica, recurrirá a urlview si está instalado.

Portapapeles

RTV admite la copia de enlaces de envío al portapapeles del sistema operativo. En macOS, esto es compatible desde el primer momento. En los sistemas Linux necesitarás instalar xsel o xclip.

Temas

Se pueden utilizar temas para personalizar la apariencia de RTV.

Solarizado Oscuro	Luz solarizada
color de papel	molokai

Puede enumerar todos los temas instalados con el comando --list-themes y seleccionar uno con --theme . Puede guardar su elección de forma permanente en su archivo rtv.cfg. También puede utilizar las teclas F2 y F3 dentro de RTV para recorrer todos los temas disponibles.

Para obtener instrucciones sobre cómo escribir e instalar sus propios temas, consulte THEMES.md.

Preguntas frecuentes

¿Por qué recibo un error durante la instalación/al iniciar rtv?

Si su distribución viene con una versión anterior de Python 2.7 o Python-requests, puede experimentar errores de SSL u otras incompatibilidades de paquetes. La forma más sencilla de solucionar este problema es instalar rtv usando python 3. Si aún no tiene pip3, consulte http://stackoverflow.com/a/6587528 para obtener instrucciones de configuración. entonces hazlo

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

¿Por qué veo texto confuso como Mb~@M-" o ^@ ?

Este tipo de texto suele aparecer cuando Python no puede representar Unicode correctamente.

1. Intente iniciar RTV en modo solo ascii con rtv --ascii
2. Asegúrate de que el terminal/fuente que estás utilizando sea compatible con Unicode
3. Intente configurar LOCALE en utf-8
4. Es posible que su Python se haya creado con la biblioteca de curses incorrecta; consulte aquí y aquí para obtener más información.

¿Cómo ejecuto el código directamente desde el repositorio?

Este proyecto está estructurado para ejecutarse como un módulo de Python. Esto significa que debe iniciarlo usando el indicador -m de Python. Vea el ejemplo a continuación, que supone que ha clonado el repositorio en el directorio ~/rtv_project .

$ cd ~ /rtv_project
$ python3 -m rtv

Contribuyendo

Todos los comentarios y sugerencias son bienvenidos, ¡simplemente publique un problema!

Antes de escribir cualquier código, lea las Pautas para colaboradores.

Licencia

Este proyecto se distribuye bajo la licencia MIT.