π macOS Cursor Theme
---
# Apple Cursor
Enjoy upcoming **[macOS BigSur](https://www.apple.com/macos/big-sur-preview/)** Cursor Theme for `Windows` and `Linux` with _HiDPi Support_ π.
Table of Contents (click to expand)
- [Apple Cursor](#apple-cursor)
- [Cursor Sizes](#cursor-sizes)
- [Colors](#colors)
- [Quick Install For Linux](#quick-install)
- [Manual Install](#manual-install)
- [Linux Install](#linux/x11)
- [Windows Install](#windows)
- [Cursors Preview](#preview)
- [Dependencies](#dependencies)
- [Runtime Dependencies](#runtime-dependencies)
- [Build Dependencies](#build-dependencies)
- [Build From Scrach](#build-from-scratch)
- [β‘ Auto Build (using GitHub Actions)](#β‘-auto-build-using-gitHub-actions)
- [Manual build](#manual-build)
- [Setup Python Environment](#setup-python-environment)
- [Compile Theme using yarn](#using-yarn)
- [Compile Theme using npm](#using-npm)
- [Install Build Theme](#install-build-theme)
- [Bugs](#bugs)
- [Getting Help](#getting-help)
- [Contributing](#contributing)
- [Support β¨](#support)
#### Cursor Sizes
24
28
32
40
48
56
64
72
80
88
96
#### Colors
#### Quick install
##### via curl
```bash
bash <(curl -s "https://raw.githubusercontent.com/ful1e5/apple_cursor/master/scripts/install.sh")
```
##### via wget
```bash
bash <(wget -qO- "https://raw.githubusercontent.com/ful1e5/apple_cursor/master/scripts/install.sh")
```
### Manual Install
#### Linux/X11
```bash
# extract `macOSBigSur.tar`
mkdir macOSBigSur && tar -xvf macOSBigSur.tar -C macOSBigSur
# 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](https://github.com/ful1e5/apple_cursor/blob/master/src/svg/README.md)
macOSBigSur Cursors π
# Dependencies
## Runtime Dependencies
- libxcursor-dev
- libx11-dev
- libpng-dev (<=1.6)
#### Install Runtime Dependencies
##### macOS
```bash
brew cask install xquartz 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
- [nodejs](https://nodejs.org/en/) (<=12.x.x)
- [yarn](https://classic.yarnpkg.com/en/docs/install/) / [npm](https://docs.npmjs.com/cli/install.html)
- [python](https://www.python.org/downloads/) (<=3.6)
- [pip3](https://pip.pypa.io/en/stable/installing/)
### Node Packages
#### devDependencies
- [@types/puppeteer](https://www.npmjs.com/package/@types/puppeteer)
- [nodemon](https://www.npmjs.com/package/nodemon)
- [ts-node](https://www.npmjs.com/package/ts-node)
- [tslint](https://www.npmjs.com/package/tslint)
- [typescript](https://www.npmjs.com/package/typecript)
#### dependencies
- [puppeteer](https://www.npmjs.com/package/puppeteer)
### PyPi Packages
- [clickgen](https://pypi.org/project/clickgen/s)
- [Pillow](https://pypi.org/project/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](https://github.com/ful1e5/apple_cursor/tree/master/.github/workflows) directory.
### Manual Build
#### Setup python environment
```bash
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-python-environment) setup and `virtualenv` is **active**.
##### Using yarn
```bash
yarn install # Install all Node Packages
yarn py_install # Install all PyPi Packages
yarn compile # Compile the cursor theme
yarn unpack # To extract`./packages/macOSBigSur.tar` file
```
##### Using npm
```bash
npm install # Install all Node Packages
npm py_install # Install all PyPi Packages
npm compile # Compile the cursor theme
npm unpack # To extract`./packages/macOSBigSur.tar` file
```
After build `bitmaps` and `packages` directory are generated at project **root**.
### Install Build Theme
All builded cursor packages are available inside `packages` directory.
#### Linux
```bash
cd ./packages
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](https://github.com/ful1e5/apple_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 more support
( `ΟΒ΄ )ΫΆβ¬ΞΉβββββββοΊ€
I'm Using Katana