Pixiv-Shaft

[GitHub Stars] [GitHub Forks] [GitHub Release] [License]

[Build Status] [Issues] [Issues Closed] [Last Commit] [Code Size] [Top Language] [Contributors] [Downloads]

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 — 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

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

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

Commits from the GitHub contributors API; lines added / removed from git log --numstat. Snapshot taken 2026-04-21 — see the live list.

All contributors

[Star History Chart]

💗 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.

---

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

[Star this repo]   [Sponsor on Afdian]

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