fuchsia-cursor
fuchsia-cursor copied to clipboard
First OpenSource port of FuchsiaOS's cursors for Linux and Windows.
Fuchsia Cursor
First open source port of FuchsiaOS's cursors for Linux and Windows.
Fuchsia Cursor needs your Input
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 fuchsia-cursor 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.
Sponsors
N/A
Note All cursor's
.svg
files are found in svg directory or you can also find them on Figma.
Cursor Sizes
Xcursor Sizes:
22 24 28 32 40 48 56 64 72 80 88 96
Windows Cursor Size:
- 16x16 - Small
- 24x24 - Regular
- 32x32 - Large
- 48x48 - Extra Large
Colors:
Fuchsia
- Base Color -
#E11C79
(Fuchsia) - Outline Color -
#FFFFFF
(White)
Fuchsia Pop!
- Base Color -
#F8B572
(PopOS Orange) - Outline Color -
#FFFFFF
(White)
Fuchsia Red
- Base Color -
#FF0000
(Red) - Outline Color -
#FFFFFF
(White)
How to get it
Easiest Way
You can download latest stable
& development
releases from
Release Page.
Installing Fuchsia Cursor
Linux/X11
Installation:
tar -xvf Fuchsia.tar.gz # extract `Fuchsia.tar.gz`
mv Fuchsia ~/.icons/ # Install to local users
sudo mv Fuchsia /usr/share/icons/ # Install to all users
Uninstallation:
rm ~/.icons/Fuchsia # Remove from local users
sudo rm /usr/share/icons/Fuchsia # Remove from all users
Windows
Installation:
- Unzip
.zip
file - Open unziped directory in Explorer, and right click on
install.inf
. - Click 'Install' from the context menu, and authorize the modifications to your system.
- Open Control Panel > Personalization and Appearance > Change mouse pointers, and select Fuchsia Cursors.
- Click 'Apply'.
Uninstallation:
Run the uninstall.bat
script packed with the .zip
archive
OR follow these steps:
- Go to Registry Editor by typing the same in the start search box.
- Expand
HKEY_CURRENT_USER
folder and expandControl Panel
folder. - Go to
Cursors
folder and click onSchemes
folder - all the available custom cursors that are installed will be listed here. -
Right Click on the name of cursor file you want to uninstall; for eg.: Fuchsia Cursors and
click
Delete
. - Click 'yes' when prompted.
Build From Source
Notes
- Fuchsia-Cursor build configuration and cursor hotspot settings are bundled in the
build.toml
file. - Check out the scripts section in package.json to see how we build the cursor theme,
excluding the render scripts. They are useful for converting
.svg
files to.png
files. - yarn is optional, For building XCursors and Windows cursors from
.png
files or resizing them you don't need that. If you want to develop/modify Fuchsia-Cursor's colors, and bitmaps, or generate a png file from a svg, Then you can use yarn because bitmapper is written in TypeScript. - Since Fuchsia-Cursor variants are designed similarly, they share the same hotspot settings so a
single configuration file
build.toml
is responsible for building all variants. Due to this, you will have to change the following options inctgen
to build the appropriate variant:- -d: bitmaps directory
- -n: The name you want to give to the generated theme.
- -c: Theme comment.
- See
ctgen --help
for all available options.
Build prerequisites
Quick start
- Install build prerequisites on your system
-
git clone https://github.com/ful1e5/fuchsia-cursor
-
cd fuchsia-cursor && yarn build
- See Installing Fuchsia Cursor.
Building
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
aberration
Here are the default commands we used to build the Fuchsia-Cursor's variants and packed them into yarn build
:
ctgen build.toml -d 'bitmaps/Fuchsia' -n 'Fuchsia' -c 'Fuchsia cursors.'
ctgen build.toml -d 'bitmaps/Fuchsia-Pop' -n 'Fuchsia-Pop' -c 'Fuchsia Pop! cursors.'
ctgen build.toml -d 'bitmaps/Fuchsia-Red' -n 'Fuchsia-Red' -c 'Fuchsia Red cursors.'
Afterwards, the themes can be found in the themes
directory.
Customize Sizes
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.
Customize Windows Cursor size
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/Fuchsia' -n 'Fuchsia' -c 'Fuchsia cursors with size 16'
You can also customize output directory with -o
option:
ctgen build.toml -s 16 -p windows -d 'bitmaps/Fuchsia' -o 'out' -n 'Fuchsia' -c 'Fuchsia cursors with size 16'
Customize XCursor size
To build XCursor with size 16
:
ctgen build.toml -s 16 -p x11 -d 'bitmaps/Fuchsia' -n 'Fuchsia' -c 'Fuchsia 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/Fuchsia' -n 'Fuchsia' -c 'Fuchsia cursors with size 16'
Customize Colors
To customize Fuchsia-Cursor'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
aberration
Here are the default commands we used for generating the Fuchsia-Cursor's bitmaps and packed them into yarn render
:
npx cbmp -d 'svg' -n 'Fuchsia' -bc '#E11C79' -oc '#FFFFFF'
npx cbmp -d 'svg' -n 'Fuchsia-Pop' -bc '#F8B572' -oc '#FFFFFF'
npx cbmp -d 'svg' -n 'Fuchsia-Red' -bc '#FF0000' -oc '#FFFFFF'
Examples
Lets generate modern Fuchsia-Cursor with green base color and black outline:
npx cbmp -d 'svg' -n 'Fuchsia-Hacker' -bc '#00FE00' -oc '#000000'
After rendering custom color you have to build cursor through ctgen
:
ctgen build.toml -d 'bitmaps/Fuchsia-Hacker' -n 'Fuchsia-Hacker' -c 'Green and black FuchsiaOS cursors.'
Afterwards, Generated theme can be found in the themes
directory.
Fuchsia Gruvbox
npx cbmp -d 'svg' -n 'Fuchsia-Gruvbox' -bc '#282828' -oc '#EBDBB2'
ctgen build.toml -d 'bitmaps/Fuchsia-Gruvbox' -n 'Fuchsia-Gruvbox' -c 'Groovy FuchsiaOS cursors.'
Fuchsia Solarized Dark
npx cbmp -d 'svg' -n 'Fuchsia-Solarized-Dark' -bc '#002b36' -oc '#839496'
ctgen build.toml -d 'bitmaps/Fuchsia-Solarized-Dark' -n 'Fuchsia-Solarized-Dark' -c 'Solarized Dark FuchsiaOS cursors.'
Fuchsia Solarized Light
npx cbmp -d 'svg' -n 'Fuchsia-Solarized-Light' -bc '#839496' -oc '#002b36'
ctgen build.toml -d 'bitmaps/Fuchsia-Solarized-Light' -n 'Fuchsia-Solarized-Light' -c 'Solarized Light FuchsiaOS cursors.'
Fuchsia Dracula
npx cbmp -d 'svg' -n 'Fuchsia-Dracula' -bc '#282a36' -oc '#f8f8f2'
ctgen build.toml -d 'bitmaps/Fuchsia-Dracula' -n 'Fuchsia-Dracula' -c 'Dracula FuchsiaOS cursors.'
Bugs
Bugs should be reported here on the Github issues page.
Getting Help
You can create a issue, I will help you.
Contributing
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
.