extended KDE cursor π
---
# BreezeX Cursor
Extended KDE Cursor theme, Highly inspired on **KDE Breeze** for `Windows` and `Linux` with _HiDPi Support_ π.
#### Cursor Sizes
22
24
28
32
40
48
56
64
72
80
88
96
#### Colors
#### Quick install
#### Preview:
> Check Figma file [here](https://www.figma.com/file/Uo4LeHvFUPDgoqLjnFc1LB/BreezeX?node-id=0%3A1)
Dark BreezeX Cursors
Light BreezeX Cursors
### Manual Install
#### Linux/X11
```bash
# extract `BreezeX.tar.gz`
tar -xvf BreezeX.tar.gz
# For local users
mv BreezeX-* ~/.icons/
# For all users
sudo mv BreezeX-* /usr/share/icons/
```
#### Windows
1. unzip `.zip` file
2. Open unzipped directory in Explorer, and **right click** on `install.inf`.
3. Click 'Install' from the context menu, and authorize the modifications to your system.
4. Open _Control Panel > Personalization and Appearance > Change mouse pointers_, and select **BreezeX Cursors**.
5. Click '**Apply**'.
# Dependencies
## External Libraries
- libxcursor
- libx11
- libpng (<=1.6)
#### Install External Libraries
##### ~macOS~ **[WIP]**
```bash
brew install --cask xquartz
brew install libpng
```
##### Debain/ubuntu
```bash
sudo apt install libx11-dev libxcursor-dev libpng-dev
```
##### ArchLinux/Manjaro
```bash
sudo pacman -S libx11 libxcursor libpng
```
##### Fedora/Fedora Silverblue/CentOS/RHEL
```bash
sudo dnf install libX11-devel libXcursor-devel libpng-devel
```
## Build Dependencies
- [gcc](https://gcc.gnu.org/install/)
- [make](https://www.gnu.org/software/make/)
- [nodejs](https://nodejs.org/en/) (<=12.x.x)
- [yarn](https://classic.yarnpkg.com/en/docs/install/)
- [python](https://www.python.org/downloads/) (<=3.8)
- [pip3](https://pip.pypa.io/en/stable/installing/)
### Node Packages
- [puppeteer](https://www.npmjs.com/package/puppeteer)
- [pngjs](https://www.npmjs.com/package/pngjs)
- [pixelmatch](https://www.npmjs.com/package/pixelmatch)
### PyPi Packages
- [clickgen](https://pypi.org/project/clickgen/s)
## Build Dependencies
- [gcc](https://gcc.gnu.org/install/)
- [make](https://www.gnu.org/software/make/)
- [nodejs](https://nodejs.org/en/) (<=12.x.x)
- [yarn](https://classic.yarnpkg.com/en/docs/install/)
- [python](https://www.python.org/downloads/) (<=3.8)
- [pip3](https://pip.pypa.io/en/stable/installing/)
### Node Packages
- [puppeteer](https://www.npmjs.com/package/puppeteer)
- [pngjs](https://www.npmjs.com/package/pngjs)
- [pixelmatch](https://www.npmjs.com/package/pixelmatch)
### PyPi Packages
- [clickgen](https://pypi.org/project/clickgen/s)
## Build From Scratch
### β‘ Auto Build (using GitHub Actions)
GitHub Actions is automatically runs on every `push`(on **main** and **dev** branches) and `pull request`(on **main** branch), You found theme resources in `artifact` section of **build**.GitHub **Actions** available inside [.github/workflows](https://github.com/ful1e5/BreezeX_Cursor/tree/main/.github/workflows) directory.
### Manual Build
```bash
make
```
#### Build `XCursor` theme
```bash
make unix
```
#### Customize `XCursor` size
```bash
make unix X_SIZES=22 # Only built '22px' pixel-size.
make unix X_SIZES=22 24 32 # Multiple sizes are provided with ' '(Space)
```
#### Install `XCursor` theme
```bash
make install # install as user
# OR
sudo make install # install as root
```
#### Build `Windows` theme
```bash
make windows
```
#### Customize `Windows Cursor` size
```bash
make windows WIN_SIZE=96 # Supports only one pixel-size
```
> For installation follow [these](#windows) steps.
# Bugs
Bugs π should be reported [here](https://github.com/ful1e5/BreezeX_Cursor/issues) on the Github issues page.
# Getting Help
You can create a **issue**, I will help you. π
# Contributing
Check [CONTRIBUTING.md](CONTRIBUTING.md), any suggestions for features and contributions to the continuing code masterelopment can be made via the issue tracker or code contributions via a `Fork` & `Pull requests`.
## Support
Give a **β
** or Follow on [GitHub](https://github.com/ful1e5),That's work as **Steroid π** for me. π
> For extra support
( `ΟΒ΄ )ΫΆβ¬ΞΉβββββββοΊ€
I'm Using Katana