# WinPaletter

# ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/GithubBannerIntro.jpg?raw=true)

![Github All Releases](https://img.shields.io/github/downloads/Abdelrhman-AK/WinPaletter/total?style=for-the-badge&color=0078D4) ![GitHub Release](https://img.shields.io/github/v/release/Abdelrhman-AK/WinPaletter?color=05227A&style=for-the-badge) [![GitHub stars](https://img.shields.io/github/stars/Abdelrhman-AK/WinPaletter?style=for-the-badge&color=F4870A&labelColor=F4870A&logo=github&logoColor=white)](https://github.com/Abdelrhman-AK/WinPaletter/stargazers) [![GitHub issues](https://img.shields.io/github/issues/Abdelrhman-AK/WinPaletter?color=FF0000&style=for-the-badge)](https://github.com/Abdelrhman-AK/WinPaletter/issues) [![GitHub forks](https://img.shields.io/github/forks/Abdelrhman-AK/WinPaletter?color=00AF00&style=for-the-badge)](https://github.com/Abdelrhman-AK/WinPaletter/network) [![License: MIT AND CPOL](https://img.shields.io/badge/License-MIT%20AND%20CPOL-FF0C4F?style=for-the-badge)](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/License.md)

> [!WARNING]
> ### **Do not use unofficial builds.** Some "cracked" versions appear on GitHub. WinPaletter is completely **free** and does **not require a paid license**. With GitHub integration for uploading and managing themes directly in the app, always use the **official build** for your safety.

## WinPaletter is back! Project Scope:

This return release concentrates on **cleaning up legacy issues** and providing a better-honed experience.
While significant new features are not anticipated, the goal is to place the project in a stable, workable condition.

> [!IMPORTANT]
> Development during this comeback phase will be limited. The developer will be available only one or two days per week (or every two weeks), and not for the full day. As a result, progress will be slower compared to the more active development period prior to archiving.

---

#### WinPaletter is a portable tool designed to elevate your Windows desktop experience. Whether you're a designer, developer, or someone who loves personalization, WinPaletter offers an intuitive interface and robust features to streamline the management and application of colors and effects on your Windows system.

#### With WinPaletter, you can customize a wide range of Windows aspects, including Windows Colors, Visual Styles, Classic Colors, Lock screen (LogonUI), Cursors, Metrics and Fonts, Terminals and Consoles, wallpaper, sounds, screen savers, Windows effects (tweaks), and Windows icons according to your preferences.

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/Features.png?raw=true) Key Features

- **Intuitive Interface:** WinPaletter boasts a user-friendly interface, making color palette management accessible to users of all levels of expertise.

- **Themes Import/Export:** Explore a world of creativity with the ability to import and export themes. Visit the WinPaletter Store to discover a diverse collection of themes shared by the community.

- **Real-time Preview:** Witness your color choices come to life with the real-time preview feature, allowing you to fine-tune your color scheme effortlessly.
  
![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_0.png?raw=true)

![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_1.png?raw=true)

![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_2.png?raw=true)

![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_3.png?raw=true)

![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_4.png?raw=true)

![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_5.png?raw=true)

![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Preview_6.png?raw=true)

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/GettingStarted.png?raw=true) Getting Started

1. **Requirements:**

