Pixeval

Powerful, fast and beautiful Pixiv third-party desktop program based on .NET 8 and WinUI 3

🌏: 简体中文, English, Русский, Français

---

The Pixeval that based on WinUI 3 is now WIP, the older version, which is the WPF version has been deprecated and expecting no more supports from developers.

The WinUI 3 codebase for Pixeval supports only Windows 10 (2004, Build Number 19041) and higher. You can check this at Settings | System | About | Windows specifications

For more information, see main page

The WinUI 3 version provides a better user interface, a more structural codebase and a modern development experience compared to the WPF version. You can download and compile it yourself if you want to take a glance at the new version, follow the following steps to compile and run:

Prerequisites

1. Install Visual Studio 2022 (Roslyn 4.x requires VS17.x, i.e. VS2022)
2. In Tools - Get Tools and Features, under Workloads, select .NET Desktop Development (In the Installation Details pane of the installation dialog, select the Windows App SDK C# Template at the bottom of the list, but it is not required.) You can refer to Install Tools for Windows App SDK
3. Select .NET 8 in Tools - Get Tools and Features - Individual components, or download the latest version of the .NET 8 SDK outside of VS, but this is not recommended
4. Search for plugin Single-project MSIX Packaging Tools for VS 2022 and install

Development

1. Clone the project
2. If Pixeval is not a startup project, set it as a startup project
3. Build and run

• If that fails, you can try rebuilding the solution or restarting Visual Studio 2022

If you want to take part into the development, there are some extra requirements

1. The basic knowledge about Windows XAML Framework, for more information, see XAML Overview
2. A comprehensive understanding of C# and .NET development
3. Read the source code without documentation

Project Structure

1. The Pixeval project contains the most relevant codes and the packaging files.
2. The Pixeval.Controls project contains includes a number of less coupled controls
3. The Pixeval.CoreApi project contains the API endpoints that are required by the project.
4. The Pixeval.SourceGen project contains code generators about settings.
5. The Pixeval.Utilities project contains the codes for universal util functions.

The Guidelines for Version Control

This project follows a simple yet reasonable branching model: When you are willing to contribute your code, please create a new branch based on main and proceed with it. The new branch MUST follows {user}/{qualifier}/{desc}, where the {user} is your GitHub user name.

Code content	qualifier	desc
Bug fixes	fix	A brief description of the vulnerability
New features	feature	A brief description of the new feature
Refactoring or code quality	refactor	A brief description of the refactoring section

If your contribution contains more than one kind specified above, choose the rule that is most relevant to your contribution, and specify others in the commit message.

After your development, Please create a Pull Request and request to merge your branch into main

In case that you are having problems... (Ordered by recommend priority)

1. Open an issue at github
2. Send an email to decem0730@hotmail.com
3. Join the QQ group 815791942 and ask developers face-to-face

Acknowledgements (In no particular order)

Made with contrib.rocks.

Support me

If this project meets your requirements perfectly, welcome the buy me a coffee at afdian. It's my pleasure to having your rewards. Thanks!

JetBrains Open Source License

The Jetbrains™ ReSharper is heavily used during the development of this project. Thank JetBrains s.r.o for providing the JetBrains Open Source License, If you are one of the passionate developers who often put JetBrains products into use, you can try to apply the JetBrains Open Source License from the official channel to help you and your developer teammates to significantly improve the productivities