# PixivFE
A privacy-respecting alternative front-end for Pixiv that doesn't suck.

[](https://goreportcard.com/report/codeberg.org/vnpower/pixivfe)
Questions? Feedback? You can [PM me](https://matrix.to/#/@vnpower:eientei.org) on Matrix! You can also see the [Known quirks](https://pixivfe.pages.dev/known-quirks/) page to check if your issue has a known solution.
You can keep track of this project's development using the [roadmap](doc/dev/general.md).
## Features
- Lightweight - both the interface and the code
- Privacy-first - the server will do the work for you
- No bloat - we only serve HTML, CSS and minimal JS code
- Open source - you can trust me!
## Development
Prerequisites:
- [Go](https://go.dev/doc/install) (to build PixivFE from source)
- [Sass](https://github.com/sass/dart-sass/) (will be run by PixivFE in development mode)
To install Dart Sass, you can choose any of the following methods.
- use system package manager (usually called `dart-sass`)
- download executable from [the official release page](https://github.com/sass/dart-sass/releases)
- `pnpm i -g sass`
Then, run the project:
```bash
# Clone the PixivFE repository
git clone https://codeberg.org/VnPower/PixivFE.git && cd PixivFE
# Run in PixivFE in development mode (styles and templates reload automatically)
PIXIVFE_DEV=1 go run .
```
## Hosting PixivFE
You can use PixivFE for personal use! Assuming that you use an operating system that can run POSIX shell scripts, install `go`, clone this repository, modify the `run.sh` file, and profit!
I recommend self-hosting your own instance for personal use, instead of relying entirely on official instances.
To deploy PixivFE using Docker or the compiled binary, see [Hosting PixivFE](https://pixivfe.pages.dev/hosting-pixivfe/).
### Public Instances
| Name | URL | Country | Cloudflare? | Observatory Grade | Status |
|-------------------|-------------------------------------------------|---------|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| exozyme (Official)| [https://pixivfe.exozy.me](https://pixivfe.exozy.me) | US | No | [](https://observatory.mozilla.org/analyze/pixivfe.exozy.me) |  |
| dragoongoose | [https://pixivfe.drgns.space](https://pixivfe.drgns.space) | US | No | [](https://observatory.mozilla.org/analyze/pixivfe.drgns.space) |  |
| ducks.party | [https://pixivfe.ducks.party](https://pixivfe.ducks.party) | NL | No | [](https://observatory.mozilla.org/analyze/pixivfe.ducks.party) |  |
| perennialte.ch | [https://pixiv.perennialte.ch](https://pixiv.perennialte.ch) | AU | No | [](https://observatory.mozilla.org/analyze/pixiv.perennialte.ch) | |
| darkness.services | [https://pixivfe.darkness.services](https://pixivfe.darkness.services) | US | Yes | [](https://observatory.mozilla.org/analyze/pixivfe.darkness.services) |  |
| thebunny.zone | [https://pixivfe.thebunny.zone](https://pixivfe.thebunny.zone) | HR | No | [](https://observatory.mozilla.org/analyze/pixivfe.thebunny.zone) |  |
| thebunny.zone (🧅)| [http://pixivfe.bunny5exbgbp4sqe2h2rfq2brgrx3dhohdweonepzwfgumfyygb35wyd.onion](http://pixivfe.bunny5exbgbp4sqe2h2rfq2brgrx3dhohdweonepzwfgumfyygb35wyd.onion/) | HR | No | [](https://observatory.mozilla.org/analyze/pixivfe.thebunny.zone) |  |
If you are hosting your own instance, you can create a pull request to add it here!
For more information on instance uptime, see the [PixivFE instance status page](https://stats.uptimerobot.com/FbEGewWlbX).
This information is duplicated at https://pixivfe.pages.dev/public-instances/.
## Hosting Image Proxy Server
PixivFE can work with or without an external image proxy server. Here is the [list of public image proxies](https://pixivfe.pages.dev/public-image-proxies/).
See [hosting a Pixiv image proxy](https://pixivfe.pages.dev/hosting-image-proxy-server/) if you want to host one yourself.
### Public Instances
[See the current list of image proxy servers](./docs/image-proxies.yml)