apple_cursor/README.md

🍎 macOS Cursor Theme

---

Apple Cursor

Enjoy upcoming macOS BigSur Cursor Theme for Windows and Linux with HiDPi Support 🎉.

Table of Contents (click to expand)

• Apple Cursor
  • Cursor Sizes
  • Colors
  • Quick Install For Linux
  • Manual Install
    • Linux Install
    • Windows Install
  • Cursors Preview
• Dependencies
  • Runtime Dependencies
  • Build Dependencies
• Build From Scrach
  • ⚡ Auto Build (using GitHub Actions)
  • Manual build
    • Setup Python Environment
    • Compile Theme using yarn
    • Compile Theme using npm
  • Install Build Theme
• Bugs
• Getting Help
• Contributing
• Support ✨

Cursor Sizes

24 28 32 40 48 56 64 72 80 88 96

Colors

Quick install

via curl

bash <(curl -s "https://raw.githubusercontent.com/ful1e5/apple_cursor/master/scripts/install.sh")

via wget

bash <(wget -qO- "https://raw.githubusercontent.com/ful1e5/apple_cursor/master/scripts/install.sh")

Manual Install

Linux/X11

# extract `macOSBigSur.tar`
tar -xvf macOSBigSur.tar

# For local users
mv macOSBigSur ~/.icons/

# For all users
sudo mv macOSBigSur /usr/share/icons/

Windows

1. unzip macOSBigSur_Windows.zip file
2. Open macOSBigSur_Windows/ in Explorer, and right click on install.inf.
3. Click 'Install' from the context menu, and authorise the modifications to your system.
4. Open Control Panel > Personalisation and Appearance > Change mouse pointers, and select MacOSBigSur Cursors.
5. Click 'Apply'.

Preview:

Detailed Cursors Informations inside src/svgs/README.md

_{macOSBigSur Cursors 🍎}

Dependencies

Runtime Dependencies

• libxcursor-dev
• libx11-dev
• libpng-dev (<=1.6)

Install Runtime Dependencies

macOS

brew cask install xquartz libpng

Debain/ubuntu

sudo apt install libx11-dev libxcursor-dev libpng-dev

ArchLinux/Manjaro

sudo pacman -S libx11 libxcursor libpng

Fedora/Fedora Silverblue/CentOS/RHEL

sudo dnf install libx11-devel libxcursor-devel libpng-devel

Build Dependencies

• nodejs (<=12.x.x)
• yarn / npm
• python (<=3.6)
• pip3

Node Packages

devDependencies

• @types/puppeteer
• @types/pngjs
• @types/pixelmatch
• nodemon
• ts-node
• tslint
• typescript

dependencies

• puppeteer
• pngjs
• pixelmatch

PyPi Packages

• clickgen
• Pillow

Build From Scratch

⚡ Auto Build (using GitHub Actions)

GitHub Actions is automatically runs on every push(on master and dev branches) and pull request(on master branch), You found theme resources in artifact section of build.GitHub Actions available inside .github/workflows directory.

Manual Build

Setup python environment

python3 -m pip install --upgrade pip                 # Update pip to latest
python3 -m pip3 install virtualenv                   # Install python virtual environment
virtualenv venv                                      # Create new virtualenv named `venv`
source venv/bin/activate                             # Activate virtualenv

# For Deactivate virtualenv
deactivate

Compile From Source

Make sure your python environment setup and virtualenv is active.

Using yarn

yarn install                                         # Install all Node Packages
yarn py_install                                      # Install all PyPi Packages
yarn compile                                         # Compile the cursor theme

Using npm

npm install                                          # Install all Node Packages
npm py_install                                       # Install all PyPi Packages
npm compile                                          # Compile the cursor theme

After build bitmaps and themes directory are generated at project root.

Install Build Theme

All builded cursor themes are available inside themes directory.

Linux

cd ./themes
rm -rf ~/.icons/macOSBigSur && cp macOSBigSur ~/.icons/   # installing Theme to local user(recommend)

Windows

1. unzip macOSBigSur_Windows.zip file
2. Open the settings app.
3. Goto Devices -> Mouse -> Additional Mouse Options.
4. Goto the pointers tab.
5. Replace each cursor in the currently applied cursor set with the corresponding cursor in the macOSBigSur_Windows folder.
6. Click "save as" and type in the desired name.
7. Click "apply" and "ok".

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.

Support

Give a ★ or Follow on GitHub,That's work as Steroid 💉 for me. 😉

For more support

( `ω´ )۶▬ι═══════ﺤ

_{I'm Using Katana}