| **Windows Version** | **Supported WinPaletter Version** | **.NET Framework 4.8 Requirement** |
|---------------------|-----------------------------------|------------------------------------|
| **11**              | `Any version`                     | Pre-installed                      |
| **10**              | `Any version`                     | Might require [manual update](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48) if build is less than `1709` |
| **8.1**             | `1.0.5.0+`                        | Install from [Microsoft](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48) |
| **8**               | `1.0.9.5+`                        | Install via [custom method](https://github.com/Abdelrhman-AK/WinPaletter/wiki/Compatibility-8) |
| **7**               | `1.0.5.0+`                        | Install from [Microsoft](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48) |
| **Vista**           | `1.0.7.1+`                        | Requires repacked version — [see guide](https://github.com/Abdelrhman-AK/WinPaletter/wiki/Compatibility-Vista) |
| **XP**              | `1.0.7.1+`                        | Requires OneCoreAPI + repacked version — [see guide](https://github.com/Abdelrhman-AK/WinPaletter/wiki/Compatibility-XP) |

3. **Download:** 
   
   - You can download the latest release from the [releases page](https://github.com/Abdelrhman-AK/WinPaletter/releases).
     > **Note:** It is the first source to be updated.
   
   - Alternatively, you can use:
  
     - Softonic: [Visit WinPaletter Page at Softonic](https://winpaletter.en.softonic.com)
     
     - Microsoft WinGet: 
       
       `winget install Abdelrhman-AK.WinPaletter` and run in Terminal by typing `WinPaletter`
     
     - Chocolatey:
       
        `choco install WinPaletter` or `choco install WinPaletter --version x.x.xx`
     
     - [Visit this](https://github.com/Abdelrhman-AK/WinPaletter/wiki/Get-WinPaletter) for advanced instructions.

4. **Launch:** Once downloaded, launch WinPaletter and start exploring its features to enhance your desktop aesthetics.

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/Help.png?raw=true) Wiki (Help)

[Click here](https://github.com/Abdelrhman-AK/WinPaletter/wiki) to learn more about WinPaletter.

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/Languages.png?raw=true) Languages

[Click here](https://github.com/Abdelrhman-AK/WinPaletter/tree/master/Languages) to get languages for WinPaletter.

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/Antivirus.png?raw=true) Do you have an antivirus or browser issue?

[Click here to read instructions](https://github.com/Abdelrhman-AK/WinPaletter/wiki/Antiviruses-or-browsers-download-issue).

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/Credits.png?raw=true) Credits

WinPaletter is developed and maintained by [Abdelrhman-AK](https://github.com/Abdelrhman-AK) and the incredible open-source community:

- Modifying Modern Windows Elements Inspired by u/aveyo and u/Egg-Tricky on Reddit: [Link 1](https://www.reddit.com/r/Windows11/comments/sw15u0/dark_theme_did_you_notice_the_ugly_pale_accent), [Link 2](https://www.reddit.com/r/Windows11/comments/tkvet4/pitch_black_themereg_now_for_ctrlaltdel_as_well)

- [Logging WinPaletter events into JSON files by Serilog](https://github.com/serilog/serilog)

- [3D and flat degrees modification in 3D objects (Classic Colors) is inspired by Desktop Architect](https://en.wikipedia.org/wiki/Desktop_Architect).

- [Colors picking controls by Cyotek](https://github.com/cyotek/Cyotek.Windows.Forms.ColorPicker)

- [Bitmaps to cursors conversion mechanism developed by Evan Olds](https://github.com/evanolds/AnimCur)

- [Retrieving elements of Windows XP visual styles (*.msstyles) using the Advanced UxTheme wrapper](https://www.codeproject.com/Articles/18603/Advanced-UxTheme-wrapper)

- [Extracting elements from visual styles (*.msstyles) of Windows Vista and later using nptr/msstyleEditor (libmsstyle)](https://github.com/nptr/msstyleEditor)

- [Patching PE files by Ressy, developed by Tyrrrz](https://github.com/Tyrrrz/Ressy)

- [Handling JSON files using Newtonsoft JSON by James Newton-King](https://github.com/JamesNK/Newtonsoft.Json)

- [Processing and handling command lines arguments by CommandLineParser](https://github.com/commandlineparser/commandline)

- [Icons designed by Pichon](https://icons8.com/app/windows)

- [Animation and transition effects for controls by FluentTransitions, developed by Andreas Wäscher](https://github.com/awaescher/FluentTransitions)

- [Controls animations by Pavel Torgashov](https://www.codeproject.com/Articles/548769/Animator-for-WinForms)

- [Dark Task Dialog based on memoarfaa/DarkTaskDialog-Native, extended by WinPaletter for more dialogs](https://github.com/memoarfaa/DarkTaskDialog-Native)

- [FastCloner by lofcz (used inside theme manager core)](https://github.com/lofcz/FastCloner)

- [Using JetBrainsMono as a monospaced font for WinPaletter](https://github.com/JetBrains/JetBrainsMono)

- [These items are provided by Microsoft: Classic color schemes, Luna theme preview (Luna.msstyles) and Command Prompt and PowerShell raster fonts previews](https://www.microsoft.com)

## ![alt text](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/Media/Mini-Icons/License.png?raw=true) License

WinPaletter is licensed under the [MIT/LGPL Dual License](https://github.com/Abdelrhman-AK/WinPaletter/blob/master/License.md). Feel free to use, modify, and distribute it in accordance with the terms of the license.