Z-Library

zlib

A CLI for Z-Library.

English | 中文

Features

• 🔍 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 — auto, mocha, latte, dracula, tokyo, nord, gruvbox
• 🌐 Proxy & custom domain support for restricted networks

Install

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

Claude Code plugin

zlib ships a Claude Code plugin, so Claude can search and download books for you.

/plugin marketplace add heartleo/zlib
/plugin install zlib@zlib-plugin-cc

/zlib "the pragmatic programmer" to search and download. /zlib:kindle sends a book to your Kindle.

Quick Start

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

Commands

login

zlib login
zlib login --email [email protected] --password secret

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

logout

zlib logout

search

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
zlib search "dune" --json   # machine-readable output for scripts and plugins

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

download

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

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

history

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 history --json   # machine-readable, always non-interactive

profile

zlib profile
zlib profile --json

kindle

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

theme

zlib theme           # show current
zlib theme auto      # follow terminal background
zlib theme nord      # set globally

Available: auto · mocha · latte · dracula · tokyo · nord · gruvbox

Configuration

Keep secrets like ZLIB_SMTP_PWD out of your shell history — put them in an .env file instead of exporting them inline. zlib reads env vars with this precedence: real environment > working-directory .env > ~/.config/zlib/.env. The global file is the recommended home for machine-wide values.

Variable	Description
ZLIB_DOMAIN	Override the default Z-Library domain
ZLIB_PROXY	Proxy URL, e.g. http://127.0.0.1:7890
ZLIB_SMTP_PWD	SMTP password for Kindle delivery
ZLIB_THEME	Override theme without changing config