KOReader

Sumário
- Sobre
- Links
- Por que KOReader?
- Gestos personalizados
- RSS
- Meu fluxo de leitura de artigos avulsos
- Bookmarklet dotepub no qutebrowser
- QR Code
- Interoperabilidade
- Plugins
- Log
Sobre
Esta página faz parte do repositório de Software
KOReader é um visualizador de e-books gratuito e open-source para diversos e-readers (aparelhos com tela E-ink). Na prática, funciona como um "sistema operacional" alternativo para estes aparelhos.
Também está disponível para smartphone, tablet e PC. Neste último, há inclusive suporte nativo a gamepad para operá-lo.
Sua instalação em aparelhos como Kindle, requer jailbreak (desbloqueio): um procedimento arriscado e que, se der errado, pode inutilizar seu aparelho para sempre.
No mais, alerto que esta página é bem longa e contém várias configurações avançadas. Portanto, sugiro o Sumário para acesso direto ao tópico desejado.
Links
Por que KOReader?
Primeiro, porque a Amazon definiu que, após 26/02/2025, não seria mais permitido o download dos arquivos de e-books do Kindle no PC. Com isso, elimina-se a possibilidade de salvá-los à parte, para eventual migração para aparelhos de outras marcas, como o Kobo.
Segundo, por questões de privacidade e o risco de os e-books serem removidos ou alterados. Este último aspecto é uma faca de dois gumes: por um lado, é ótimo ter acesso a uma nova edição sem custo adicional.
Por outro, certas modificações como: troca de capa, supressão de trechos relevantes etc., ferem de morte o registro histórico que a obra traz como retrato de sua época. Em suma, pode acontecer aos livros o mesmo que vem ocorrendo nos filmes e games.
Além disso, achei o KOReader bem melhor que o sistema nativo do Kindle, tanto em velocidade quanto em funcionalidade: antes, evitava consulta ao dicionário, pois perdia o foco da leitura diante da demora de seu carregamento; no Koreader, ele abre em menos de um segundo.
Quanto às funções, cito algumas: RSS, gestos personalizados, editor de texto, gerar QR Code, tradução de trechos selecionados, transferência de arquivos sem fio etc.
Gestos personalizados
Depois de conhecer apps como o µLauncher para Android, refleti sobre como usamos as telas de toque como meros "emuladores" de botões físicos, desconsiderando os movimentos mais naturais que elas possibilitam.
Nesse sentido, os gestos aproveitam a tela de toque em toda sua extensão, permitindo acesso direto a determinadas funções com um único movimento, sem ter que passar por diversos menus.
Isso cria uma memória muscular mais intuitiva, creio eu. Abaixo, vídeo que gravei demonstrando os gestos que configurei quando comecei a usar o KOReader (já os modifiquei bastante):
KOReader - Gestos e Primeiras Impressões - YouTube
RSS
O KOReader conta um plugin nativo de RSS que entrega, diretamente no e-reader, os posts de blogs e sites que acompanhamos.
A maioria deles possui feed RSS, de forma explícita ou velada. No primeiro caso, procure por seu ícone ou pelas palavras "feed" e "RSS".
Caso não encontre, uma tentativa que quase sempre dá certo é: usar a URL do site, acrescentando /rss (ou /feed). Exemplo: para https://curadoria.bearblog.dev/ ficaria https://curadoria.bearblog.dev/rss.
De posse dessa URL, abra o menu Ferramentas do KOReader, vá em News downloader (RSS/Atom), Edit news feeds, vá até a última página e toque em Add new feed. Agora, basta digitar a URL anotada no respectivo campo e tocar em Save.
Depois, basta ir novamente no menu Ferramentas e tocar em Sync news feeds. O KOReader irá baixar os últimos artigos do site ou blog e convertê-los para o formato .ePub.
Sem sombra de dúvida é, para mim, a forma mais confortável e prática de ler textos longos da internet; com a vantagem de poder fazê-lo offline (depois de baixados). Para quem gosta de uma leitura mais ativa, é possível fazer grifos e anotações que podem ser exportados para o formato Markdown.
Aaron Swartz
![]()
E, aqui, cabe lembrar: tanto o RSS quanto o Markdown têm como um de seus criadores, Aaron Swartz: ativista que partiu muito cedo, mas deixou um grande legado. Recomendo o documentário O Menino da Internet (2014).
Meu fluxo de leitura de artigos avulsos
Há casos de artigos presentes em sites que não assino, mas que quero ler no formato ePub. A seguir, os passos que sigo para fazê-lo no KOReader, usando o qutebrowser, nuvem do Nextcloud e bookmarklet do site dotepub:
- abrir a URL do artigo no qutebrowser;
- pressionar
o, digitardotepubno prompt eEnter; - confirmar a conversão e salvar o arquivo
.ePubno diretório/home/seu-nome-de-usuario/Nexcloud/books/; - no Kindle, com o KOReader instalado, ir em Ferramentas, Cloud Storage, selecionar WebDAV (nuvem configurada previamente);
- por fim, tocar no artigo desejado e
Download.
Bookmarklet dotepub no qutebrowser
O site dotepub oferece o serviço gratuito de conversão de páginas de internet para o formato .ePub, a fim de serem lidas em e-readers como Kindle e Kobo. Tratarei aqui da configuração para deixar este processo mais automatizado no qutebrowser.
Primeiro, faça-o por sua conta e risco! E tome sempre cuidado ao sair por aí copiando javascript de terceiros. A configuração a seguir é baseada no código disponível no site do dotepub, na seção bookmarklet, caso queira cotejá-lo.
abra o arquivo
quickmarks, este é seu caminho completo~/.config/qutebrowser/quickmarksAdicione nele uma nova linha com o texto abaixo:
dotepub javascript:(function(){try{var%20d=document,w=window;if(!d.body||d.body.innerHTML=='')throw(0);var%20s=d.createElement('link'),h=d.getElementsByTagName('head')[0],i=d.createElement('div'),j=d.createElement('script');s.rel='stylesheet';s.href='//dotepub.com/s/dotEPUB-favlet.css';s.type='text/css';s.media='screen';h.appendChild(s);i.setAttribute('id','dotepub');i.innerHTML='<div%20id=%22status%22><p>Conversion%20in%20progress...</p></div>';d.body.appendChild(i);j.type='text/javascript';j.charset='utf-8';j.src='//dotepub.com/j/dotepub.js?v=1.2&s=ask&t=epub&g=en';h.appendChild(j);}catch(e){w.alert('The%20page%20has%20no%20content%20or%20it%20is%20not%20fully%20loaded.%20Please,%20wait%20till%20the%20page%20is%20loaded.');}})();
- salve o arquivo, feche o qutebrowser e abra-o novamente.
Desta forma, sempre que estiver em um site com texto que queira converter para .ePub, basta pressionar o, digitar dotepub e Enter, conforme explicado no tópico Meu fluxo de leitura de artigos avulsos.
Não é algo tão prático quanto receber o artigo automaticamente por RSS, mas é útil para artigos avulsos bem longos que queremos ler no conforto da tela do nosso e-reader.
E claro: você não precisa usar o mesmo navegador nem as mesmas ferramentas. Existem outras formas de fazê-lo. Exemplos: usando a extensão EpubPress ou com o Calibre.
QR Code
Um dos recursos mais inusitados e interessantes do KOReader é a geração de QR Code: do texto selecionado ou copiado e, principalmente, de links para sites.
Como quase todo mundo anda com um smartphone a tiracolo, é uma ótima forma de manter o e-reader com o e-book aberto e copiar algum texto ou link com a câmera daquele aparelho tão libertário quanto uma bola de ferro com corrente.
PS: Acho legal quando usam QR Code para easter eggs em jogos e filmes. Exemplo de um que funciona até hoje é este, presente em Alan Wake:

