RIP/README.md
2025-12-30 10:04:34 -03:00

134 lines
2.5 KiB
Markdown

# rip - Read In Peace
TUI (Terminal User Interface) para ler artigos sem paywall diretamente no terminal.
## Funcionalidades
- Remove paywall de diversos sites de notícias
- Interface de leitura no terminal com navegação estilo vim
- Tradução automática para Português (Brasil)
- Suporte a sites brasileiros e internacionais
## Sites Suportados
### Brasileiros
- O Globo, G1
- Folha de São Paulo
- Estadão
- UOL
- Valor Econômico
- Exame
- Veja
### Internacionais
- Medium (via Freedium/Scribe.rip)
- New York Times
- Washington Post
- Wall Street Journal
- Financial Times
- Bloomberg
- The Atlantic
- Wired
- The Guardian
- BBC, CNN, Reuters
- E muitos outros...
## Instalação
### Requisitos
- Rust 1.70+ ([instalar](https://rustup.rs))
### Via Cargo (recomendado)
```bash
# Clone o repositório
git clone https://github.com/seu-usuario/rip.git
cd rip
# Instala globalmente
cargo install --path .
```
### Configurar PATH
Adicione o cargo bin ao seu PATH (necessário apenas uma vez):
```bash
# Para bash
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# Para zsh
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
Depois de instalado, rode `rip` de qualquer diretório.
### Build manual
```bash
# Clone o repositório
git clone https://github.com/seu-usuario/rip.git
cd rip
# Build release
cargo build --release
# O binário estará em:
./target/release/rip
```
## Uso
```bash
rip
```
### Teclas de Atalho
| Tecla | Ação |
|-------|------|
| `Enter` | Buscar artigo (modo input) |
| `j` / `↓` | Rolar para baixo |
| `k` / `↑` | Rolar para cima |
| `Space` / `PageDown` | Página abaixo |
| `PageUp` | Página acima |
| `g` / `Home` | Ir para o início |
| `G` / `End` | Ir para o final |
| `t` | Traduzir para Português |
| `i` / `/` | Modo input (nova URL) |
| `Esc` | Voltar para leitura |
| `q` | Sair |
| `Ctrl+C` | Sair |
## Como Funciona
O rip utiliza múltiplas estratégias para contornar paywalls:
1. **Proxies de leitura**: Freedium, Scribe.rip para Medium
2. **User-Agent spoofing**: Simula Googlebot e Facebook Bot
3. **Cache**: Google Cache
4. **Arquivos**: Archive.is, Archive.org
5. **Serviços**: 12ft.io, RemovePaywall
O sistema tenta automaticamente cada estratégia até encontrar o conteúdo completo.
## Exemplos
```bash
# Inicie o rip
rip
# Cole a URL no campo de input e pressione Enter
# Exemplo: https://medium.com/@user/artigo-interessante
# Use j/k para navegar
# Pressione 't' para traduzir
# Pressione 'q' para sair
```
## Licença
MIT