PixivBiu，一款不错的 Pixiv 辅助工具。
- 浏览：完整客户端体验，作品、用户、排行，收藏与关注等
- 筛选：快速筛选，如收藏数、浏览量、标签、类型等
- 下载：原图下载，包括单图、多图、动图
- 桌面与服务器：全平台支持，提供 Windows、macOS、Linux 程序包
Core 拥有完整前后端功能。如果你有轻量、可控、服务器使用需求，可以直接使用 Core 版本。
- 前往 Releases，下载对应系统的程序包
- 解压并运行
pixivbiu文件 - 在浏览器中打开 http://127.0.0.1:4001 即可
Desktop 版本是对 Core 使用的封装，功能上与 Core 完全相同。如果在桌面系统使用，此版本会更加易用。
- 前往 Desktop-Releases
- 下载对应系统的桌面包，打开并运行即可
与功能、使用相关的配置，可以直接在设置页面中修改。
但请注意，有部分运维相关配置项，只能通过配置文件或环境变量修改。
常用环境变量：
| 变量 | 作用 |
|---|---|
PIXIVBIU_SERVER_HOST |
监听地址（默认 127.0.0.1；0.0.0.0 对外） |
PIXIVBIU_SERVER_PORT |
监听端口（默认 4001） |
PIXIVBIU_LOG_LEVEL |
日志级别 debug / info / warn / error |
PIXIVBIU_DOWNLOAD_UGOIRA_FORMAT |
动图输出 webp / gif / none |
PIXIVBIU_APP_LANGUAGE |
界面语言 auto / en / zh-CN / zh-TW / ja |
PIXIVBIU_PIXIV_PROXY |
代理 URL（scheme://host，空 = 直连） |
具体的配置说明，可参见 docs/CONFIGURATION.md 文档。
你也可以直接通过 Docker Image 运行 PixivBiu。
docker run -d --name pixivbiu -p 4001:4001 \
-v pixivbiu-data:/data -v "$PWD/downloads:/downloads" \
ghcr.io/txperl/pixivbiu:latest亦或是通过 Docker Compose 运行。
# clone repo and move to
git clone https://github.com/txperl/PixivBiu.git
cd PixivBiu
# (host bind mount for downloads) make the dir writable by the container's uid
mkdir -p downloads && sudo chown 65532:65532 downloads
# start it
docker compose up -d完整的 Docker 相关说明，可参见 docs/DOCKER.md 文档。
构建与开发需要 Go 1.26+、bun、make 环境。
git clone https://github.com/txperl/PixivBiu.git
cd PixivBiu
# 构建前端与后端
# 产出的 bin/pixivbiu 已将前端内嵌
make dist
# 执行
./bin/pixivbiu开发时，可以 make dev 启动后端，然后 cd frontend && bun run dev 启动前端。
具体的项目架构与实现细节，可参见 AGENTS.md 文档。
This project is intended for personal study and research only. Please comply with Pixiv's Terms of Service, respect creators' copyright, and refrain from any commercial or infringing use, or from redistributing downloaded works.
Released under the MIT License.