E aí? Resistiu ou a curiosidade foi mais forte, fazendo-o mirar no QR Code da imagem acima com o smartphone? :-)
Interoperabilidade
Nextcloud
Trata-se de um app / serviço de armazenamento na nuvem. Destaca-se por dois motivos: é open source e costuma dar maior liberdade ao usuário no acesso direto aos arquivos e também na integração (interoperabilidade) com outros aplicativos. O Disroot oferece o serviço a seus usuários de e-mail.
No caso do KOReader, a integração com o Nextcloud se dá indo no menu de Ferramentas, Cloud storage, clicar sinal de + da esquerda superior e em Add new cloud storage, temos Dropbox, FTP e WebDAV. Escolhemos a última opção, WebDAV.
A partir daí, basta preencher os dados:
- um título, como "Nextcloud", para identificá-la;
- URL:
https://cloud.disroot.org/remote.php/dav/files/nomedousuario; - nome do usuário;
- senha;
- diretório onde colocará seus livros, exemplo:
/books(lembrando que tal pasta deve existir).
Com isso, da próxima vez que for em Ferramentas, Cloud storage, lá estará sua nuvem. Nela, você pode baixar e-books (e outros documentos). Poderá também fazer upload de conteúdo que já esteja em seu e-reader.
Plugins
De acordo com a Wikipédia, plugin é um programa de computador usado para adicionar funções a outros programas maiores, provendo alguma funcionalidade especial ou muito específica.
No caso do KOReader, existem plugins nativos, aqueles que já vêm instalados e também os externos, instalados manualmente. Esta seção tratará destes últimos. Basicamente, a instalação de um plugin no KOReader consiste apenas em copiar sua pasta descompactada para o diretório plugins.
Recomendo os tutoriais de Stefan Svartling, no YouTube.
File Browser
O File Browser permite não só a transferência de arquivos por Wi-Fi como também a leitura de .ePubs salvos no e-reader dentro do navegador (algo que ajuda quando não temos app de leitura de e-books instalado no PC).
O IP / URL para acesso geralmente é:
http://192.168.0.137/files/mnt/us/koreader/- ou
http://192.168.0.173/files/mnt/us/koreader/
Em caso de erro, conferir no KOReader indo na engrenagem, Network e Network Info.
Abaixo, duas capturas de um arquivo .ePub aberto no navegador do PC. Repare que o texto já vem disposto em duas colunas, adaptando o arquivo ao contexto. No caso, uma tela horizontal. Quando vi isto da primeira vez, achei genial:


