- Notifications
You must be signed in to change notification settings - Fork14
ful1e5/banana-cursor
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
A cursor was requested byu/JMT37. It is the most unique cursor ever crafted in Linux history.
- 2024-07-21:04eb3aa Partitioned cursor build configuration into multiple files according to platform:
build.toml
->configs/win_lg.build.toml
,configs/win_rg.build.toml
,configs/win_xl.build.toml
,configs/x.build.toml
.
1620222428324048566472808896
size | Regular (× ²⁄₃) | Large (× ⁴⁄₅) | Extra-Large (× 1) |
---|---|---|---|
32 | 21.333 → 22 | 25.6 → 26 | 32 |
48 | 32 | 38.4 → 39 | 48 |
64 | 42.666 → 43 | 51.2 → 52 | 64 |
96 | 64 | 76.8 → 77 | 96 |
128 | 85.333 → 86 | 102.4 → 103 | 128 |
- Base Color -
#FCD900
(Yellow) - Outline Color -
#6D3C1B
(Brown)
- Base Color -
#54F851
(Green) - Outline Color -
#0C2608
(Dark Green)
- Base Color -
#64CDCD
(Blue) - Outline Color -
#0E2026
(Dark Blue)
- Base Color -
#E16C6C
(Red) - Outline Color -
#1B0707
(Dark Red)
You can download lateststable
&development
releases fromRelease Page.
Installation:
tar -xvf Banana.tar.gz# extract `Banana.tar.gz`mv Banana~/.icons/# Install to local userssudo mv Banana /usr/share/icons/# Install to all users
Uninstallation:
rm~/.icons/Banana# Remove from local userssudo rm /usr/share/icons/Banana# Remove from all users
Installation:
- Unzip
.zip
file - Open unziped directory in Explorer, andright 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 selectBanana Cursors.
- Click 'Apply'.
Uninstallation:
Run theuninstall.bat
script packed with the.zip
archive
OR follow these steps:
- Go toRegistry Editor by typing the same in thestart 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 areinstalled will be listed here. - Right Click on the name of cursor file you want to uninstall; for eg.:Banana Cursors andclick
Delete
. - Click 'yes' when prompted.
- Installbuild prerequisites on your system
git clone https://github.com/ful1e5/banana-cursor
cd banana-cursor
yarn install
yarn generate
- SeeInstalling Banana Cursor.
Once you have thebuild prerequisites installed, You can personalize colors,customize sizes, change target platforms, and more. This process involves using external tools,as this repository only contains SVG files and configuration for these tools:
- cbmp: Used for customizing colors and generating PNG files.
- ctgen: Used for customizing sizes and building XCursor and Windows Cursors.
You can refer to the README of each tool for more information on their command-line options.
The process of creating custom cursor themes involves two main steps:
- Rendering SVG files to PNG files.
- Building cursor themes from PNG files.
cbmp
provides three options for changing colors:
-bc
: Base color, which replaces the#00FF00
color in the SVG.-oc
: Outlined color, which replaces the#0000FF
color in the SVG.-wc
(optional): Watch Background color, which replaces the#FF0000
color in the SVG.
npx cbmp [...] -bc"<hex>" -oc"<hex>" -wc"<hex>"
Alternatively, you can provide a JSON configuration file to render SVG files, which contains a sequence ofcbmp
commands:
npx cbmp render.json
To build Windows cursor with size16
:
ctgen configs/x.build.toml -s 16 -p windows -d"bitmaps/Banana" -n"Banana" -c"The Banana XCursors with size 16"
You can also customize output directory with-o
option:
ctgen configs/win_xl.build.toml -s 16 -p windows -d"bitmaps/Banana" -o"out" -n"Banana" -c"The Banana Windows Cursors with size 16"
To build XCursor with size16
:
ctgen configs/x.build.toml -s 16 -p x11 -d"bitmaps/Banana" -n"Banana" -c"The Banana XCursors with size 16"
You can also assign multiple sizes toctgen
for XCursors build:
ctgen configs/x.build.toml -s 16 18 24 32 -p x11 -d"bitmaps/Banana" -n"Banana" -c"The Banana XCursors with size 16"
Lets generate Banana Cursor with green and black colors:
npx cbmp -d"svg" -o"bitmaps/Banana-Hacker" -bc"#00FE00" -oc"#000000"
After rendering custom color you have to build cursor throughctgen
:
ctgen configs/x.build.toml -d"bitmaps/Banana-Hacker" -n"Banana-Hacker" -c"Green and Black Banana XCursors."
Afterwards, Generated theme can be found in thethemes
directory.
npx cbmp -d"svg" -o"bitmaps/Banana-Gruvbox" -bc"#282828" -oc"#EBDBB2"ctgen configs/x.build.toml -d"bitmaps/Banana-Gruvbox" -n"Banana-Gruvbox" -c"Groovy Banana XCursors."ctgen configs/win_rg.build.toml -d"bitmaps/Banana-Gruvbox" -n"Banana-Gruvbox" -c"Groovy Banana Windows Regular Cursors."ctgen configs/win_lg.build.toml -d"bitmaps/Banana-Gruvbox" -n"Banana-Gruvbox" -c"Groovy Banana Windows Large Cursors."ctgen configs/win_xl.build.toml -d"bitmaps/Banana-Gruvbox" -n"Banana-Gruvbox" -c"Groovy Banana Windows Extra Large Cursors."
npx cbmp -d"svg" -o"bitmaps/Banana-Solarized-Dark" -bc"#002b36" -oc"#839496"ctgen configs/x.build.toml -d"bitmaps/Banana-Solarized-Dark" -n"Banana-Solarized-Dark" -c"Solarized Dark Banana XCursors."ctgen configs/win_rg.build.toml -d"bitmaps/Banana-Solarized-Dark" -n"Banana-Solarized-Dark" -c"Solarized Dark Banana Windows Regular Cursors."ctgen configs/win_lg.build.toml -d"bitmaps/Banana-Solarized-Dark" -n"Banana-Solarized-Dark" -c"Solarized Dark Banana Windows Large Cursors."ctgen configs/win_xl.build.toml -d"bitmaps/Banana-Solarized-Dark" -n"Banana-Solarized-Dark" -c"Solarized Dark Banana Windows Extra Large Cursors."
npx cbmp -d"svg" -o"bitmaps/Banana-Solarized-Light" -bc"#839496" -oc"#002b36"ctgen configs/x.build.toml -d"bitmaps/Banana-Solarized-Light" -n"Banana-Solarized-Light" -c"Solarized Light Banana XCursors."ctgen configs/win_rg.build.toml -d"bitmaps/Banana-Solarized-Light" -n"Banana-Solarized-Light" -c"Solarized Light Banana Windows Regular Cursors."ctgen configs/win_lg.build.toml -d"bitmaps/Banana-Solarized-Light" -n"Banana-Solarized-Light" -c"Solarized Light Banana Windows Large Cursors."ctgen configs/win_xl.build.toml -d"bitmaps/Banana-Solarized-Light" -n"Banana-Solarized-Light" -c"Solarized Light Banana Windows Extra Large Cursors."
npx cbmp -d"svg" -o"bitmaps/Banana-Dracula" -bc"#282a36" -oc"#f8f8f2"ctgen configs/x.build.toml -d"bitmaps/Banana-Dracula" -n"Banana-Dracula" -c"Dracula Banana XCursors."ctgen configs/win_rg.build.toml -d"bitmaps/Banana-Dracula" -n"Banana-Dracula" -c"Dracula Banana Windows Regular Cursors."ctgen configs/win_lg.build.toml -d"bitmaps/Banana-Dracula" -n"Banana-Dracula" -c"Dracula Banana Windows Large Cursors."ctgen configs/win_xl.build.toml -d"bitmaps/Banana-Dracula" -n"Banana-Dracula" -c"Dracula Banana Windows Extra Large Cursors."
There are several websites that allow you to test your cursor states by hovering over buttons. This can be very useful when developing or verifying the behavior of a cursor. The following websites cover many of the most commonly used cursors, although they may not include all available options.
For a blueprint for creating XCursors, you may also want to refer toCursor-demo.
Bugs should be reportedhere on the Github issues page.
You can create aissue, I will help you.
CheckCONTRIBUTING.md, any suggestions for features and contributions to the continuing code masterelopment can be made via the issue tracker or code contributions via aFork
&Pull requests
.