Bibata_Cursor/README.md

309 lines
9.4 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>
2019-12-22 07:02:56 -05:00
<img src="./image/Bibata_name.png" width="150">
2019-11-12 23:48:09 -05:00
</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="#">
2019-11-15 11:10:26 -05:00
<img alt="Chat" src="https://img.shields.io/badge/chat-on discord-purple">
2019-11-12 23:48:09 -05:00
</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-19 04:55:45 -05:00
<img alt="Travis CI" src="https://travis-ci.org/KaizIqbal/Bibata_Cursor.svg?branch=master">
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>
2019-11-18 02:27:35 -05:00
<br>
<a href="https://twitter.com/ful1e5_" target="_blank">
<img alt="Twitter Follow" src="https://img.shields.io/twitter/follow/ful1e5_?label=twitter&style=social">
</a>
<a href="https://github.com/KaizIqbal" target="_blank">
<img alt="GitHub followers" src="https://img.shields.io/github/followers/KaizIqbal?label=Github&style=social">
</a>
<a href="https://mastodon.social/web/accounts/580173" target="_blank">
<img alt="Mastodon Follow" src="https://img.shields.io/mastodon/follow/580173?domain=https%3A%2F%2Fmastodon.social&label=Mastodon&style=social">
</a>
2019-11-12 23:48:09 -05:00
</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/)
2019-12-22 01:59:30 -05:00
- [pip](https://pypi.org/project/pip/)/[python-pillow](https://www.archlinux.org/packages/community/x86_64/python-pillow/)
2019-11-12 23:48:09 -05:00
- [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-12-22 01:59:30 -05:00
**📝Note**: Snap/Flatpak packages raise issue in build(e.g. inkscape).
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
```
2019-11-17 05:55:00 -05:00
sudo apt install git python3 python3-pip inkscape x11-apps
2019-11-12 23:48:09 -05:00
```
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
```
2019-11-16 23:46:29 -05:00
sudo dnf install git python37 python3-pip inkscape xcursorgen
2019-11-12 23:48:09 -05:00
```
2018-09-03 07:38:53 -04:00
2019-12-22 01:59:30 -05:00
##### ArchLinux
2018-09-03 07:38:53 -04:00
2019-11-12 23:48:09 -05:00
```
2019-12-22 01:59:30 -05:00
# Packages
sudo pacman -S git python inkscape xorg-xcursorgen
# AUR package with yaourt
yaourt -S python-pillow
2019-11-12 23:48:09 -05:00
```
2018-09-03 07:38:53 -04:00
2019-12-22 01:59:30 -05:00
##### Manjaro
**📝Note**: enable AUR in ManjaroLinux for [python-pillow](https://www.archlinux.org/packages/community/x86_64/python-pillow/)
```
pamac install git python python-pillow inkscape xorg-xcursorgen
```
Install `python-pip` package in case python-pillow cause error or not installed on your arch based distro.
```
# Archlinux
sudo pacman -S python-pip
# Manjaro
pamac python-pip
```
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
2019-11-19 04:55:45 -05:00
sh -c "$(curl -fsSL https://raw.githubusercontent.com/KaizIqbal/Bibata_Cursor/master/Bibata.sh)"
2019-11-13 23:13:32 -05:00
```
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
2019-11-19 04:55:45 -05:00
sh -c "$(wget -O- https://raw.githubusercontent.com/KaizIqbal/Bibata_Cursor/master/Bibata.sh)"
2019-11-13 23:13:32 -05:00
```
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">
2019-12-27 07:31:10 -05:00
</br><sub>Bibata Classic</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-15 11:27:14 -05:00
**Give a ❤️**
**OR**
2019-11-12 23:48:09 -05:00
<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>
2019-11-17 22:40:31 -05:00
<br><br>
2019-11-18 01:40:45 -05:00
<a href="https://www.patreon.com/bePatron?u=13184396" target="_blank">
<img src="https://c5.patreon.com/external/logo/become_a_patron_button@2x.png" alt="Patreon" width=174 height=41 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-18 01:38:06 -05:00
</a>
<br><br>
2019-11-18 01:40:45 -05:00
<a href="https://www.pling.com/p/1197198/" target="_blank">
<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-17 22:40:31 -05:00
</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>