Shaft โ€” the whole of Pixiv, in your pocket
[![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?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) **PixShaft (Shaft)** is an open-source third-party Pixiv client for Android โ€” illustrations, manga, novels, rankings, FANBOX and pixiv COMIC, all in one app. Material You, fluid, and it doesn't feel third-party at all. [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)    [Website](https://pixshaft.com)    [Sponsor on Afdian](https://afdian.com/a/pixshaft) Android 7.0+ ยท direct connection in mainland China ยท free, open source, no ads --- **English** | [็ฎ€ไฝ“ไธญๆ–‡](./README/README.zh-CN.md) | [ๆ—ฅๆœฌ่ชž](./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.
Built for browsing Pixiv โ€” illustrations, manga, novels, rankings, PixiVision, FANBOX, pixiv COMIC, trending tags, following feed, ugoira interpolation, GIF/MP4, batch download, resumable downloads, reverse image search, watch later, local library, network self-check, image mirrors, tablet two-pane, multi-account, custom accent color, dark mode, Material You
## โœจ Features ### A Pixiv client that can actually keep up From browsing and discovery to downloads and bookmarks, from FANBOX to pixiv COMIC โ€” everything you'd want to do on Pixiv, done properly.
#### ๐ŸŽฏ A feed made for you Personalised illustration, manga and novel recommendations, trending tags refreshed in real time โ€” every pull-to-refresh is a new surprise. #### ๐Ÿ† Rankings & chart hub Daily / weekly / monthly rankings with a date picker to revisit any day; the Discover tab adds bookmark charts, AI charts, charts by era, wallpaper charts, tag zones and artist charts. #### ๐Ÿ” Powerful search & filters Six sort orders, upload period, bookmark-count range, aspect ratio and resolution, a three-way AI switch โ€” and sorting by popularity **without** Pixiv Premium. #### ๐Ÿ–ผ๏ธ Reverse image search SauceNAO / TinEye / IQDB / Ascii2D, one tap to find the source. #### ๐ŸŽ FANBOX & pixiv COMIC Native FANBOX: post feed, recommended creators, full post bodies and plans โ€” no more hand-off to the browser; the pixiv COMIC home lives in the app too. One account, everything connected. #### ๐Ÿ“– Novel reader ยท local library Series, chapters, bookmarks and a progress percentage, with related illustrations mixed in automatically; point it at a folder to read local txt files, and bookmarking saves the whole novel as TXT. #### ๐Ÿ‘ฅ Fast multi-account switching Follows, DMs, bookmarks โ€” hop freely between accounts. #### โฌ‡๏ธ Batch download ยท resumable Queue a whole set at once and pick up from where a flaky network dropped it; batch-rename with naming templates, export captions alongside, or hand the jobs to aria2 on your NAS. #### ๐Ÿ™ˆ Mute settings Manage by tag and by artist separately, or mute a single work in place โ€” cards get blurred and one tap reveals them. #### ๐Ÿ”– Watch later Long-press a card to stash it. Purely local, never reported โ€” collect a batch and browse at leisure. #### ๐Ÿ“ก Network self-check ยท painless direct connection Built-in network test page: DNS, App API, web endpoints and a real image download are checked one by one, and IPv6 pollution gets called out on the spot. Slow? Switch images to pixiv.cat / pixiv.re / pixiv.nl or your own reverse proxy, or use your own App API proxy. #### โšก Instant cold start ยท local first Home recommendations, rankings and latest works open instantly from the last snapshot while the network refreshes quietly in the background; bookmarks and follows go into a persistent queue so a tap while offline is never lost.
## ๐Ÿ“ฑ Interface ### Every screen, polished Real-device captures โ€” what you see here is exactly what you get when you open the app.
Home โ€” recommendations and rankings in one screen
Home
Recommendations & rankings, one screen away
Personalised feed ยท Rankings carousel ยท One-tap bookmark		 Artwork detail โ€” high-resolution viewing
Viewer
High-res viewing, every detail
Multi-page fold ยท Download / bookmark / comment capsule ยท Load original ยท Reverse search		 Search filters
Search
Exactly what you're looking for
Six sort orders ยท Bookmark-count range ยท AI three-way ยท Safe only
Artist profile
Artist
Step into the artist's world
Advanced tag search ยท Works / bookmarks nav ยท Add to home screen		 Artist works wall
Works wall
Illustrations, manga and novels, tab by tab
Waterfall gallery ยท Bookmark from the card ยท Manga series		 Discover โ€” features, columns and chart hub
Discover
Features, columns & chart hub
Manga / novel columns ยท PixiVision ยท Trending tags ยท Chart hub
Trending tags
Trending tags
Live trends, with cover previews
Real-time tags ยท Cover preview ยท One tap in		 Download queue
Downloads
Batch download ยท queue management
Batch queue ยท Resumable ยท Caption export ยท Batch rename ยท aria2 remote		 Manga series
Manga
Serialised manga, chapter by chapter
Follow series ยท Read whole chapters ยท Batch download / bookmark
Manga reader
Manga reader
Turns like paper, immersive
Two-way paging ยท Bookmarks ยท Translate the whole series ยท Night mode		 Novel reader
Novel reader
Immersive reading
Progress percentage ยท Auto-mixed illustrations ยท Local txt library
More about each screen
- **Home** โ€” rankings preview in a horizontal strip, a personalised waterfall feed, bookmark straight from the card, long-press for the action menu. On a tablet in landscape you can turn on two-pane: list on the left, detail on the right. - **Viewer** โ€” ZoomImage engine for silky zooming, three double-tap behaviours to choose from, force-load the original at any time. Multi-page works fold into one and expand with a tap or open in the reader; download, bookmark and comments sit in a floating capsule, with reverse image search and AI upscaling on the same screen. - **Search** โ€” switch between six sort orders with one tap: popularity preview, newest, oldest, popular, popular (male), popular (female). Stack on search scope, type, upload period, bookmark-count range, aspect ratio and resolution, plus a three-way AI switch (any / hide / only) โ€” sorting by popularity needs no Pixiv Premium. - **Artist** โ€” follow artists you like and see their illustrations, manga, novels, manga series and bookmarks at a glance; the advanced tag search panel digs through all of that artist's tags, and the profile can be pinned to your home screen. - **Discover** โ€” manga and novel columns on top, then official PixiVision features, live trending tags and newest uploads; further down, bookmark charts, AI charts, charts by era, wallpaper charts, tag zones and artist charts โ€” good work always surfaces. - **Trending tags** โ€” Original, VTuber, Genshin, Wuthering Waves, Blue Archiveโ€ฆ trending tags refreshed in real time with cover previews. - **Downloads** โ€” queue a whole set, with downloading / waiting / done sections; resume from where the connection dropped, batch-rename with naming templates, export captions alongside, or send jobs straight to aria2 on your NAS. - **Manga** โ€” series shown chapter by chapter; follow the author to never miss an update. Open to read, batch download a whole set, and bookmark / un-bookmark while multi-selecting. - **Manga reader** โ€” previous / next chapter flow, paging direction, progress bar, table of contents, bookmarks and night mode; "translate the whole series" keeps running in the background after you leave the viewer. - **Novel reader** โ€” series, contents, night mode, font size / line spacing / background to taste, an always-on progress percentage at the bottom, and related illustrations mixed in automatically. Pick a folder to read local txt; bookmarking saves the whole TXT.
## ๐Ÿค– AI ### AI on board, one level up Generative AI in your pocket โ€” sharper images, manga you can read, characters cut out in a tap, smoother ugoira.
#### ๐Ÿ” Super-resolution upscaling AI super-resolution enlarges low-res illustrations 2โ€“4ร—, rebuilding hair strands and line detail so thumbnails and old images come back in HD. - 2ร— / 4ร— smart upscaling - Line-art sharpening ยท denoise - On-device inference ยท nothing uploaded #### โœ‚๏ธ Smart cut-out Separate character from background in one tap, with edges clean down to single hairs, and export a transparent PNG โ€” avatars, stickers and fan-art material ready to go. - Hair-level edges - Transparent PNG export - Batch processing #### ๐Ÿ’ฌ Manga translation (OCR + MT) Detects speech bubbles automatically, translates in place and re-typesets; "translate the whole series" finishes multiple pages in one go and keeps running after you leave the viewer. Besides the built-in engine you can plug in your own OpenAI-compatible endpoint. - Automatic bubble detection - Translate whole series ยท runs in background - Custom AI endpoint ยท streaming #### ๐ŸŽž๏ธ Ugoira frame interpolation (RIFE) RIFE interpolation adaptively brings ugoira up to 2ร— / 4ร—, close to the 50 fps ceiling; playback uses a frame-sequence player so motion no longer depends on the device. - Adaptive 2ร— / 4ร— - Save as H.264 MP4 - A fraction of the size of a GIF
AI features keep evolving โ€” more coming. ## ๐Ÿ› ๏ธ Under the hood
Tech stack โ€” Kotlin, Material Design 3, MVVM, Retrofit 2, Room, Glide, in-house Feeds framework, witstudio, actionqueue, Cronet, Activity Embedding, Target SDK 36
A modern Android stack, Kotlin-first, with a clear architecture and an eye on performance and battery. See the module docs for the in-house pieces: [feeds](./docs/feeds-module.md) ยท [actionqueue](./docs/action-queue.md) ยท [direct connect](./docs/direct-connect.md) ยท [image host](./docs/image-host.md). ### Building from source ```bash git clone https://github.com/CeuiLiSA/Pixiv-Shaft.git cd Pixiv-Shaft ./gradlew assembleDebug # debug APK ./gradlew assembleRelease # release APK (needs a signing config) ``` **Requirements:** JDK 17+, Android SDK 36 ยท Min SDK 24 (Android 7.0), Target SDK 36 (Android 16) ## ๐Ÿ’Ž Plans Shaft itself is free, open source and ad-free forever, with every feature unlocked โ€” including AI upscaling, cut-out, manga translation and ugoira interpolation. The one thing with a quota is **"sort any keyword by popularity"**, because it uses shared search resources. Subscribing only multiplies that quota; it never unlocks exclusive features. | | Free | Pro | Max | |---|---|---|---| | Popularity-sort quota | 1ร— | 5ร— | 20ร— | | All illustration / manga / novel / ranking features | โœ… | โœ… | โœ… | | AI upscaling, cut-out, translation, interpolation | โœ… | โœ… | โœ… | | Sort any keyword by popularity | basic quota, then falls back to popularity preview | โœ… | โœ… | | Auto-renew | โ€” | no, falls back to Free on expiry | no, falls back to Free on expiry | Already a pixiv Premium member? Popularity sort goes straight through the official API โ€” unlimited, no subscription needed. The in-app **Usage** page shows remaining quota and lets you order directly; orders placed on Afdian can be claimed with "Restore purchase". Prices and details: [pixshaft.com](https://pixshaft.com/#pricing) ยท [afdian.com/a/pixshaft](https://afdian.com/a/pixshaft). ## โ“ FAQ
Are PixShaft and Shaft the same app?
Yes. PixShaft is the public name on Google Play and at pixshaft.com; the project codename is Shaft (repository Pixiv-Shaft). Same open-source code, same team โ€” look for pixshaft.com.
Is PixShaft an official app?
No. PixShaft (Shaft) is an unofficial third-party Pixiv client, open-sourced for learning and communication only. All illustrations, manga and novels are copyrighted by their creators or Pixiv.
Do I have to pay, or have Premium?
The app is completely free, open source and ad-free, with nothing locked โ€” including AI upscaling, cut-out, manga translation and ugoira interpolation. The only quota is on "sort any keyword by popularity" (it uses shared search resources): free users get a base quota and fall back to popularity preview when it runs out, or you can turn off default popularity sorting in Settings and keep the quota for when you need it. For more quota, subscribe to Pro (5ร—) or Max (20ร—); pixiv Premium members go straight through the official API with no limit and no subscription.
Does direct connection work in mainland China?
Yes. Shaft ships with a direct-connection scheme, so mainland users can browse without an extra proxy. If it won't connect, open the built-in network test page โ€” DNS, App API, web endpoints and a real image download are checked one by one and IPv6 pollution is called out; slow images can be switched to pixiv.cat / pixiv.re / pixiv.nl or your own reverse proxy, and you can also fill in your own App API proxy.
If a download breaks halfway, is it wasted?
No. Downloads are resumable โ€” retries and cold starts continue from the last progress. There's also batch rename, naming-template organisation, automatic caption export, "low-key download" (downloaded images don't crowd the front of your gallery or WeChat / QQ pickers), and remote download to aria2 on your NAS.
Tablet support?
Yes. In landscape you can enable two-pane mode: the feed in the left third, the artwork detail in the right two-thirds โ€” tap and it opens on the right, no backing out. It's a switch; turn it off any time.
Which Android versions?
Android 7.0 and up (Min SDK 24), targeting Android 16 (Target SDK 36).
Where do I download it?
Install from Google Play, or grab the latest APK from GitHub Releases. It's fully open source โ€” build it yourself if you like.
More in the [FAQ](./FAQ.md) ยท [install FAQ](./FAQ-install.md) ยท [download path & filename guide](./DOWNLOAD.md). ## ๐Ÿค Contributing Contributions are welcome! Feel free to open issues or submit pull requests. For V3 UI work, start with the [V3 design philosophy](docs/v3-design-philosophy.md), [component gallery](mockup/v3-design-system/index.html), and [page starter](mockup/v3-design-system/starter.html). ### ๐Ÿ† 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://star-history.dera.page/svg?repos=CeuiLiSA/Pixiv-Shaft&type=Date)](https://star-history.dera.page/#CeuiLiSA/Pixiv-Shaft&type=Date) ## ๐Ÿ’— Support the Project Shaft is free and open-source, built and maintained in spare time. If it has been useful to you, you can support continued development on **Afdian (็ˆฑๅ‘็”ต)**:
### ๐Ÿ’— [afdian.com/a/pixshaft](https://afdian.com/a/pixshaft) [Support Shaft on Afdian](https://afdian.com/a/pixshaft)
Sponsorship is entirely optional โ€” every feature of Shaft is, and will stay, free for everyone. Starring the repo, reporting bugs, and sending pull requests help just as much. ## ๐Ÿ“„ License Pixiv-Shaft is licensed under the [GNU General Public License, version 2](./LICENSE). The Telegram Android `SpoilerEffect2` renderer and shaders are derived from the official Telegram Android source; see [third-party notices](./THIRD_PARTY_NOTICES.md). ---
Start browsing Pixiv now โ€” Google Play or GitHub Releases

**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)   [![Sponsor on Afdian](https://img.shields.io/badge/-Sponsor%20on%20็ˆฑๅ‘็”ต-946ce6?style=for-the-badge)](https://afdian.com/a/pixshaft) The README assets (hero, chips, framed screenshots) are generated by scripts/build_readme_assets.py from the real-device screenshots in snap/pixshaft/screens. Made with love for the Pixiv community