---
Table of Contents (click to expand)
- [Bibata Cursor](#bibata-?)
- [Cursor Sizes](#cursor-sizes)
- [Colors](#colors)
- [Quick Install For Linux](#quick-install)
- [ArchLinux/Manjaro Package](#arch-linux/manjaro)
- [Fedora Package](#fedora)
- [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](#compile-from-source)
- [Install Build Theme](#install-build-theme)
- [Bugs](#bugs)
- [Getting Help](#getting-help)
- [Contributors](./CONTRIBUTING.md#contributors)
- [Support β¨](#support)
## Bibata ?
Bibata is **OpenSource**, Compact and Material Designed Cursor set. This project masterelop for improve `Cursor` Experience.
- **Bibata Amber :** Yellowish Theme.
- **Bibata Classic :** Solid Black Theme.
- **Bibata Ice :** Light Theme.
#### Bibata Styles
- **Bibata Original :** Sharp edge Bibata Cursors
- **Bibata Modern :** Round edge Bibata Cursors
#### Cursor Sizes
2428324048566472808896
#### Colors
#### Quick install
##### via curl
```bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/KaizIqbal/Bibata_Cursor/master/Bibata.sh)"
```
##### via wget
```bash
sh -c "$(wget -O- https://raw.githubusercontent.com/KaizIqbal/Bibata_Cursor/master/Bibata.sh)"
```
### Packages π¦
> **πNote**: If you're having trouble with the packages please submit a request to the package maintainer before creating an issue.
#### Arch Linux/Manjaro
Arch Linux/Manjaro users can install from the [AUR](https://aur.archlinux.org/packages/bibata-cursor-theme) currently maintained by [_@Shatur_](https://aur.archlinux.org/packages/?K=Shatur&SeB=m). Can be installed via Pamac (preinstalled in Manjaro), Yay or any other [AUR helper](https://wiki.archlinux.org/index.php/AUR_helpers).
Pamac command:
```bash
pamac install bibata-cursor-theme
```
Yay command:
```bash
yay -S bibata-cursor-theme
```
#### Fedora
Fedora users can install from the [copr-repo](https://copr.fedorainfracloud.org/coprs/muhalantabli/copr-repo) currently maintained by _@muhalantabli_.
Enable the repo:
```bash
sudo dnf copr enable muhalantabli/copr-repo
```
Installation command:
```bash
sudo dnf install bibata-cursor-theme
```
### Manual Install
Latest `Stable` & `Development` releases can be downloaded from [Here](https://github.com/ful1e5/Bibata_Cursor/releases)
#### Linux/X11
```bash
# extract `Bibata.tar.gz`
tar -xvf Bibata.tar.gz
# For local users
mv Bibata_* ~/.icons/
# For all users
sudo mv Bibata_* /usr/share/icons/
```
#### Windows
1. unzip `Bibata_Windows.zip` file
2. Open `Bibata_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 **Bibata Cursors**.
5. Click '**Apply**'.
## Preview
Bibata Amber
Bibata Classic
Bibata Ice
# 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/)
- [python3](https://www.python.org/downloads/)
- [pip3](https://pip.pypa.io/en/stable/installing/)
### Node Packages
- [puppeteer](https://www.npmjs.com/package/puppeteer)
- [pngjs](https://www.npmjs.com/package/pngjs)
- [pixelmatch](https://www.npmjs.com/package/pixelmatch)
- [ora](https://www.npmjs.com/package/ora)
- [chalk](https://www.npmjs.com/package/chalk)
### PyPi Packages
- [clickgen](https://pypi.org/project/clickgen/)
## 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/Bibata_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**.
#### Install Node/PyPi Packages
```bash
yarn install # Install all Node Packages
yarn py_install # Install all PyPi Packages
```
#### Build Bibata
```bash
yarn render:bibata-modern # Render Bibata Modern Bitmaps
yarn render:bibata-original # Render Bibata Original Bitmaps
yarn build # Build Windows & Linux packages
```
#### Build Bibata Modern Only
```bash
yarn render:bibata-modern # Render Bibata Modern Bitmaps
yarn build # Build Windows & Linux packages
```
#### Build Bibata Original Only
```bash
yarn render:bibata-original # Render Bibata Original Bitmaps
yarn build # Build Windows & Linux packages
```
After build `bitmaps` and `themes` directory are generated at project **root**.
### Install Build Theme
All builded cursor themes are available inside `themes` directory.
#### Linux
```bash
cd ./themes
# installing Theme to local user(recommend)
rm -rf ~/.icons/Bibata_* && cp -r Bibata_* ~/.icons/
```
#### Windows
1. Open the `settings` app.
2. **Goto** `Devices` -> `Mouse` -> `Additional Mouse Options`.
3. **Goto** the `pointers` tab.
4. Replace each cursor in the currently applied cursor set with the corresponding cursor in the `./themes/` folder.
5. Click "**save as**" and type in the desired name.
6. Click "**apply**" and "**ok**".
## You may also like...
- [**Bibata Extra**](https://github.com/KaizIqbal/Bibata_Extra_Cursor) - More Bibata!
- [**Bibata Adapta**](https://gitlab.com/cscs/Bibata_AdaptaBreath_Cursors) - Bibata Based Cursor Made for AdaptaBreath and Manjaro.
- [**Bibata Translucent**](https://github.com/Silicasandwhich/Bibata_Cursor_Translucent) - Bibata translucent is a translucent flavor of the Bibata.
# 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`.
## Credit
- [Adwaita](https://github.com/GNOME/adwaita-icon-theme)
- [Dmz](https://github.com/GalliumOS/dmz-cursor-theme)
- [Yaru](https://github.com/ubuntu/yaru)
- Emojis are taken from [here](https://emojipedia.org/)
## Support
Share your joy with **β **.
> For more support
Bibata Amber
Bibata Classic
Bibata Ice
