explaingit

gedoor/legado

46,738KotlinAudience · vibe coderComplexity · 3/5ActiveLicenseSetup · moderate

TLDR

Free Android app for reading online novels from any website by defining custom scraping rules, with no ads and full control over your reading experience.

Mindmap

mindmap
  root((Legado))
    What it does
      Read web novels
      Custom sources
      Ad-free reading
    Key features
      Customizable interface
      Local file support
      Content replacement
      Web API access
    Use cases
      Follow multiple platforms
      Centralize reading
      Strip ads from text
      Import source configs
    Tech stack
      Kotlin
      Jsoup parsing
      JsonPath queries
    Audience
      Web fiction readers
      Android users
      Community builders

Things people build with this

USE CASE 1

Read web novels from multiple Chinese platforms in one ad-free app without switching between websites.

USE CASE 2

Create custom book sources by writing scraping rules to add any novel website to the app.

USE CASE 3

Customize your reading interface with fonts, colors, backgrounds, and animations to suit your preferences.

USE CASE 4

Automate novel reading workflows by using the web API or Content Provider to integrate with external tools.

Tech stack

KotlinAndroidJsoupJsonPath

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Android SDK and emulator/device setup; Kotlin/Gradle build system needs initial dependency resolution.

Use it freely, but any project you distribute that includes this code must also be GPL-licensed and open source.

In plain English

Legado is a free and open-source Android app for reading online novels and web fiction. Unlike conventional ebook readers that only handle files you already own, Legado lets you define your own content sources, websites or online novel platforms, by writing rules that tell the app how to scrape and parse their pages. Once a source is configured, you can search, browse, and read content from it directly inside the app, without advertisements and with full control over your reading experience. The app does not come with built-in content. Users add \"book sources\" (configurations for scraping specific websites) or import them from the community. This design is intentional: it means the app works with virtually any novel website as long as someone has written the corresponding source rule. Key features include a fully customizable reading interface (fonts, colors, background, line spacing, page-turn animations), support for local TXT and EPUB files, content replacement rules to strip ads from scraped text, a subscription feature for following specific content, and both Chinese and English interfaces. The app also exposes a web API and a Content Provider API so external tools or scripts can interact with it programmatically, and supports importing configurations via special URLs. You would use Legado if you are a Chinese web fiction reader who wants a consistent, ad-free reading experience across multiple novel platforms, or if you want to centralize your online reading in a single app with fine-grained display customization. The app is written in Kotlin and targets Android. It is entirely open-source and ad-free. The underlying scraping engine uses libraries including Jsoup for HTML parsing and JsonPath for JSON-based sources.

Copy-paste prompts

Prompt 1
How do I create a custom book source for Legado to scrape novels from a specific website?
Prompt 2
Show me how to use Legado's web API to programmatically search and fetch novel content.
Prompt 3
What are the content replacement rules in Legado and how do I use them to remove ads from scraped text?
Prompt 4
How do I import a book source configuration into Legado using a URL?
Prompt 5
Explain how Legado's reading interface customization works and what display options are available.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.