Téléchargement rtv - Téléchargement du code source rtv

rtv

Python

v1.27.1

Télécharger

CE PROJET N'EST PLUS MAINTENU

Le développement de RTV s'arrête
Liste des projets alternatifs

Visionneuse de terminal Reddit (RTV)

Une interface textuelle (TUI) pour afficher et interagir avec Reddit depuis votre terminal.

image de titre

Table des matières

Démo
Installation
Usage
Paramètres
Thèmes
FAQ
Contribuer
Licence

Démo

image de titre

Vous pouvez utiliser telnet ou ssh pour essayer une version allégée de RTV directement dans votre terminal, sans avoir besoin de l'installer :

$ telnet redditbox.us
$ ssh redditbox.us

redditbox.us est un projet indépendant d'Alex Jarmoszuk

Installation

Paquet PyPI

RTV est disponible sur PyPI et peut être installé avec pip :

$ pip install rtv

Forfaits natifs

Voir Repologie pour une liste à jour des packages de distribution pris en charge :

 # macOS
$ brew install rtv

# Arch
$ pacman -S rtv

# Nix
$ nix-env -i rtv

# Debian
$ apt install rtv

# FreeBSD
$ pkg install rtv

De la source

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

Fenêtres

RTV n'est pas pris en charge sous Windows, en raison d'un manque de ressources et d'intérêt. Désolé!

Usage

Pour exécuter le programme, tapez :

$ rtv --help

Contrôles

Déplacez le curseur à l'aide des touches fléchées ou du mouvement de style Vim :

Appuyez sur ▲ et ▼ pour faire défiler les soumissions
Appuyez sur ▶ pour afficher la soumission sélectionnée et sur ◀ pour revenir.
Appuyez sur la barre d'espace pour développer/réduire les commentaires
Appuyez sur u pour vous connecter (cela nécessite un navigateur Web pour OAuth)
Presse ? pour ouvrir l'écran d'aide

Appuyez sur / pour ouvrir l'invite de navigation, où vous pouvez saisir des éléments tels que :

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

Voir CONTROLS pour la liste complète des commandes.

Paramètres

Fichier de configuration

Les fichiers de configuration sont stockés dans le répertoire {HOME}/.config/rtv/ .

Consultez rtv.cfg pour la liste complète des options configurables. Vous pouvez cloner ce fichier dans votre répertoire personnel en exécutant :

$ rtv --copy-config

Affichage des liens multimédias

Vous pouvez utiliser mailcap pour configurer la manière dont RTV ouvrira différents types de liens.

image de titre

Un fichier mailcap vous permet d'associer différents types de médias MIME, comme image/jpeg ou video/mp4 , à des commandes shell. Cette fonctionnalité est désactivée par défaut car sa configuration nécessite quelques étapes supplémentaires. Pour commencer, copiez le modèle mailcap par défaut dans votre répertoire personnel.

$ rtv --copy-mailcap

Ce modèle contient des exemples de types MIME courants qui fonctionnent avec les sites Web Reddit populaires tels que imgur , youtube et gfycat . Ouvrez le modèle mailcap et suivez les instructions répertoriées à l’intérieur.

Une fois que vous avez configuré votre fichier mailcap, activez-le en lançant rtv avec l'indicateur rtv --enable-media (ou définissez-le dans votre rtv.cfg )

Variables d'environnement

Les programmes par défaut avec lesquels RTV interagit peuvent être configurés via des variables d'environnement :

$RTV_EDITOR	Un programme utilisé pour rédiger des soumissions de texte et des commentaires, par exemple vim , emacs , gedit S'il n'est pas spécifié, il reviendra à $VISUAL et $EDITOR dans cet ordre.
$RTV_BROWSER	Un programme utilisé pour ouvrir des liens vers des sites Web externes, par exemple Firefox , google-chrome , w3m , lynx S'il n'est pas spécifié, il reviendra à $BROWSER ou au navigateur par défaut de votre système.
$RTV_URLVIEWER	Un outil utilisé pour extraire des hyperliens à partir de blocs de texte, par exemple urlview, urlscan S'il n'est pas spécifié, il reviendra à urlview s'il est installé.

Presse-papiers

RTV prend en charge la copie des liens de soumission vers le presse-papiers du système d'exploitation. Sur macOS, cette fonctionnalité est prise en charge dès le départ. Sur les systèmes Linux, vous devrez installer xsel ou xclip.

Thèmes

Les thèmes peuvent être utilisés pour personnaliser l'apparence de RTV.

Sombre solarisé	Lumière solarisée
Couleur du papier	Molokaï

Vous pouvez lister tous les thèmes installés avec la commande --list-themes et en sélectionner un avec --theme . Vous pouvez enregistrer votre choix de manière permanente dans votre fichier rtv.cfg. Vous pouvez également utiliser les touches F2 et F3 à l'intérieur de RTV pour parcourir tous les thèmes disponibles.

Pour obtenir des instructions sur l’écriture et l’installation de vos propres thèmes, consultez THEMES.md.

FAQ

Pourquoi est-ce que je reçois une erreur lors de l'installation/lors du lancement de rtv ?

Si votre distribution est livrée avec une ancienne version de Python 2.7 ou Python-Requests, vous pouvez rencontrer des erreurs SSL ou d'autres incompatibilités de packages. Le moyen le plus simple de résoudre ce problème est d'installer rtv à l'aide de python 3. Si vous n'avez pas déjà pip3, consultez http://stackoverflow.com/a/6587528 pour les instructions de configuration. Alors fais
$ sudo pip uninstall rtv
$ sudo pip3 install -U rtv

Pourquoi est-ce que je vois du texte tronqué comme Mb~@M-" ou ^@ ?

Ce type de texte apparaît généralement lorsque Python ne parvient pas à restituer correctement l'Unicode.
Essayez de démarrer RTV en mode ascii uniquement avec rtv --ascii
Assurez-vous que le terminal/la police que vous utilisez prend en charge Unicode
Essayez de définir LOCALE sur utf-8
Votre python a peut-être été construit avec la mauvaise bibliothèque Curses, voir ici et ici pour plus d'informations

Comment exécuter le code directement depuis le référentiel ?

Ce projet est structuré pour être exécuté en tant que module Python. Cela signifie que vous devez le lancer en utilisant l'indicateur -m de python. Voir l'exemple ci-dessous, qui suppose que vous avez cloné le référentiel dans le répertoire ~/rtv_project .
$ cd ~ /rtv_project
$ python3 -m rtv