# ultranity/pix-ezviewer architecture

> Architecture diagram of the GitHub repository ultranity/pix-ezviewer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ultranity/pix-ezviewer
- Repository: https://github.com/ultranity/pix-ezviewer

## Overview

PixEz is a third-party Pixiv Android client. The typical user journey is to browse or search for illustrations, users, or novels, open content, and optionally bookmark, comment, or download it. The app also supports account management, filtering, history, image-file management, and customized themes. Its runtime includes API and network-transport layers, local data, and download services. The tree and README establish these product areas; several feature-to-implementation links below are dashed because their callers were not sampled.

Main entry points: [`app/src/main/java/com/perol/asdpl/pixivez/core`](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/core) (Illustration browsing), [`app/src/main/java/com/perol/asdpl/pixivez/ui`](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui) (App navigation), [`app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt`](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt) (App configuration), [`app/src/main/java/com/perol/asdpl/pixivez/data/RetrofitRepository.kt`](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/RetrofitRepository.kt) (API repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Browse and read"]
  node_navigation["App navigation"]
  node_image_browse["Illustration browsing"]
  node_picture["Picture details<br/>[PictureActivity.kt]"]
  node_search["Search routing<br/>[SearchRouter.kt]"]
  node_novel["Novel reading"]
  node_spotlight["Pixiv features"]
  node_recycler["List adapters"]
  node_item_animation["Item animation<br/>[ItemAnimator.kt]"]
end

subgraph group_account["Accounts and preferences"]
  node_accounts["Account management"]
  node_settings["Themes and filters"]
  node_history["History records"]
  node_app_state["App configuration<br/>[PxEZApp.kt]"]
end

subgraph group_data["Data and API"]
  node_api["Pixiv API<br/>[PixivApiService.kt]"]
  node_api_repository["API repository"]
  node_models["Content models<br/>[Illust.kt]"]
  node_database[("Local database<br/>[AppDatabase.kt]")]
end

subgraph group_network["Network transport"]
  node_network_factory["Service factory<br/>[ServiceFactory.kt]"]
  node_direct_transport["Direct connection"]
end

subgraph group_operations["Downloads and files"]
  node_download_manager["Download manager"]
  node_download_tasks["Download tasks<br/>[Works.kt]"]
  node_image_manager["Local image manager"]
  node_file_tools["File utilities<br/>[FileUtil.kt]"]
  node_saucenao["Image search service<br/>[SaucenaoService.kt]"]
end

node_user(("Pixiv user"))
node_app["Android app"]

node_user -->|"uses"| node_app
node_app -.->|"presents"| node_navigation
node_navigation -->|"opens"| node_image_browse
node_image_browse -.->|"renders with"| node_recycler
node_image_browse -.->|"opens details"| node_picture
node_search -->|"routes novel search"| node_novel
node_search -.->|"routes illustration search"| node_image_browse
node_navigation -->|"opens"| node_accounts
node_navigation -->|"opens"| node_settings
node_app -->|"initializes"| node_app_state
node_image_browse -.->|"requests content"| node_api_repository
node_api_repository -.->|"calls"| node_api
node_api -->|"returns models"| node_models
node_api_repository -.->|"configures client"| node_network_factory
node_network_factory -.->|"configures transport"| node_direct_transport
node_app_state -->|"loads user data"| node_database
node_settings -.->|"stores filters"| node_database
node_history -.->|"reads records"| node_database
node_download_manager -->|"manages tasks"| node_download_tasks
node_download_manager -->|"reads settings"| node_app_state
node_app_state -->|"records downloaded files"| node_file_tools
node_image_manager -->|"lists files"| node_file_tools
node_image_manager -->|"opens selected images"| node_picture
node_user -.->|"views features"| node_spotlight
node_picture -.->|"searches similar images"| node_saucenao
node_recycler -->|"supports animations"| node_item_animation

click node_navigation "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui"
click node_image_browse "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/core"
click node_picture "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/pic/PictureActivity.kt"
click node_search "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/search/SearchRouter.kt"
click node_novel "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/novel"
click node_spotlight "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/home/pixivision"
click node_recycler "https://github.com/ultranity/pix-ezviewer/blob/master/BRVAH/src/main/java/com/chad/brvah/BaseQuickAdapter.kt"
click node_item_animation "https://github.com/ultranity/pix-ezviewer/blob/master/BRVAH/src/main/java/com/chad/brvah/animation/ItemAnimator.kt"
click node_accounts "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/account"
click node_settings "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/settings"
click node_history "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/settings/HistoryViewModel.kt"
click node_app_state "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt"
click node_api "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/PixivApiService.kt"
click node_api_repository "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/RetrofitRepository.kt"
click node_models "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/model/Illust.kt"
click node_database "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/AppDatabase.kt"
click node_network_factory "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/networks/ServiceFactory.kt"
click node_direct_transport "https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/networks"
click node_download_manager "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/manager/DownloadManagerActivity.kt"
click node_download_tasks "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/Works.kt"
click node_image_manager "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/manager/ImgManagerActivity.kt"
click node_file_tools "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/objects/FileUtil.kt"
click node_saucenao "https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/SaucenaoService.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_navigation,node_image_browse,node_picture,node_search,node_novel,node_spotlight,node_recycler,node_item_animation,node_user toneBlue
class node_accounts,node_settings,node_history,node_app_state toneAmber
class node_api,node_api_repository,node_models,node_database toneMint
class node_network_factory,node_direct_transport toneRose
class node_download_manager,node_download_tasks,node_image_manager,node_file_tools,node_saucenao,node_app toneIndigo
```

## Components

### Browse and read

- [App navigation](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui): `app/src/main/java/com/perol/asdpl/pixivez/ui`
- [Illustration browsing](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/core): `app/src/main/java/com/perol/asdpl/pixivez/core`
- [Picture details](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/pic/PictureActivity.kt): `app/src/main/java/com/perol/asdpl/pixivez/ui/pic/PictureActivity.kt`
- [Search routing](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/search/SearchRouter.kt): `app/src/main/java/com/perol/asdpl/pixivez/ui/search/SearchRouter.kt`
- [Novel reading](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/novel): `app/src/main/java/com/perol/asdpl/pixivez/ui/novel`
- [Pixiv features](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/home/pixivision): `app/src/main/java/com/perol/asdpl/pixivez/ui/home/pixivision`
- [List adapters](https://github.com/ultranity/pix-ezviewer/blob/master/BRVAH/src/main/java/com/chad/brvah/BaseQuickAdapter.kt): `BRVAH/src/main/java/com/chad/brvah/BaseQuickAdapter.kt`
- [Item animation](https://github.com/ultranity/pix-ezviewer/blob/master/BRVAH/src/main/java/com/chad/brvah/animation/ItemAnimator.kt): `BRVAH/src/main/java/com/chad/brvah/animation/ItemAnimator.kt`

### Accounts and preferences

- [Account management](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/account): `app/src/main/java/com/perol/asdpl/pixivez/ui/account`
- [Themes and filters](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/ui/settings): `app/src/main/java/com/perol/asdpl/pixivez/ui/settings`
- [History records](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/settings/HistoryViewModel.kt): `app/src/main/java/com/perol/asdpl/pixivez/ui/settings/HistoryViewModel.kt`
- [App configuration](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt): `app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt`

### Data and API

- [Pixiv API](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/PixivApiService.kt): `app/src/main/java/com/perol/asdpl/pixivez/services/PixivApiService.kt`
- [API repository](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/RetrofitRepository.kt): `app/src/main/java/com/perol/asdpl/pixivez/data/RetrofitRepository.kt`
- [Content models](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/model/Illust.kt): `app/src/main/java/com/perol/asdpl/pixivez/data/model/Illust.kt`
- [Local database](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/data/AppDatabase.kt): `app/src/main/java/com/perol/asdpl/pixivez/data/AppDatabase.kt`

### Network transport

- [Service factory](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/networks/ServiceFactory.kt): `app/src/main/java/com/perol/asdpl/pixivez/networks/ServiceFactory.kt`
- [Direct connection](https://github.com/ultranity/pix-ezviewer/tree/master/app/src/main/java/com/perol/asdpl/pixivez/networks): `app/src/main/java/com/perol/asdpl/pixivez/networks`

### Downloads and files

- [Download manager](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/manager/DownloadManagerActivity.kt): `app/src/main/java/com/perol/asdpl/pixivez/ui/manager/DownloadManagerActivity.kt`
- [Download tasks](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/Works.kt): `app/src/main/java/com/perol/asdpl/pixivez/services/Works.kt`
- [Local image manager](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/ui/manager/ImgManagerActivity.kt): `app/src/main/java/com/perol/asdpl/pixivez/ui/manager/ImgManagerActivity.kt`
- [File utilities](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/objects/FileUtil.kt): `app/src/main/java/com/perol/asdpl/pixivez/objects/FileUtil.kt`
- [Image search service](https://github.com/ultranity/pix-ezviewer/blob/master/app/src/main/java/com/perol/asdpl/pixivez/services/SaucenaoService.kt): `app/src/main/java/com/perol/asdpl/pixivez/services/SaucenaoService.kt`

### Other components

- **Pixiv user**
- **Android app**

## Connections

- Pixiv user → Android app: uses (evidence: `README.md`)
- Android app → App navigation: presents
- App navigation → Illustration browsing: opens (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/FragmentActivity.kt`)
- Illustration browsing → List adapters: renders with
- Illustration browsing → Picture details: opens details
- Search routing → Novel reading: routes novel search (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/search/SearchRouter.kt`)
- Search routing → Illustration browsing: routes illustration search
- App navigation → Account management: opens (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/FragmentActivity.kt`)
- App navigation → Themes and filters: opens (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/FragmentActivity.kt`)
- Android app → App configuration: initializes (evidence: `app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt`)
- Illustration browsing → API repository: requests content
- API repository → Pixiv API: calls
- Pixiv API → Content models: returns models (evidence: `app/src/main/java/com/perol/asdpl/pixivez/services/PixivApiService.kt`)
- API repository → Service factory: configures client
- Service factory → Direct connection: configures transport
- App configuration → Local database: loads user data (evidence: `app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt`)
- Themes and filters → Local database: stores filters
- History records → Local database: reads records
- Download manager → Download tasks: manages tasks (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/manager/DownloadManagerActivity.kt`)
- Download manager → App configuration: reads settings (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/manager/DownloadManagerActivity.kt`)
- App configuration → File utilities: records downloaded files (evidence: `app/src/main/java/com/perol/asdpl/pixivez/services/PxEZApp.kt`)
- Local image manager → File utilities: lists files (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/manager/ImgManagerActivity.kt`)
- Local image manager → Picture details: opens selected images (evidence: `app/src/main/java/com/perol/asdpl/pixivez/ui/manager/ImgManagerActivity.kt`)
- Pixiv user → Pixiv features: views features
- Picture details → Image search service: searches similar images
- List adapters → Item animation: supports animations (evidence: `BRVAH/src/main/java/com/chad/brvah/BaseQuickAdapter.kt`)
