CeuiLiSA/Pixiv-Shaft

Pixiv第三方Android客户端

7,809

stars

3,123

commits

Kotlin

primary language

Sep 9, 2026

updated

android-app

google-play

material-ui

pixiv

Browse cluster: Android proxy and VPN clients →

README

Shaft — the whole of Pixiv, in your pocket

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.

_{Android 7.0+ · direct connection in mainland China · free, open source, no ads}

English | 简体中文 | 日本語

[!NOTE] This is an unofficial third-party client for Pixiv. 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.

✨ 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 & rankings, one screen away} _{Personalised feed · Rankings carousel · One-tap bookmark}	Viewer _{High-res viewing, every detail} _{Multi-page fold · Download / bookmark / comment capsule · Load original · Reverse search}	Search _{Exactly what you're looking for} _{Six sort orders · Bookmark-count range · AI three-way · Safe only}
Artist _{Step into the artist's world} _{Advanced tag search · Works / bookmarks nav · Add to home screen}	Works wall _{Illustrations, manga and novels, tab by tab} _{Waterfall gallery · Bookmark from the card · Manga series}	Discover _{Features, columns & chart hub} _{Manga / novel columns · PixiVision · Trending tags · Chart hub}
Trending tags _{Live trends, with cover previews} _{Real-time tags · Cover preview · One tap in}	Downloads _{Batch download · queue management} _{Batch queue · Resumable · Caption export · Batch rename · aria2 remote}	Manga _{Serialised manga, chapter by chapter} _{Follow series · Read whole chapters · Batch download / bookmark}
Manga reader _{Turns like paper, immersive} _{Two-way paging · Bookmarks · Translate the whole series · Night mode}	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 · actionqueue · direct connect · image host.

Building from source

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 · 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 · install FAQ · download path & filename guide.

🤝 Contributing

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

For V3 UI work, start with the V3 design philosophy, component gallery, and page starter.

🏆 Top Contributors

_{🥇 CeuiLiSA} _{521 commits} _{+143,913 / −85,914}	_{🥈 sunbeams001} _{504 commits} _{+21,001 / −9,963}	_{🥉 SoxiaLiSA} _{332 commits} _{+52,639 / −15,211}	_4ragaki _{41 commits} _{+1,231 / −201}	_duzhaokun123 _{37 commits} _{+1,174 / −717}
_0-a-e _{19 commits} _{+907 / −839}	_{Lostin-Tianyi} _{17 commits} _{+1,080 / −149}	_{SodaWithoutSparkles} _{16 commits} _{+351 / −273}	_LoxiaLiSA _{14 commits} _{+50,536 / −15,637}	_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.}

All contributors

💗 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

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.

The Telegram Android SpoilerEffect2 renderer and shaders are derived from the official Telegram Android source; see third-party notices.

Start browsing Pixiv now — Google Play or GitHub Releases

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

_{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

Contributors

1,771 commits

521 commits

504 commits

113 commits

Similar repos

EhViewer-NekoInverter/EhViewer

🥥 A fork of EhViewer, feature requests are not accepted. Forked from…

3,653

CeuiLiSA/Pixiv-Shaft

README