2020-07-29 08:13:04 -04:00
<!-- Branding -->
< p align = "center" >
2020-08-31 01:04:42 -04:00
< img src = "https://i.imgur.com/GVLFmwF.png" width = "120" alt = "macOS Big Sur" / >
2020-07-29 08:13:04 -04:00
< / p >
< p align = "center" >
🍎 macOS Cursor Theme
< / p >
<!-- Badges -->
< p align = "center" >
2020-08-06 01:53:00 -04:00
<!-- First Row -->
2020-08-05 00:11:22 -04:00
< a href = "https://github.com/ful1e5/apple_cursor/actions?query=workflow%3Abuild" >
2020-08-06 01:53:00 -04:00
< img alt = "GitHub Action Build" src = "https://github.com/ful1e5/apple_cursor/workflows/build/badge.svg" width = "102" / >
2020-07-29 08:13:04 -04:00
< / a >
2020-08-06 03:12:53 -04:00
2020-08-06 01:53:00 -04:00
< a href = "https://www.codefactor.io/repository/github/ful1e5/apple_cursor" >
2020-08-06 03:12:53 -04:00
< img alt = "CodeFactor" src = "https://www.codefactor.io/repository/github/ful1e5/apple_cursor/badge" / >
2020-08-06 01:53:00 -04:00
< / a >
<!-- Second Row -->
2020-08-06 03:12:53 -04:00
< / br >
2020-08-06 03:17:35 -04:00
< a href = "https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html" >
2020-08-06 03:12:53 -04:00
< img alt = "npm type definitions" src = "https://img.shields.io/npm/types/typescript" >
< / a >
2020-08-06 03:17:35 -04:00
< a href = "https://github.com/puppeteer/puppeteer/" >
2020-08-06 03:12:53 -04:00
< img alt = "Puppeteer version" src = "https://img.shields.io/github/package-json/dependency-version/ful1e5/apple_cursor/puppeteer" >
< / a >
< a href = "https://github.com/ful1e5/clickgen" >
2020-08-06 07:42:42 -04:00
< img alt = "Clickgen" src = "https://img.shields.io/badge/theme%20builder-clickgen-FD0542" / >
2020-08-06 03:12:53 -04:00
< / a >
2020-08-06 23:56:01 -04:00
2020-08-06 03:12:53 -04:00
<!-- Second Row -->
< br / >
< a href = "https://github.com/ful1e5/apple_cursor/releases" >
< img alt = "Apple Cursor release (latest by date including pre-releases)" src = "https://img.shields.io/github/v/release/ful1e5/apple_cursor?include_prereleases" / >
< / a >
2020-10-01 00:38:10 -04:00
< a href = "https://github.com/ful1e5/apple_cursor/blob/main/LICENSE" >
2020-08-06 03:12:53 -04:00
< img alt = "License" src = "https://img.shields.io/github/license/ful1e5/apple_cursor?color=0081FB" / >
< / a >
<!-- Third Row -->
2020-08-06 23:56:01 -04:00
< br / >
< a href = "https://www.pling.com/p/1408466#files-panel" >
< img alt = "License" src = "https://img.shields.io/badge/-Linux-grey?logo=linux" / >
< / a >
< a href = "https://www.pling.com/p/1408466#files-panel" >
< img alt = "License" src = "https://img.shields.io/badge/-Windows-blue?logo=windows" / >
< / a >
< a href = "https://www.python.org/" >
< img alt = "License" src = "https://img.shields.io/badge/-Python-yellow?logo=python" / >
< / a >
<!-- Fourth Row -->
2020-08-06 01:53:00 -04:00
< br / >
2020-08-05 00:11:22 -04:00
< a href = "https://github.com/ful1e5" >
2020-08-06 03:12:53 -04:00
< img alt = "Made By Kaiz" src = "https://kaiz.vercel.app/api/badge" width = "133" / >
2020-08-03 01:03:54 -04:00
< / a >
2020-07-29 08:13:04 -04:00
< / p >
2020-08-06 08:30:49 -04:00
---
2020-08-06 09:03:32 -04:00
<!-- Intro -->
# Apple Cursor
2020-08-08 00:20:09 -04:00
Enjoy upcoming ** [macOS BigSur ](https://www.apple.com/macos/big-sur-preview/ )** Cursor Theme for `Windows` and `Linux` with _HiDPi Support_ 🎉.
2020-08-06 09:03:32 -04:00
2020-08-11 07:03:04 -04:00
<!-- Table Of Content -->
2020-08-11 04:31:28 -04:00
< details >
< summary > < strong > Table of Contents< / strong > (click to expand)< / summary >
- [Apple Cursor ](#apple-cursor )
2020-10-23 02:39:24 -04:00
- [Cursor Sizes ](#cursor-sizes )
- [Colors ](#colors )
- [Quick install ](#quick-install )
- [Manual Install ](#manual-install )
- [Linux/X11 ](#linuxx11 )
- [Windows ](#windows )
- [Preview: ](#preview )
2020-08-11 04:31:28 -04:00
- [Dependencies ](#dependencies )
- [Runtime Dependencies ](#runtime-dependencies )
2020-10-23 02:39:24 -04:00
- [Install Runtime Dependencies ](#install-runtime-dependencies )
- [macOS ](#macos )
- [Debain/ubuntu ](#debainubuntu )
- [ArchLinux/Manjaro ](#archlinuxmanjaro )
- [Fedora/Fedora Silverblue/CentOS/RHEL ](#fedorafedora-silverbluecentosrhel )
2020-08-11 04:31:28 -04:00
- [Build Dependencies ](#build-dependencies )
2020-10-23 02:39:24 -04:00
- [Node Packages ](#node-packages )
- [devDependencies ](#devdependencies )
- [dependencies ](#dependencies-1 )
- [PyPi Packages ](#pypi-packages )
- [Build From Scratch ](#build-from-scratch )
- [⚡ Auto Build (using GitHub Actions) ](#-auto-build-using-github-actions )
- [Manual Build ](#manual-build )
- [Setup python environment ](#setup-python-environment )
- [Compile From Source ](#compile-from-source )
- [Using yarn ](#using-yarn )
- [Using npm ](#using-npm )
- [Install Build Theme ](#install-build-theme )
- [Linux ](#linux )
- [Windows ](#windows-1 )
2020-08-11 04:31:28 -04:00
- [Bugs ](#bugs )
- [Getting Help ](#getting-help )
2020-08-11 07:03:04 -04:00
- [Contributing ](#contributing )
2020-10-23 02:39:24 -04:00
- [Support ](#support )
2020-08-11 04:31:28 -04:00
< / details >
2020-08-11 07:48:57 -04:00
#### Cursor Sizes
< kbd > 24< / kbd >
< kbd > 28< / kbd >
< kbd > 32< / kbd >
< kbd > 40< / kbd >
< kbd > 48< / kbd >
< kbd > 56< / kbd >
< kbd > 64< / kbd >
< kbd > 72< / kbd >
< kbd > 80< / kbd >
< kbd > 88< / kbd >
< kbd > 96< / kbd >
#### Colors
2020-08-11 23:36:17 -04:00
![#13A3F5 ](https://imgur.com/m0JhD7W.png )
![#4DCB2C ](https://imgur.com/wtyqDHv.png )
![#FED103 ](https://imgur.com/5km5GW6.png )
![#FE9D0C ](https://imgur.com/Gx2eGbm.png )
![#F2493C ](https://imgur.com/hl22EPB.png )
![#B75DCC ](https://imgur.com/wev8rfw.png )
![#000000 ](https://imgur.com/24cocpe.png )
![#fffff ](https://imgur.com/YyhMKNT.png )
2020-08-11 07:48:57 -04:00
2020-08-09 08:31:53 -04:00
#### Quick install
2020-10-23 02:39:24 -04:00
< p align = "center" >
< a href = "https://www.pling.com/p/1408466/" >
< img title = "Bibata Pling Store" width = "40%" src = "https://imgur.com/VxSgrWw.png" >
< / a >
< / p >
2020-08-09 08:31:53 -04:00
2020-08-11 08:00:57 -04:00
### Manual Install
2020-08-11 07:48:57 -04:00
#### Linux/X11
<!-- Install Video -->
<!-- <p align="center">
< video src = "https://i.imgur.com/zIF1JkH.mp4" width = "75%" autoplay loop preload > < / video >
< / p > -->
```bash
2020-08-30 07:54:08 -04:00
# extract `macOSBigSur.tar.gz`
tar -xvf macOSBigSur.tar.gz
2020-08-12 07:01:03 -04:00
2020-08-11 07:48:57 -04:00
# For local users
mv macOSBigSur ~/.icons/
2020-08-12 07:01:03 -04:00
2020-08-11 07:48:57 -04:00
# For all users
sudo mv macOSBigSur /usr/share/icons/
```
2020-08-10 02:29:18 -04:00
#### Windows
1. unzip `macOSBigSur_Windows.zip` file
2. Open `macOSBigSur_Windows/` in Explorer, and **right click** on `install.inf` .
2020-10-23 02:39:24 -04:00
3. Click 'Install' from the context menu, and authorize the modifications to your system.
4. Open _Control Panel > Personalization and Appearance > Change mouse pointers_ , and select **MacOSBigSur Cursors** .
2020-08-10 02:29:18 -04:00
5. Click '**Apply**'.
2020-08-07 09:08:30 -04:00
#### Preview:
2020-10-01 00:38:10 -04:00
> Detailed Cursors Informations inside [src/svgs/README.md](https://github.com/ful1e5/apple_cursor/blob/main/src/svg/README.md)
2020-08-08 00:20:09 -04:00
2020-08-07 09:04:59 -04:00
<!-- Preview -->
< p align = "center" >
2020-08-07 09:08:30 -04:00
< img title = "macOS Big Sur" src = "https://imgur.com/BA0gkrO.png" >
2020-08-07 09:04:59 -04:00
< / br >
2020-08-11 08:02:20 -04:00
< sub > macOSBigSur Cursors 🍎< / sub >
2020-08-07 09:04:59 -04:00
< / p >
2020-08-06 08:30:49 -04:00
<!-- Build Dependencies -->
2020-08-06 09:03:32 -04:00
# Dependencies
2020-08-06 08:30:49 -04:00
2020-08-06 08:45:14 -04:00
## Runtime Dependencies
- libxcursor-dev
- libx11-dev
- libpng-dev (< =1.6)
2020-08-06 09:03:01 -04:00
#### Install Runtime Dependencies
2020-08-06 08:45:14 -04:00
2020-08-12 00:37:15 -04:00
##### macOS
```bash
brew cask install xquartz libpng
```
2020-08-06 08:45:14 -04:00
##### Debain/ubuntu
```bash
2020-08-12 00:37:15 -04:00
sudo apt install libx11-dev libxcursor-dev libpng-dev
2020-08-06 08:45:14 -04:00
```
##### ArchLinux/Manjaro
```bash
2020-08-12 00:37:15 -04:00
sudo pacman -S libx11 libxcursor libpng
2020-08-06 08:45:14 -04:00
```
##### Fedora/Fedora Silverblue/CentOS/RHEL
```bash
2020-08-12 00:37:15 -04:00
sudo dnf install libx11-devel libxcursor-devel libpng-devel
2020-08-06 08:45:14 -04:00
```
2020-08-06 09:10:07 -04:00
2020-08-07 00:26:57 -04:00
## Build Dependencies
2020-08-06 09:10:07 -04:00
2020-08-12 00:37:15 -04:00
- [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 )
2020-08-30 02:06:56 -04:00
- [@types/pngjs ](https://www.npmjs.com/package/@types/pngjs )
- [@types/pixelmatch ](https://www.npmjs.com/package/@types/pixelmatch )
2020-08-12 00:37:15 -04:00
- [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 )
2020-08-30 02:06:56 -04:00
- [pngjs ](https://www.npmjs.com/package/pngjs )
- [pixelmatch ](https://www.npmjs.com/package/pixelmatch )
2020-08-12 00:37:15 -04:00
### PyPi Packages
- [clickgen ](https://pypi.org/project/clickgen/s )
- [Pillow ](https://pypi.org/project/Pillow/ )
2020-08-07 01:08:37 -04:00
2020-08-11 07:22:42 -04:00
## Build From Scratch
2020-08-07 08:41:30 -04:00
### ⚡ Auto Build (using GitHub Actions)
2020-10-01 00:38:10 -04:00
GitHub Actions is automatically runs on every `push` (on **main** and **dev** branches) and `pull request` (on **main** branch), You found theme resources in `artifact` section of **build** .GitHub **Actions** available inside [.github/workflows ](https://github.com/ful1e5/apple_cursor/tree/main/.github/workflows ) directory.
2020-08-07 08:41:30 -04:00
2020-08-11 07:22:42 -04:00
### Manual Build
2020-08-07 08:41:30 -04:00
2020-08-12 01:32:47 -04:00
#### Setup python environment
```bash
2020-08-12 07:01:03 -04:00
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
2020-08-12 01:32:47 -04:00
# For Deactivate virtualenv
deactivate
```
#### Compile From Source
2020-08-12 01:46:50 -04:00
> Make sure your [python environment](#setup-python-environment) setup and `virtualenv` is **active**.
2020-08-12 01:32:47 -04:00
##### Using yarn
```bash
2020-08-12 07:01:03 -04:00
yarn install # Install all Node Packages
yarn py_install # Install all PyPi Packages
yarn compile # Compile the cursor theme
2020-08-12 01:32:47 -04:00
```
##### Using npm
2020-08-07 08:41:30 -04:00
```bash
2020-08-12 07:01:03 -04:00
npm install # Install all Node Packages
npm py_install # Install all PyPi Packages
npm compile # Compile the cursor theme
2020-08-07 08:41:30 -04:00
```
2020-08-26 02:32:23 -04:00
After build `bitmaps` and `themes` directory are generated at project **root** .
2020-08-07 08:41:30 -04:00
2020-08-11 07:22:42 -04:00
### Install Build Theme
2020-08-10 02:29:18 -04:00
2020-08-26 02:32:23 -04:00
All builded cursor themes are available inside `themes` directory.
2020-08-07 08:41:30 -04:00
2020-08-11 07:22:42 -04:00
#### Linux
2020-08-07 08:41:30 -04:00
```bash
2020-08-26 02:32:23 -04:00
cd ./themes
2020-08-12 01:42:54 -04:00
rm -rf ~/.icons/macOSBigSur & & cp macOSBigSur ~/.icons/ # installing Theme to local user(recommend)
2020-08-07 08:41:30 -04:00
```
2020-08-07 09:04:59 -04:00
2020-08-10 02:29:18 -04:00
#### Windows
1. unzip `macOSBigSur_Windows.zip` file
2. Open the `settings` app.
3. **Goto** `Devices` -> `Mouse` -> `Additional Mouse Options` .
4. **Goto** the `pointers` tab.
2020-08-12 01:42:54 -04:00
5. Replace each cursor in the currently applied cursor set with the corresponding cursor in the `macOSBigSur_Windows` folder.
2020-08-10 02:29:18 -04:00
6. Click "**save as**" and type in the desired name.
7. Click "**apply**" and "**ok**".
2020-08-07 09:04:59 -04:00
<!-- Bug Report -->
# Bugs
Bugs 🐛 should be reported [here ](https://github.com/ful1e5/apple_cursor/issues ) on the Github issues page.
<!-- Help -->
# Getting Help
You can create a **issue** , I will help you. 🙂
2020-08-07 23:08:21 -04:00
<!-- Contributions and Suggestion -->
2020-08-11 04:31:28 -04:00
# Contributing
2020-08-07 23:08:21 -04:00
2020-08-11 07:03:04 -04:00
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` .
2020-08-07 23:08:21 -04:00
2020-08-07 09:04:59 -04:00
<!-- Support -->
## Support
Give a ** ★** or Follow on [GitHub ](https://github.com/ful1e5 ),That's work as **Steroid 💉** for me. 😉
> For more support
< a href = "https://www.buymeacoffee.com/Nt7Wg4V" target = "_blank" >
2020-08-08 08:37:54 -04:00
< img src = "https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt = "Buy Me A Coffee" style = "height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" >
2020-08-07 09:04:59 -04:00
< / a >
<!-- Ninja -->
< h1 align = "center" >
( `ω´ )۶▬ι═══════ﺤ
< / h1 >
2020-08-07 22:31:57 -04:00
< p align = "center" >
< sub > I'm Using Katana < / sub >
< / p >