An open API service indexing awesome lists of open source software.

https://github.com/ceuilisa/pixiv-shaft

Pixiv第三方Android客户端
https://github.com/ceuilisa/pixiv-shaft

android-app google-play material-ui pixiv

Last synced: about 1 month ago
JSON representation

Pixiv第三方Android客户端

Awesome Lists containing this project

README

          

# Shaft

### A Modern Third-Party Pixiv Client for Android

[![GitHub Stars](https://img.shields.io/github/stars/CeuiLiSA/Pixiv-Shaft?style=for-the-badge&logo=github&color=f5c842)](https://github.com/CeuiLiSA/Pixiv-Shaft/stargazers)
[![GitHub Forks](https://img.shields.io/github/forks/CeuiLiSA/Pixiv-Shaft?style=for-the-badge&logo=github&color=8ac6d1)](https://github.com/CeuiLiSA/Pixiv-Shaft/network/members)
[![GitHub Release](https://img.shields.io/github/v/release/CeuiLiSA/Pixiv-Shaft?style=for-the-badge&logo=android&color=3ddc84)](https://github.com/CeuiLiSA/Pixiv-Shaft/releases/latest)
[![License](https://img.shields.io/github/license/CeuiLiSA/Pixiv-Shaft?style=for-the-badge&color=blue)](./LICENSE)

[![Build Status](https://img.shields.io/github/actions/workflow/status/CeuiLiSA/Pixiv-Shaft/gradle.yml?branch=master&style=flat-square&label=build)](https://github.com/CeuiLiSA/Pixiv-Shaft/actions)
[![Issues](https://img.shields.io/github/issues/CeuiLiSA/Pixiv-Shaft?style=flat-square&color=brightgreen)](https://github.com/CeuiLiSA/Pixiv-Shaft/issues)
[![Issues Closed](https://img.shields.io/github/issues-closed/CeuiLiSA/Pixiv-Shaft?style=flat-square&color=9466ff)](https://github.com/CeuiLiSA/Pixiv-Shaft/issues?q=is%3Aissue+is%3Aclosed)
[![Last Commit](https://img.shields.io/github/last-commit/CeuiLiSA/Pixiv-Shaft?style=flat-square)](https://github.com/CeuiLiSA/Pixiv-Shaft/commits)
[![Code Size](https://img.shields.io/github/languages/code-size/CeuiLiSA/Pixiv-Shaft?style=flat-square)](https://github.com/CeuiLiSA/Pixiv-Shaft)
[![Top Language](https://img.shields.io/github/languages/top/CeuiLiSA/Pixiv-Shaft?style=flat-square&color=7f52ff)](https://github.com/CeuiLiSA/Pixiv-Shaft)
[![Contributors](https://img.shields.io/github/contributors/CeuiLiSA/Pixiv-Shaft?style=flat-square&color=orange)](https://github.com/CeuiLiSA/Pixiv-Shaft/graphs/contributors)
[![Downloads](https://img.shields.io/github/downloads/CeuiLiSA/Pixiv-Shaft/total?style=flat-square&color=e74c3c)](https://github.com/CeuiLiSA/Pixiv-Shaft/releases)

**Shaft** is a beautifully crafted, open-source Pixiv client that brings the full Pixiv experience to Android — illustrations, manga, novels, rankings, and more — with a clean Material Design interface and smooth animations.

[Get it on Google Play](https://play.google.com/store/apps/details?id=ceui.pixiv.pshaft)
  
[GitHub Releases](https://github.com/CeuiLiSA/Pixiv-Shaft/releases/latest)

---

[English](#features) | [日本語](./README/README.ja.md)

> [!NOTE]
> This is an unofficial third-party client for [Pixiv](https://www.pixiv.net). All illustrations, manga, and novel works are copyrighted by their respective creators or Pixiv. This project is open-source for learning and communication purposes only.

## Screenshots


Home & Recommendations
Discover
Search







User Profile
Navigation Drawer
Browsing History





## Features

### Browsing & Discovery
- Personalized illustration, manga & novel recommendations
- Trending tags with real-time updates
- Daily / Weekly / Monthly rankings with date picker
- PixiVision curated articles & special features
- Related works exploration
- Illustration & novel series support

### Search & Filter
- Search illustrations, manga, novels, and users
- Sort by popularity / hotness (no premium required!)
- Filter by bookmark count threshold
- Advanced search filters

### Social & Interaction
- View, post, and reply to comments
- Follow users, view followers & following
- Multi-account support with quick switching
- User profile with full works gallery
- Mute / block users and tags
- Spam comment filtering

### Downloads & History
- Batch download with queue management
- Export download links
- Local browsing & download history
- Customizable file naming schemes

### Content Support
- GIF playback & save
- Full novel reader with series & chapters
- Novel bookmarks
- R18 content (requires Pixiv account setting)
- Reverse image search (SauceNAO / TinEye / IQDB / Ascii2D)

### Experience
- Material Design with smooth animations
- Dark mode
- Multi-language support
- Direct connection for mainland China users
- Lightweight & battery-friendly

## Tech Stack

```
Language Kotlin + Java · Target SDK 36 (Android 15) · Min SDK 23 (Android 6.0)
Architecture MVVM · Repository Pattern · Navigation Component · ViewBinding
Networking Retrofit 2 · OkHttp · RxJava 2/3 · RxHttp · Custom DNS & SSL
Storage Room · MMKV (Tencent)
UI Material Design 3 · Glide · Lottie · SmartRefreshLayout · ZoomImage
Build Gradle 8.7 · KAPT · Custom Annotation Processor · ProGuard
Analytics Firebase Analytics · Firebase Crashlytics
```

## Building from Source

```bash
# Clone the repository
git clone https://github.com/CeuiLiSA/Pixiv-Shaft.git
cd Pixiv-Shaft

# Build debug APK
./gradlew assembleDebug

# Or build release APK (requires signing config)
./gradlew assembleRelease
```

**Requirements:** JDK 17+, Android SDK 36

## Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

### 🏆 Top Contributors


CeuiLiSA
🥇 CeuiLiSA

521 commits
+143,913 / −85,914
sunbeams001
🥈 sunbeams001

504 commits
+21,001 / −9,963
SoxiaLiSA
🥉 SoxiaLiSA

332 commits
+52,639 / −15,211
4ragaki
4ragaki

41 commits
+1,231 / −201
duzhaokun123
duzhaokun123

37 commits
+1,174 / −717


0-a-e
0-a-e

19 commits
+907 / −839
Lostin-Tianyi
Lostin-Tianyi

17 commits
+1,080 / −149
SodaWithoutSparkles
SodaWithoutSparkles

16 commits
+351 / −273
LoxiaLiSA
LoxiaLiSA

14 commits
+50,536 / −15,637
yxsra
yxsra

11 commits
+182 / −53

Commits from the GitHub contributors API; lines added / removed from git log --numstat. Snapshot taken 2026-04-21 — see the [live list](https://github.com/CeuiLiSA/Pixiv-Shaft/graphs/contributors).

### All contributors


Contributors


[![Star History Chart](https://api.star-history.com/svg?repos=CeuiLiSA/Pixiv-Shaft&type=Date)](https://star-history.com/#CeuiLiSA/Pixiv-Shaft&Date)

## FAQ

Check out the [FAQ](./FAQ.md) for common questions and troubleshooting.

For customizing where files go and how they're named, see the
[Download path & filename guide](./DOWNLOAD.md).

## License

```
MIT License

Copyright (c) 2021 CeuiLiSA

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

---

**If you find Shaft useful, consider giving it a star!**

[![Star this repo](https://img.shields.io/badge/-Star%20this%20repo-f5c842?style=for-the-badge&logo=github&logoColor=black)](https://github.com/CeuiLiSA/Pixiv-Shaft)

Made with love for the Pixiv community