A CLI for Z-Library.

English | 中文

• 🔍 Interactive search — browse results with ↑/↓, switch pages with ←/→
• 📥 Book download — by book ID, from search results, with live progress
• 📚 Download history — paginated history browser with download support
• 📖 Send to Kindle — deliver files to your Kindle address
• 🕒 Usage profile — view daily download quota
• 🎨 Themes — mocha, dracula, tokyo, nord, gruvbox
• 🌐 Proxy & custom domain support for restricted networks

Homebrew (macOS / Linux):

brew install heartleo/tap/zlib

winget (Windows):

winget install heartleo.zlib

curl (macOS / Linux):

curl -fsSL https://raw.githubusercontent.com/heartleo/zlib/main/install.sh | sh

Prebuilt binaries — download from GitHub Releases:

Go install (requires Go 1.25+):

go install github.com/heartleo/zlib/cmd/zlib@latest

Build from source:

git clone https://github.com/heartleo/zlib
cd zlib
go build -o zlib ./cmd/zlib

zlib login
zlib search        # interactive mode
zlib search "dune" # static table

zlib login
zlib login --email you@example.com --password secret

Saves session to ~/.config/zlib/session.json.

zlib logout

Without arguments, opens an interactive picker:

• type a query and confirm
• browse results with ↑/↓
• switch pages with ←/→
• press Enter to download

zlib search # interactive mode
zlib search "dune" --page 2 # static table

Filter by file format with --ext (or its alias --format), repeatable.

zlib search "python crash course" --ext epub --ext pdf

Use --full-title to disable title truncation

zlib search "civilized to death" --full-title

zlib download Gz31nyAV5E
zlib download Gz31nyAV5E --dir ./books --send-to-kindle

Press Ctrl+C to cancel. Incomplete files are removed automatically.

Without flags, opens an interactive history browser:

• browse with ↑/↓, switch pages with ←/→
• press Enter to re-download

zlib history
zlib history --download Gz31nyAV5E --dir ./books
zlib history --format epub

zlib profile

Configure Kindle delivery settings:

• recipient Kindle address
• sender address
• SMTP host and port

SMTP password is never stored on disk — set ZLIB_SMTP_PWD instead.

zlib kindle                  # configure
zlib kindle send             # pick a file interactively
zlib kindle send ./dune.epub # send a local file

Supported formats: EPUB PDF MOBI TXT DOC DOCX RTF HTML

zlib theme           # show current
zlib theme nord      # set globally

Available: mocha · dracula · tokyo · nord · gruvbox

Create a .env file in the working directory, or set environment variables directly: