explaingit

gedoor/legado

Analysis updated 2026-05-18

46,463KotlinAudience · vibe coderComplexity · 3/5LicenseSetup · 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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

KotlinAndroidJsoupJsonPath

How does it compare?

gedoor/legadosquare/okhttpandroid/architecture-samples
Stars46,46346,95045,659
LanguageKotlinKotlinKotlin
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

Frequently asked questions

What is legado?

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.

What language is legado written in?

Mainly Kotlin. The stack also includes Kotlin, Android, Jsoup.

What license does legado use?

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

How hard is legado to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is legado for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub gedoor on gitmyhub

Verify against the repo before relying on details.