legado-for-mac-pub

Project Overview

Legado for macOS is a native macOS reader built with SwiftUI, aiming to bring the Legado book sources, bookshelf, and reading features from Android to Apple's desktop platform. It keeps the Legado JSON rule format, so Android book sources and shelf data can be imported directly, and supports online search, source switching, chapter caching, and RSS. The interface uses a native macOS dark layout that stays close to system conventions.

Move Legado's sources and reading habits into a native macOS app, as-is.

Key Features

• Source management: import, edit, enable/disable, and batch-export book sources
• Data migration: imports Android book source JSON and shelf JSON
• Local reading: TXT and EPUB import, chapter detection, and per-chapter reading
• Online reading: online search, source discovery, source switching, chapter caching, and preloading
• Rule parsing: CSS, JSONPath, XPath, regex, and JavaScript rules, including JSOUP chained rules and recursive JSONPath
• RSS subscription: standard RSS/Atom, custom RSS rules, paging, and article bodies
• Reading records: progress, scroll position, bookmarks, history, and replacement rules
• Data management: JSON backup and restore, cover cache, network proxy, and custom shortcuts

Target Audience

• Users reading online novels on macOS
• People with a large Legado source collection wanting to move to desktop
• Users who need RSS subscription reading
• Readers who prefer a native macOS experience

Quick Start

1. Ensure macOS 13+ and Swift 5.9+
2. Run swift build, or swift run for a development build
3. Run ./build_app.sh to produce a double-clickable macOS app
4. Import Android book source JSON and shelf JSON in the app
5. Find books via search or subscriptions, add them to the shelf, and read

Core Advantages

• Native experience: built with SwiftUI, matching macOS conventions in look and interaction
• Rule compatibility: keeps the Legado JSON rule format for seamless source reuse
• Migratable data: shelf, sources, and reading data import directly from Android
• Local-first: data stays under ~/Library/Application Support/Legado/

System Requirements

Item	Requirement
OS	macOS 13 or later
Toolchain	Swift 5.9 or later; Xcode 15+ recommended
Data directory	~/Library/Application Support/Legado/

Notes

• Features depending on Android WebView, Java classes, login UI, audio/image book rendering, and iCloud sync remain compatibility boundaries
• Licensed under GPL-3.0; the original project is gedoor/legado
• Verify the trustworthiness of a backup file before restoring it
• The app provides no book content; import legitimate sources and local files yourself