Bibata_Cursor/README.md

267 lines
7.8 KiB
Markdown
Raw Normal View History

2019-11-12 23:48:09 -05:00
<h1 align="center">
<img src="./image/Bibata.png" width="150">
<br>
Bibata Cursor
</h1>
<h4 align="center">🚀 Material Based Cursor 🏳️‍🌈</h4>
<p align="center">
<img alt="Downloads" src="https://img.shields.io/github/downloads/KaizIqbal/Bibata_Cursor/total">
<img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/KaizIqbal/Bibata_Cursor">
<!-- <a href="#">
<img alt="Chat" src="https://img.shields.io/badge/chat-on slack-yellow">
</a> -->
<img alt="GitHub" src="https://img.shields.io/github/license/KaizIqbal/Bibata_Cursor">
<br>
<img alt="GitHub contributors" src="https://img.shields.io/github/contributors/KaizIqbal/Bibata_Cursor">
<img alt="GitHub issues" src="https://img.shields.io/github/issues/KaizIqbal/Bibata_Cursor">
<img alt="Issues & PR" src="https://img.shields.io/badge/Issues & PR-welcome-green">
<br>
2019-11-13 23:13:32 -05:00
<a href="https://github.com/KaizIqbal/Bibata_Cursor/releases" target="_blank">
<img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/KaizIqbal/Bibata_Cursor">
</a>
2019-11-12 23:48:09 -05:00
<a href="https://aur.archlinux.org/packages/bibata-cursor-theme" target="_blank">
<img alt="AUR version" src="https://img.shields.io/aur/version/bibata-cursor-theme">
2018-10-21 10:13:55 -04:00
</a>
2019-11-12 23:48:09 -05:00
<a href="https://www.paypal.me/KaizKhatri" target="_blank">
<img alt="Donate" src="https://img.shields.io/badge/$-donate-red">
</a>
</p>
2018-10-21 10:28:46 -04:00
2019-11-12 23:48:09 -05:00
<p align="center">
<a href="#bibata-?">Bibata</a>
2019-11-13 23:13:32 -05:00
<a href="#install">Install</a>
2019-11-13 23:16:30 -05:00
<a href="#windows">Windows</a>
2019-11-12 23:48:09 -05:00
<a href="#preview">Preview</a>
<a href="./CONTRIBUTING.md#Contributors" target="_blank">Contributors</a>
<a href="#credit">Credit</a>
2019-11-14 03:37:20 -05:00
<a href="#support">Support</a>
2019-11-12 23:48:09 -05:00
<a href="https://github.com/KaizIqbal/Bibata_Cursor/blob/master/LICENSE">License</a>
</p>
2018-10-13 03:51:42 -04:00
2019-11-12 23:48:09 -05:00
## Bibata ?
2018-10-13 03:51:42 -04:00
2019-11-12 23:48:09 -05:00
Bibata is **OpenSource** ,Compact and Material Designed Cursor set.This project masterelop for improve `Cursor` Experience.
2018-10-21 10:28:46 -04:00
2019-11-12 23:48:09 -05:00
### Build dependencies
2018-10-21 10:25:24 -04:00
2019-11-12 23:48:09 -05:00
- [git](https://git-scm.com/)
- [python3](https://www.python.org/)
- [pip](https://pypi.org/project/pip/)
- [Inkscape](https://inkscape.org/)
- [Xcursorgen](https://www.x.org/releases/X11R7.7/doc/man/man1/xcursorgen.1.xhtml)
2018-10-21 10:25:24 -04:00
2019-11-12 23:48:09 -05:00
### Install dependencies
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
##### Debain/Ubuntu
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
```
sudo apt install git python3 python3-pip git inkscape xcursorgen
```
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
##### Fedora
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
```
sudo dnf install git python37 python3-pip git inkscape xcursorgen
```
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
##### ArchLinux/Manjaro
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
```
sudo pacman -S git python python-pip git inkscape xorg-xcursorgen
```
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
**📝Note**: Snap/Flatpak packages raise issue in build(e.g. inkscape).
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
## Install
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
### Basic Installation
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
Bibata cursor is installed by running one of the following commands in your terminal. You can install this via the command-line with either `curl` or `wget`.
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
##### via curl
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
```shell
sh -c "$(curl -fsSL https://raw.githubusercontent.com/KaizIqbal/Bibata_Cursor/devlopment/Bibata.sh)"
```
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
##### via wget
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
```shell
sh -c "$(wget -O- https://raw.githubusercontent.com/KaizIqbal/Bibata_Cursor/devlopment/Bibata.sh)"
```
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
Latest `Stable` & `Development` releases can be downloaded from [Here](https://github.com/KaizIqbal/Bibata_Cursor/releases)
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
### Packages📦
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
**📝Note**: If you're having trouble with the packages please submit a request to the package maintainer before creating an issue.
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
#### Archlinux
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
Arch Linux 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).
Arch Linux users can install the theme collection from the AUR repository by using the yaourt or packer commands below.
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
Yaourt commands:
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
```
yaourt -S bibata-cursor-theme
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
```
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
Packer commands:
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
```
packer -S bibata-cursor-theme
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
```
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
#### Fedora
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
Fedora users can install from the [copr-repo](https://copr.fedorainfracloud.org/coprs/muhalantabli/copr-repo/) currently maintained by _@muhalantabli_.
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
enable the repo:
```
sudo dnf copr enable muhalantabli/copr-repo
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
```
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
installation commands:
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
```
sudo dnf install bibata-cursor-theme
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
```
#### Manjaro linux
Pamac commands:
```
pamac install bibata-cursor-theme
```
<!--
From https://github.com/Silicasandwhich/Bibata_Cursor_Translucent#windows -->
#### Windows
1. Get the lastest stable/dev-version Windows release from the [releases tab](https://github.com/KaizIqbal/Bibata_Cursor/releases) on the github page.
2. Open the settings app
3. Go to Devices -> Mouse -> Additional Mouse Options
4. Go to the pointers tab
5. Replace each cursor in the currently applied cursor set with the corresponding cursor in the Windows folder of your desired flavor
6. Click "save as" and type in the desired name
7. Click "apply" and "ok"
### Manual Installation
1. Make sure you have installed all [Build dependencies](#build-dependencies).
2018-09-03 07:38:53 -04:00
2019-11-13 23:13:32 -05:00
2. Build & Install:
```shell
git clone https://github.com/KaizIqbal/Bibata_Cursor.git
cd Bibata_Cursor/
chmod +x build.sh
./build.sh
chmod +x ./install.sh
```
Install (available for all users)
```shell
sudo ./install.sh
```
Install (available only for local eser)
```
./install.sh
2019-10-20 06:14:35 -04:00
```
2019-11-13 23:13:32 -05:00
3. Uninstall:
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
Using `Script` :
2019-11-12 23:48:09 -05:00
2019-11-13 23:13:32 -05:00
```shell
#From All Users
sudo ./install.sh
#From Local User
./install.sh
2019-10-20 06:14:35 -04:00
```
2019-11-13 23:13:32 -05:00
Without `Script` :
```shell
#From All Users
$sudo rm -r /usr/share/icons/Bibata_*
#from Local User
$rm -r ~/.icons/Bibata_*
#Note : Your replace * with flavor Name to remove individual
2019-10-20 06:14:35 -04:00
```
2018-09-03 07:38:53 -04:00
2019-11-13 00:01:11 -05:00
More information about script is found in [src](./src/README.md) directory.
2019-11-12 23:48:09 -05:00
## Preview
2018-10-13 03:51:42 -04:00
2019-11-12 23:48:09 -05:00
<p align="center"><img title="Bibata Classic" src="./image/Bibata_Classic.png">
</br><sub>Bibata Oil</sub></p>
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
<p align="center"><img title="Bibata Oil" src="./image/Bibata_Oil.png">
</br><sub>Bibata Oil</sub></p>
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
<p align="center"><img title="Bibata Ice" src="./image/Bibata_Ice.png">
2018-09-03 07:38:53 -04:00
</br><sub>Bibata Ice</sub></p>
2019-11-12 23:48:09 -05:00
<p align="center"><img title="Bibata Amber" src="./image/Bibata_Amber.png">
2018-09-03 07:38:53 -04:00
</br><sub>Bibata Amber</sub></p>
2019-11-12 23:48:09 -05:00
## 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.
2018-09-03 07:38:53 -04:00
## Bugs
Bugs should be reported [here](https://github.com/KaizIqbal/Bibata_Cursor/issues) on the Github issues page.
## Getting help
You can create a issue, I will help you.
2018-09-03 07:54:47 -04:00
## Contributions and Suggestions
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
<a href="https://github.com/KaizIqbal/Bibata_Cursor/graphs/contributors">
<img alt="GitHub contributors" src="https://img.shields.io/github/contributors/KaizIqbal/Bibata_Cursor?style=social">
</a>
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05: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`.
2018-09-03 07:38:53 -04:00
###
2019-11-12 23:48:09 -05:00
## Credit
2018-10-21 10:13:55 -04:00
2019-11-12 23:48:09 -05:00
- [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/)
2019-10-20 06:14:35 -04:00
2019-11-14 03:37:20 -05:00
## Support
2018-10-15 11:40:03 -04:00
2019-11-12 23:48:09 -05:00
<a href="https://www.pling.com/p/1197198/" target="_blank">
2019-11-13 00:31:37 -05:00
<img src="https://www.pling.com/images_sys/store_pling/pling-logo.png" alt="Pling" width="150" height="81" style="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;">
2019-11-12 23:48:09 -05:00
</a>
<br><br>
<a href="https://www.buymeacoffee.com/Nt7Wg4V" target="_blank">
<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;" >
</a>
2018-10-15 11:40:03 -04:00
2019-11-12 23:48:09 -05:00
<p align="center">
<h1 align="center">.^.</h1>
2018-09-03 07:38:53 -04:00
</p>