P.S.: Essa abordagem é interessante também nos casos em que o livro traz alguma ilustração em página dupla. Mas, para isso dar certo, a editoração do e-book deve respeitar o padrão de páginas pares à esquerda e ímpares à direita.
LocalSend
O LocalSend tem agora um plugin para o KOReader!
Para quem não conhece, o LocalSend é um app multiplataforma que permite transferência de arquivos entre aparelhos que estão na mesma rede Wi-Fi. Basta dar um nome para seu dispositivo e aceitar a transferência quando alguém te enviar algo.
Com este plugin, seu e-reader consegue tanto receber quanto enviar arquivos. E, como o LocalSend permite o envio da área de transferência (clipboard), você também pode enviar seu "Ctrl+V" para o KOReader.
Isto pode ser útil para ler um texto "solto" que não está em .ePub e nem salvo em arquivo. Por exemplo: um trecho de artigo longo, basta selecionar, copiar e colar no LocalSend. Será criado no KOREader um arquivo apenas com aquele trecho, no formato .txt.
Abaixo o repositório oficial e um tutorial em vídeo do "embaixador" do KOReader no Youtube, Stefan Svartling:
- localsend.koplugin - GitHub
- How to install LocalSend KOReader plugin and send and receive files wirelessly on your e-reader - Stefan Svartling - YouTube
Readest
Ainda não testei este. É o plugin de um app que parece ser bom demais para ser verdade. Portanto, se for usá-lo, é por sua conta e risco! Tomei conhecimento dele por meio deste vídeo tutorial do Stefan Svartling. Também foi mencionado no site Manual do Usuário.
Ele sincroniza não só o progresso de leitura, como também grifos e anotações: uma experiência próxima ao Whispersync do Kindle. Algo revolucionário para uma solução de código aberto não auto-hospedada.
Por qual motivo tenho um pé atrás com ele?
O fato de um app FOSS (gratuito e de código aberto) possuir login + sincronização na nuvem é um tanto incomum. A título de comparação: o Anki, app de flashcards, capta recursos com as versões para iOS, que são pagas. Daí, vem a pergunta: este modelo de negócio do Readest é sustentável?
No site oficial, o único patrocionador à mostra é uma empresa de IA chamada "TestMu AI". um app que começou há pouco tempo e já conta com aportes de uma empresa desse ramo me remete a lembranças ruins: em 2024, o excelente Omnivore foi adquirido por uma empresa de IA e, logo em seguida, descontinuado.
Log
2026-04-12
- criação desta página "KOReader";