9

Pitch: Vibe codei um plugin para ler o TabNews no Kindle (e ele se atualiza sozinho)

Era uma dessas noites em que eu estava lendo conteúdo aqui no TabNews antes de dormir, pelo celular, e o meu Kindle estava parado do lado. Ele é desbloqueado, roda o KOReader e tem Wi-Fi... e eu pensei: por que eu estou forçando a vista no celular se tenho uma tela e-ink bem aqui?

Ali mesmo, ainda no celular, comecei a vibe codar um plugin. Fui testando no Kindle, vendo o que fazia falta no meu uso e pedindo as melhorias, uma de cada vez. A ideia inicial era só ler os posts; quando vi, tinha edição do dia, busca, tabcoins e atualização automática.

TabNews no Kindle: edição do dia

Repare no primeiro post da edição dessa foto: é um post meu. Não foi combinado, juro. 😄

O que o plugin faz

  • Edição do dia: os 10 posts mais relevantes num único documento, com índice clicável, como um jornal. Liga o Wi-Fi, sincroniza, desliga e lê
  • Relevantes e Recentes em lista, com tabcoins, comentários e tempo de leitura
  • Leitura offline: cada post é salvo com imagens e comentários
  • Busca: na web, num índice local de títulos e no texto completo dos posts salvos, inclusive sem internet
  • Autores favoritos: segure o dedo num post para seguir o autor
  • Esconder categorias: dá para esconder, por exemplo, todos os posts "Pitch:" (sim, este aqui incluso)
  • Tabcoins direto do Kindle: dá para votar no post que você está lendo
  • Comentários novos: a lista mostra (+3) quando chegou comentário num post que você já baixou
  • Sincronização automática ao conectar no Wi-Fi, com opção de desligar o Wi-Fi no final para economizar bateria
  • Atualização automática: quando sai versão nova, o próprio plugin oferece a atualização pelo Wi-Fi

Tabelas, listas, blocos de código, links e imagens dos posts aparecem formatados. Fonte, margens e realce continuam sendo os do KOReader.

Lista de posts recentes no Kindle

Como foi feito

O plugin foi vibe codado sob a minha direção, com o Claude, da Anthropic. Eu trouxe a ideia, testei tudo no Kindle, encontrei os bugs e decidi o que entrava; o Claude escreveu o código. No começo eu mandava cada versão para o Kindle por SSH, pelo Termux no celular. Hoje o projeto tem testes automatizados, release automática no GitHub Actions e o plugin se atualiza sozinho no aparelho.

Alguns detalhes técnicos que achei interessantes:

  • Markdown → HTML em Lua: a API devolve o corpo em Markdown, então o plugin tem um conversor próprio, testado com dezenas de posts reais daqui
  • A API não tem busca: a solução foi combinar uma busca na web restrita ao TabNews com um índice local de títulos, que se atualiza aos poucos e funciona offline
  • Edição do dia: é montada a partir dos posts já salvos, reaproveitando as imagens, sem baixar nada de novo
  • Login: usa a API de sessões e guarda só o token, nunca a senha
  • Atualização segura: antes de trocar os arquivos, o plugin confere se o código baixado é válido e se a versão bate com a release

Instalação

Precisa de um e-reader com KOReader. No Kindle, isso exige o aparelho desbloqueado.

  1. Baixe o tabnews.koplugin.zip da última versão
  2. Descompacte e copie a pasta tabnews.koplugin para koreader/plugins/ pelo cabo USB
  3. Reinicie o KOReader. O menu fica em Ferramentas → TabNews

Só a primeira instalação é manual. Depois disso, as atualizações chegam pelo próprio Kindle.

Testei no meu Kindle. Deve funcionar em Kobo, PocketBook e Android com KOReader; se você testar, me conta!

Contribuições

O código está aqui: https://github.com/DougNeo/tabnews_kindle

Issues, sugestões e PRs são muito bem-vindos. E se tiver alguma ideia do que faria sentido para ler o TabNews no e-ink, comenta aí que eu vejo se dá para incluir.

Carregando publicação patrocinada...
1

Parabéns pelo projeto, Doug, achei bem massa! E usar IA pra essas coisas é uma mão na roda mesmo :)

O que mais você usa no seu Kindle com o KOReader? Eu fiz o jailbreak no meu também, mas desde então não usei pra nada. Só uso o Kindle pra algumas leituras pontuais mesmo (a maior parte leio em livro físico). O que me motivou a fazer o jailbreak foi um vídeo que ficou bem popular: It's Time to Jailbreak Your Kindle.

1
2

Boa ideia, e foi justamente por aí que eu comecei! A primeira tentativa foi usar esse feed com o News Downloader, que já vem no KOReader, mas não funcionou no meu Kindle, então resolvi partir para um plugin próprio usando a API.

Olhando o feed de novo agora: ele traz os 30 posts mais recentes com o HTML já renderizado pelo próprio TabNews, o que daria fidelidade total na leitura e baixaria tudo numa requisição só. Por outro lado, ele não tem os relevantes (que alimentam a edição do dia), nem comentários, tabcoins ou posts mais antigos, então a API continua sendo a base do plugin.

Vou analisar o ganho que teríamos hoje usando o RSS como complemento na sincronização dos recentes. Valeu pela sugestão!

1
2

Sim, e o meu estava parado. Tinha feito o jailbreak dele, mas não tinha usado tanto. Agora com o plugin, todo dia antes de deitar costumo pegar para dar uma lida nas postagens, ver notícias ou ideias novas apresentadas aqui no TabNews. Muito bom!