rtv

ESTE PROJETO NÃO É MAIS MANTIDO

• O desenvolvimento da RTV está sendo encerrado
• Lista de Projetos Alternativos

Visualizador de terminal Reddit (RTV)

Uma interface baseada em texto (TUI) para visualizar e interagir com o Reddit a partir do seu terminal.

Índice

• Demonstração
• Instalação
• Uso
• Configurações
• Temas
• Perguntas frequentes
• Contribuindo
• Licença

Demonstração

Você pode usar telnet ou ssh para experimentar uma versão lite do RTV diretamente no seu terminal, sem precisar instalá-lo:

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

redditbox.us é um projeto independente de Alex Jarmoszuk

Instalação

Pacote PyPI

O RTV está disponível no PyPI e pode ser instalado com pip:

$ pip install rtv

Pacotes nativos

Consulte Repology para obter uma lista atualizada de pacotes de distribuição suportados:

 # macOS
$ brew install rtv

# Arch
$ pacman -S rtv

# Nix
$ nix-env -i rtv

# Debian
$ apt install rtv

# FreeBSD
$ pkg install rtv

Da fonte

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

Windows

RTV não é compatível com Windows por falta de recursos e interesse. Desculpe!

Uso

Para executar o programa, digite:

$ rtv --help

Controles

Mova o cursor usando as teclas de seta ou o movimento no estilo Vim :

• Pressione ▲ e ▼ para percorrer os envios
• Pressione ▶ para visualizar o envio selecionado e ◀ para retornar
• Pressione a barra de espaço para expandir/recolher comentários
• Pressione você para fazer login (isso requer um navegador da web para OAuth)
• Imprensa ? para abrir a tela de ajuda

Pressione / para abrir o prompt de navegação, onde você pode digitar coisas como:

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

Consulte CONTROLES para obter a lista completa de comandos.

Configurações

Arquivo de configuração

Os arquivos de configuração são armazenados no diretório {HOME}/.config/rtv/ .

Confira rtv.cfg para a lista completa de opções configuráveis. Você pode clonar este arquivo em seu diretório inicial executando:

$ rtv --copy-config

Visualizando links de mídia

É possível usar o mailcap para configurar como o RTV abrirá diferentes tipos de links.

Um arquivo mailcap permite associar diferentes tipos de mídia MIME, como image/jpeg ou video/mp4 , com comandos shell. Este recurso está desabilitado por padrão porque são necessárias algumas etapas extras para configurar. Para começar, copie o modelo mailcap padrão para seu diretório inicial.

$ rtv --copy-mailcap

Este modelo contém exemplos de tipos MIME comuns que funcionam com sites populares do Reddit, como imgur , youtube e gfycat . Abra o modelo mailcap e siga as instruções listadas nele.

Depois de configurar seu arquivo mailcap, habilite-o iniciando rtv com o sinalizador rtv --enable-media (ou defina-o em seu rtv.cfg )

Variáveis ​​de ambiente

Os programas padrão com os quais o RTV interage podem ser configurados por meio de variáveis ​​de ambiente:

$RTV_EDITOR	Um programa usado para redigir envios de texto e comentários, por exemplo, vim , emacs , gedit Se não for especificado, retornará para $VISUAL e $EDITOR nessa ordem.
$RTV_BROWSER	Um programa usado para abrir links para sites externos, por exemplo, firefox , google-chrome , w3m , lynx Se não for especificado, retornará para $BROWSER ou para o navegador padrão do seu sistema.
$RTV_URLVIEWER	Uma ferramenta usada para extrair hiperlinks de blocos de texto, por exemplo, urlview, urlscan Se não for especificado, retornará ao urlview se estiver instalado.

Área de transferência

O RTV oferece suporte à cópia de links de envio para a área de transferência do sistema operacional. No macOS, isso é compatível imediatamente. Em sistemas Linux você precisará instalar o xsel ou o xclip.

Temas

Os temas podem ser usados ​​para personalizar a aparência do RTV

Escuro Solarizado	Luz Solarizada
Cor de papel	Molokai

Você pode listar todos os temas instalados com o comando --list-themes e selecionar um com --theme . Você pode salvar sua escolha permanentemente em seu arquivo rtv.cfg. Você também pode usar as teclas F2 e F3 dentro do RTV para percorrer todos os temas disponíveis.

Para obter instruções sobre como escrever e instalar seus próprios temas, consulte THEMES.md.

Perguntas frequentes

Por que estou recebendo um erro durante a instalação/ao iniciar o rtv?

Se sua distribuição for fornecida com uma versão mais antiga do python 2.7 ou python-requests, você poderá enfrentar erros de SSL ou outras incompatibilidades de pacote. A maneira mais fácil de corrigir isso é instalar o rtv usando python 3. Se você ainda não possui o pip3, consulte http://stackoverflow.com/a/6587528 para obter instruções de configuração. Então faça

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

Por que vejo texto distorcido como Mb~@M-" ou ^@ ?

Esse tipo de texto geralmente aparece quando o python não consegue renderizar o unicode corretamente.

1. Tente iniciar o RTV no modo somente ASCII com rtv --ascii
2. Certifique-se de que o terminal/fonte que você está usando suporta Unicode
3. Tente definir LOCALE para utf-8
4. Seu python pode ter sido construído com base na biblioteca de maldições errada, veja aqui e aqui para mais informações

Como executo o código diretamente do repositório?

Este projeto está estruturado para ser executado como um módulo python. Isso significa que você precisa iniciá-lo usando o sinalizador -m do python. Veja o exemplo abaixo, que pressupõe que você clonou o repositório no diretório ~/rtv_project .

$ cd ~ /rtv_project
$ python3 -m rtv

Contribuindo

Todos os comentários e sugestões são bem-vindos, basta postar um problema!

Antes de escrever qualquer código, leia as Diretrizes para Colaboradores.

Licença

Este projeto é distribuído sob a licença do MIT.