extended KDE cursor.
Extended KDE cursor, Highly inspired on KDE Breeze for Windows
and Linux
with HiDPi Support .
Until 2021 my cursors projects were well funded by pling.com but since the pling-factor on the website has decreased and monthly payments are <500$, It is now dependent on community funding and sponsorships. If you want to help me to maintain BreezeX and my other open source projects actively, consider sponsoring my work on GitHub Sponsor or DM me on Twitter if your company would like to support my projects, I will gladly look into it and post your avatar in the project's README.
I appreciate all the wonderful people who patronize and sponsoring my work.
N/A
Note All cursor's
.svg
files are found in svg directory or you can also find them on Figma.
22 24 28 32 40 48 56 64 72 80 88 96
#4D4D4D
(Breeze)#FFFFFF
(White)#FFFFFF
(White)#4D4D4D
(Breeze)#000000
(Black)#FFFFFF
(White)You can download latest stable
& development
releases from
Release Page.
Installation:
tar -xvf BreezeX-Dark.tar.gz # extract `BreezeX-Dark.tar.gz`
mv BreezeX-* ~/.icons/ # Install to local users
sudo mv BreezeX-* /usr/share/icons/ # Install to all users
Uninstallation:
rm ~/.icons/BreezeX-* # Remove from local users
sudo rm /usr/share/icons/BreezeX-* # Remove from all users
Installation:
.zip
fileinstall.inf
.Uninstallation:
Run the uninstall.bat
script packed with the .zip
archive
OR follow these steps:
HKEY_CURRENT_USER
folder and expand Control Panel
folder.Cursors
folder and click on Schemes
folder - all the available custom cursors that are
installed will be listed here.Delete
.build.toml
file..svg
files to .png
files..png
files or resizing them
you don't need that. If you want to develop/modify BreezeX's colors, and bitmaps, or generate a png
file from a svg, Then you can use yarn because bitmapper is written in TypeScript.build.toml
is responsible for building all variants. Due to this, you will have
to change the following options in ctgen
to build the appropriate variant:
ctgen --help
for all available options.git clone https://github.com/ful1e5/BreezeX_Cursor
cd BreezeX_Cursor && yarn build
Note Bitmaps are already generated in the
bitmaps
directory and managed by the maintainer (do not edit them directly).
First make sure you installed the build prerequisites.
Now that you have the dependencies, you can try build individual themes from bitmaps and
customize sizes, target platform, and etc. with the ctgen
CLI (packed with clickgen
).
yarn build
aberrationHere are the default commands we used to build the BreezeX's variants and packed them into yarn build
:
ctgen build.toml -d 'bitmaps/BreezeX-Dark' -n 'BreezeX-Dark' -c 'BreezeX Dark cursors.'
ctgen build.toml -d 'bitmaps/BreezeX-Light' -n 'BreezeX-Light' -c 'BreezeX Light cursors.'
ctgen build.toml -d 'bitmaps/BreezeX-Black' -n 'BreezeX-Black' -c 'BreezeX Black cursors.'
Afterwards, the themes can be found in the themes
directory.
Note You can change the cursor size up to 200 because pngs are rendered with 200x200. If the cursor is resized by more than rendered png size, the final cursor will be blurred.
To build Windows cursor with size 16
:
Warning Windows cursor supports only one size, if multiple sizes are given with
-s
the first size will be considered in build.
ctgen build.toml -s 16 -p windows -d 'bitmaps/BreezeX-Light' -n 'BreezeX-Light' -c 'White BreezeX cursors with size 16'
You can also customize output directory with -o
option:
ctgen build.toml -s 16 -p windows -d 'bitmaps/BreezeX-Light' -o 'out' -n 'BreezeX-Light' -c 'White BreezeX cursors with size 16'
To build XCursor with size 16
:
ctgen build.toml -s 16 -p x11 -d 'bitmaps/BreezeX-Light' -n 'BreezeX-Light' -c 'White BreezeX cursors with size 16'
You can also assign multiple sizes to ctgen
for XCursors build:
ctgen build.toml -s 16 24 32 -p x11 -d 'bitmaps/BreezeX-Light' -n 'BreezeX-Light' -c 'White BreezeX cursors with size 16'
To customize BreezeX's color you have to install node dependencies with yarn install
command.
After installing dependencies you can customize the colors via npx cbmp
Node CLI App which packed with
cbmp node package.
yarn render
aberrationHere are the default commands we used for generating the BreezeX's bitmaps and packed them into yarn render
:
npx cbmp -d 'svg' -n 'BreezeX-Dark' -bc '#4D4D4D' -oc '#FFFFFF'
npx cbmp -d 'svg' -n 'BreezeX-Light' -bc '#FFFFFF' -oc '#4D4D4D'
npx cbmp -d 'svg' -n 'BreezeX-Black' -bc '#000000' -oc '#FFFFFF'
Lets generate modern BreezeX with green base color and black outline:
npx cbmp -d 'svg' -n 'BreezeX-Hacker' -bc '#00FE00' -oc '#000000'
After rendering custom color you have to build cursor through ctgen
:
ctgen build.toml -d 'bitmaps/BreezeX-Hacker' -n 'BreezeX-Hacker' -c 'Green and black BreezeX cursors.'
Afterwards, Generated theme can be found in the themes
directory.
npx cbmp -d 'svg' -n 'BreezeX-Gruvbox' -bc '#282828' -oc '#EBDBB2'
ctgen build.toml -d 'bitmaps/BreezeX-Gruvbox' -n 'BreezeX-Gruvbox' -c 'Groovy BreezeX cursors.'
npx cbmp -d 'svg' -n 'BreezeX-Solarized-Dark' -bc '#002b36' -oc '#839496'
ctgen build.toml -d 'bitmaps/BreezeX-Solarized-Dark' -n 'BreezeX-Solarized-Dark' -c 'Solarized Dark BreezeX cursors.'
npx cbmp -d 'svg' -n 'BreezeX-Solarized-Light' -bc '#839496' -oc '#002b36'
ctgen build.toml -d 'bitmaps/BreezeX-Solarized-Light' -n 'BreezeX-Solarized-Light' -c 'Solarized Light BreezeX cursors.'
npx cbmp -d 'svg' -n 'BreezeX-Dracula' -bc '#282a36' -oc '#f8f8f2'
ctgen build.toml -d 'bitmaps/BreezeX-Dracula' -n 'BreezeX-Dracula' -c 'Dracula BreezeX cursors.'
Bugs should be reported here on the Github issues page.
You can create a issue, I will help you.
Check 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
.