๐ [ไธญๆ](README.md) ยท [English](README.en.md) ยท [ๆฅๆฌ่ช](README.ja.md) ยท **ํ๊ตญ์ด**
๐ **์ฌ์ฉ์ ๊ฐ์ด๋** ยท [โ๏ธ ๊ฐ๋ฐ์ ๋ฌธ์](README.dev.ko.md)
---
# Lumi โ ๋
์๋ฅผ ์ํด ํ์ด๋๋ค
> ๊น๋ํ๊ณ ์ฐ์ํ Android ๋ก์ปฌ ์ ์์ฑ
๋ฆฌ๋. EPUB, PDF, TXT ์ง์. ๊ฐ์ธ์ ๋ณด ๋ณดํธ ์ต์ฐ์ , ์์ ์คํ๋ผ์ธ.
[](https://github.com/huangder/Lumi_Books/releases)
[](LICENSE)
[](https://developer.android.com)
[](https://kotlinlang.org)
[](https://huangder.top/sponsor.html)
---
## โจ ๊ธฐ๋ฅ
### ๐ ๋
์ ๊ฒฝํ
- EPUB, PDF, TXT ์ธ ๊ฐ์ง ํ์ ์ง์
- **EPUB ๋์ผ ๋ ๋๋ง ๋ชจ๋**๏ผ๋ถ ๋ ์ด์์๏ผ์ถํ์ฌ HTML/CSS/๊ธ๊ผด ์ ์ง๏ผ+ ๋ฆฌ๋ ๋ ์ด์์๏ผํต์ผ๋ ํ์ดํฌ๊ทธ๋ํผ๏ผ
- Canvas + StaticLayout ์์ฒด ๋ ๋๋ง ์์ง, ๋ถ๋๋ฌ์ด ํ์ด์ง ๋๊น ์ ๋๋ฉ์ด์
- **๋ค ๊ฐ์ง ํ์ด์ง ๋๊น ํจ๊ณผ**๏ผ์ฌ๋ผ์ด๋, ์คํฌ๋กค, ํ์ด๋, ์ปฌ๏ผ์ค์ ์ฑ
์ฅ ๋๊น ์๋ฎฌ๋ ์ด์
๏ผ
- **Bionic Reading๏ผ๋ฐ์ด์ค๋ ๋ฆฌ๋ฉ๏ผ**๏ผ๋จ์ด ์๋ถ๋ถ์ ๊ตต๊ฒ ํ์ํ์ฌ ์ฝ๊ธฐ ์๋์ ์ง์ค๋ ฅ ํฅ์
- ๋ค์ํ ์ฝ๊ธฐ ํ
๋ง๏ผ๋ฎ / ๋ฐค / ์ธํผ์ / ๊ทธ๋ฆฐ + ์ฌ์ฉ์ ์ง์ ์์๏ผ
- ์ธ๋ฐํ ํ์ดํฌ๊ทธ๋ํผ ์ค์ ๏ผ๊ธ๊ผด ํฌ๊ธฐ, ์ค ๊ฐ๊ฒฉ, ์๊ฐ, ๋ฌธ๋จ ๊ฐ๊ฒฉ, 4๋ฉด ๋
๋ฆฝ ์ฌ๋ฐฑ, ๋ค์ฌ์ฐ๊ธฐ๏ผ
- ์ฌ์ฉ์ ์ง์ ํ
์คํธ ์์ ๋ฐ ๋ฐฐ๊ฒฝ๏ผHSL ์์ ์ ํ๊ธฐ + ๊ฐค๋ฌ๋ฆฌ ์ฌ์ง๏ผ
- **์ฌ์ฉ์ ์ง์ ๊ธ๊ผด**๏ผ๋ด์ฅ LXGW WenKai, Fangsong, Kaiti + ๊ฐ์ธ ๊ธ๊ผด ๊ฐ์ ธ์ค๊ธฐ๏ผ.ttf๏ผ
- ์ค๋งํธ ์ ์ค์ฒ ์์คํ
๏ผ์ข์ฐ ํญ์ผ๋ก ํ์ด์ง ๋๊น, ์ค์ ํญ์ผ๋ก ๋ฉ๋ด, ๋๋๊ทธ๋ก ํ์ด์ง ๋๊น๏ผ
- ๋ณผ๋ฅจ ํค ํ์ด์ง ๋๊น๏ผ๋ฐฉํฅ ์ค์ ๊ฐ๋ฅ๏ผ
- ๋ชจ์๋ฆฌ ์ ๋ณด ํ์ ์ฌ์ฉ์ ์ง์ ๏ผ์ฑํฐ / ์งํ๋ฅ / ํ์ด์ง ๋ฒํธ / ๋ฐฐํฐ๋ฆฌ๏ผ
- **์ค๊ตญ์ด ๊ฐ์ฒด/๋ฒ์ฒด ๋ณํ**๏ผ์ฑ
๋ณ๋ก ์๋ฌธ / ๊ฐ์ฒด / ๋ฒ์ฒด ์ ํ
- ํ๋ฉด ์๊ฐ ์ ํ ์ฌ์ ์๏ผ์ฝ๋ ๋์ ํ๋ฉด ์ผ์ง ์ ์ง๏ผ
### ๐ง TTS & ์ค๋์ค๋ถ
- ์์คํ
TTS ์์ง ํตํฉ
- **์๋ํํฐ TTS API ์ง์**๏ผOpenAI ํธํ TTS, Xiaomi MiMo Chat TTS
- ์คํธ๋ฆฌ๋ฐ ์ค๋์ค ์บ์๏ผ์๋ ์ ๋ฆฌ ํ๋ ์ค์ ๊ฐ๋ฅ๏ผ
- ํฌ๊ทธ๋ผ์ด๋ ์๋น์ค + ์๋ฆผ ์ ์ด๏ผ์ฌ์ / ์ผ์์ ์ง / ์ด์ ๋ฌธ์ฅ / ๋ค์ ๋ฌธ์ฅ๏ผ
### โจ ํ
์คํธ ์ ํ & ์ฃผ์
- Android ๋ค์ดํฐ๋ธ ํ
์คํธ ์ ํ + ์ฌ์ฉ์ ์ง์ Compose ํ๋กํ
๋ฉ๋ด
- 6์ ํ์ด๋ผ์ดํธ๏ผํญํ์ฌ ๋ณด๊ธฐ ๋ฐ ์์ ๋ณ๊ฒฝ๏ผ
- ํ์ด๋ผ์ดํธ ํ
์คํธ์ ์ฐ๊ฒฐ๋ ๋
ธํธ
- ์ ์ฒด ํ
์คํธ ๊ฒ์๏ผ๊น๋นก์ด๋ ํ์ด๋ผ์ดํธ ํ์๏ผ
- ์ฑ
๊ฐํผ๏ผ์ถ๊ฐ / ์ญ์ / ๋น ๋ฅธ ์ด๋
- **์ฃผ์ ๋ด๋ณด๋ด๊ธฐ**๏ผ์ฑ
๊ฐํผ + ํ์ด๋ผ์ดํธ + ๋
ธํธ๏ผ
### ๐ ์ฑ
์ฅ ๊ด๋ฆฌ
- ๋ก์ปฌ ํ์ผ ๊ฐ์ ธ์ค๊ธฐ๏ผ์์คํ
ํ์ผ ์ ํ๊ธฐ + ์ฑ
ํด๋ ๊ถํ ๋ถ์ฌ, ๋ณต์ฌ ๋ถํ์๏ผ
- ์๋ ์ถ์ถ ์ฑ
ํ์ง๏ผCoil ์ด๋ฏธ์ง ๋ก๋ฉ๏ผ
- **์ ์ฒด ํ
์คํธ ๊ฒ์**๏ผ์ ์ฒด ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๊ฒ์
- **์ฌ์ฉ์ ์ง์ ํ๊ทธ**๏ผ์ฑ
๋ถ๋ฅ์ฉ
- ์ฌ์ฉ์ ์ง์ ํ์ง๏ผ๊ฐค๋ฌ๋ฆฌ์์ ์ ํ๏ผ
- ์ฑ
๋ฉํ๋ฐ์ดํฐ ํธ์ง๏ผ์ ๋ชฉ, ์ ์๏ผ
- ์ฆ๊ฒจ์ฐพ๊ธฐ / ์ญ์ ๊ด๋ฆฌ
- ๊ธธ๊ฒ ๋๋ฅด๊ธฐ ์ปจํ
์คํธ ๋ฉ๋ด๏ผ๊ธ๋์ค๋ชจํผ์ฆ ์ค๋ฒ๋ ์ด๏ผ
### ๐ ๋
์ ํต๊ณ
- ์ค๋์ ๋
์ ์๊ฐ + ์ฃผ๊ฐ ํธ๋ ๋
- ์ฌ์ฉ์ ์ง์ ๊ฐ๋ฅํ ์ผ์ผ ๋
์ ๋ชฉํ
- ์ฃผ / ์ / ์ฐ๋ ํญ ๋ค๋น๊ฒ์ด์
- ์๊ฐ ํํธ๋งต๏ผ๋ฌ๋ ฅ ๊ทธ๋ฆฌ๋, ๋
์ ์๊ฐ๋ณ ์์๏ผ
- ์ฐ๊ฐ ํํธ๋งต๏ผGitHub ๊ธฐ์ฌ ๊ทธ๋ํ ์คํ์ผ, 53ร7 Canvas ๋ ๋๋ง๏ผ
- ์ฃผ๊ฐ ๋ง๋ ๊ทธ๋ํ
- ์ฐ์ ๋
์ ์ผ์ ๊ธฐ๋ก
### โ๏ธ ํด๋ผ์ฐ๋ ๋๊ธฐํ & ๋ฐฑ์
- **WebDAV ํด๋ผ์ฐ๋ ๋๊ธฐํ**๏ผ์ฑ
, ๋
์ ์งํ๋ฅ , ๋
ธํธ, ์ฑ
๊ฐํผ๋ฅผ ๊ฐ์ธ WebDAV ์๋ฒ์ ์๋ ๋๋ ์๋ ๋๊ธฐํ
- ์ฐ๊ฒฐ ํ
์คํธ + ๋ง์ง๋ง ๋๊ธฐํ ์๊ฐ ํ์
- **๋ก์ปฌ ๋ฐฑ์
๋ฐ ๋ณต์**๏ผZIP ๋ด๋ณด๋ด๊ธฐ/๊ฐ์ ธ์ค๊ธฐ๏ผ๋ฐ์ดํฐ๋ฒ ์ด์ค + DataStore + ํ์ง + ์ฑ
๏ผ
- ์ ์ฅ ๊ณต๊ฐ ์ฌ์ฉ๋ ์๊ฐํ
### ๐จ ํ
๋ง & ์ธ๊ด
- **์ธ ๊ฐ์ง ์ฑ ํ
๋ง**๏ผ๊ธฐ๋ณธ๏ผํ
๋ง ์์ ๋ณ๊ฒฝ ๊ฐ๋ฅ, ์ด๊ธฐ ์์์ Lumi ํํฌ๏ผ, Material 3๏ผ๋ค์ด๋๋ฏน ์ปฌ๋ฌ๏ผ, Liquid Glass๏ผ๋ฆฌํด๋ ๊ธ๋์ค๏ผ
- Liquid Glass๏ผํฌ๋ช
๋ ์กฐ์ + HDR ํฐ์น ํ์ด๋ผ์ดํธ
- ๋คํฌ ๋ชจ๋๏ผ์์คํ
์ฐ๋ / ๋ผ์ดํธ / ๋คํฌ๏ผ
- Motion Pro ์ ๋๋ฉ์ด์
๏ผ๋ฒ ํ๏ผ
- ์ ํ์ ์คํ๋์ ํ๋ฉด
- ์์ธกํ ๋ค๋ก ๊ฐ๊ธฐ ์ ์ค์ฒ ์ง์
- UI ์์ ์ ํ ์ ๋๋ฉ์ด์
- **๋ค๊ตญ์ด ์ง์**๏ผ7๊ฐ ๋ก์ผ์ผ โ ์ค๊ตญ์ด ๊ฐ์ฒด, ์ค๊ตญ์ด ๋ฒ์ฒด(์ค๊ตญ ํ์ด์), ์ค๊ตญ์ด ๋ฒ์ฒด(์ค๊ตญ ํ์ฝฉ), ์ค๊ตญ์ด ๋ฒ์ฒด(์ค๊ตญ ๋ง์นด์ค), English, ๆฅๆฌ่ช, ํ๊ตญ์ด
### โ๏ธ ์ค๋งํธ PDF ์ฒ๋ฆฌ
- **๋ก์ปฌ ์ถ์ถ**๏ผ๊ธฐ๊ธฐ ๋ด PDF ํ
์คํธ ๋ ์ด์ด ์ถ์ถ๏ผ์ค์บ PDF ๋ฏธ์ง์๏ผ
- **MinerU ํด๋ผ์ฐ๋ ํ์ฑ**๏ผ์๋ํํฐ ์๋น์ค๏ผ๏ผ
- ๋ผ์ดํธ ๋ชจ๋๏ผ๋ฌด๋ฃ, ํ ํฐ ๋ถํ์, ์ต๋ 10MB / 20ํ์ด์ง
- ์ ๋ฐ ๋ชจ๋๏ผ๊ฐ์ธ ํ ํฐ ํ์, ์ต๋ 200MB / 200ํ์ด์ง, VLM ๊ตฌ๋
- ์๋ ๋ชจ๋๏ผMinerU ์น์ฌ์ดํธ์์ ์ฒ๋ฆฌ ํ ZIP/Markdown ๊ฐ์ ธ์ค๊ธฐ
- PDF๋ฅผ ๋ฆฌํ๋ก์ฐ ๊ฐ๋ฅํ ์ ์์ฑ
์ผ๋ก ๋ณํํ์ฌ ํต์ผ๋ ๋
์ ๊ฒฝํ ์ ๊ณต
### ๐ ๊ฐ์ธ์ ๋ณด ๋ณดํธ
- **๋ก์ปฌ ์ฐ์ ** โ ์
๋ฐ์ดํธ ํ์ธ ์์๋ง GitHub ์๋ฒ์ ์ฐ๊ฒฐ, ๊ฐ์ธ์ ๋ณด ์ ์ก ์์
- **์๋ํํฐ SDK ์ ๋ก** โ ๋ถ์, ๊ด๊ณ , ํธ์ ์๋ฆผ, ํฌ๋์ ๋ณด๊ณ ์์
- **Android ์๋๋ฐ์ค ์ ์ฅ์** โ ๋ชจ๋ ๋ฐ์ดํฐ๋ ์ฑ ์ ์ฉ ๋๋ ํฐ๋ฆฌ์๋ง ์ ์ฅ
- **์คํ์์ค, ๊ฐ์ฌ ๊ฐ๋ฅ** โ ์ ์ฒด ์์ค ์ฝ๋ ๊ณต๊ฐ, ๋๊ตฌ๋ ๊ฒํ ๊ฐ๋ฅ
- ์ฒซ ์คํ ์ ๊ฐ์ธ์ ๋ณด ์ฒ๋ฆฌ๋ฐฉ์นจ ๋ฐ ์ด์ฉ์ฝ๊ด ํ์, ํฌ๋ช
ํ ๊ณ ์ง
- ๋ฏผ๊ฐ ์ ๋ณด๏ผWebDAV, TTS API ํค๏ผ๋ Android KeyStore๋ก ์ํธํ ์ ์ฅ
---
## ๐ฅ ๋ค์ด๋ก๋
[GitHub Releases](https://github.com/huangder/Lumi_Books/releases)์์ ์ต์ APK๋ฅผ ๋ค์ด๋ก๋ํ์ธ์.
---
## ๐ ๋ณ๊ฒฝ ์ด๋ ฅ
[๋ณ๊ฒฝ ์ด๋ ฅ](https://huangder.top/changelog.html)์ ํ์ธํ์ธ์.
---
## โญ ์คํ ๊ธฐ๋ก
---
## ๐ ๋ผ์ด์ ์ค
Lumi์ ์ค๋ฆฌ์ง๋ ์ฝ๋๋ [GNU GPLv3](LICENSE)์ ๋ฐ๋ผ ์คํ์์ค๋ก ๊ณต๊ฐ๋ฉ๋๋ค. ์๋ํํฐ ์ข
์์ฑ ๋ฐ ๊ฐ์ ์ฝ๋๋ ๊ฐ๊ฐ์ ๋ผ์ด์ ์ค๋ฅผ ๋ฐ๋ฆ
๋๋ค. ์ปฌ ํ์ด์ง ๋๊น์ GPLv3 ํ๋ก์ ํธ [legado-E](https://github.com/Luoyacheng/legado-E)๋ฅผ ๊ฐ์ํ์ผ๋ฉฐ, Liquid Glass ๊ตฌํ์ Apache 2.0 ๋ผ์ด์ ์ค์ [AndroidLiquidGlass / Backdrop](https://github.com/Kyant0/AndroidLiquidGlass)์ ๊ฐ์ํ์ฌ ์ฌ์ฉํฉ๋๋ค. ยฉ 2026 Huangder
---
## ๐ ๋งํฌ
- ๐ ์น์ฌ์ดํธ๏ผ[huangder.top](https://huangder.top)
- ๐ฆ GitHub๏ผ[github.com/huangder/Lumi_Books](https://github.com/huangder/Lumi_Books)
- ๐ง ์ด๋ฉ์ผ๏ผhuangder0104@126.com
---
์ข์ ์ฑ
์๋ ์ข์ ๋ฆฌ๋๊ฐ ์ด์ธ๋ฆฝ๋๋ค.