# [Sucharu Themes](https://hsbasu.github.io/sucharu)
A theme package with mac-styled 3D title buttons and circular components.
## Download Latest Version
View On GitHub
Download Source (.zip)
Download Source (.tar.gz)
Download Cinnamon Shell Binary (.deb)
Download GNOME Shell Themes Binary (.deb)
Download GTK+ and Metacity Themes Binary (.deb)
Download Unity Themes Binary (.deb)
Download XFWM4 Themes Binary (.deb)
Download Plank Themes Binary (.deb)
Download Metapackage for All Themes Binary (.deb)
## Features and Screenshots
This package provides theme for components:
1. Gnome-shell
2. Cinnmon-shell
3. Gtk-2.0
4. Gtk-3.0
5. Gtk-4.0
6. Metacity
7. Xfwm
8. Plank
This theme is based on [Yaru](https://github.com/ubuntu/yaru) and [Mint-Y](https://github.com/linuxmint/mint-themes) themes.
## Contents
- [Download Latest Version](#download-latest-version)
- [Features and Screenshots](#features-and-screenshots)
- [Dependencies](#dependencies)
- [Debian/Ubuntu based systems](#debianubuntu-based-distro)
- [Other Linux-based systems](#other-linux-based-distro)
- [Installation](#build-and-install-the-latest-version)
- [Debian/Ubuntu based systems](#debianubuntu-based-systems)
- [Other Linux-based systems](#other-linux-based-systems)
- [For Developers](#for-developers)
- [User Manual](#user-manual)
- [Issue Tracking and Contributing](#issue-tracking-and-contributing)
- [Contributors](#contributors)
- [Authors](#author)
## Dependencies
```
debhelper ( >= 13 )
gnome-themes-standard
gtk2-engines-murrine
gtk2-engines-pixbuf
inkscape
python3
sassc
meson ( >= 0.60 )
```
### Debian/Ubuntu based distro
To install dependencies on Debian/Ubuntu based systems, run:
```
sudo apt install debhelper gnome-themes-standard gtk2-engines-murrine \
gtk2-engines-pixbuf inkscape python3 sassc meson
```
### Other Linux-based distro
Remove `apt install` and the `debhelper` package in the command given in [Debian/Ubuntu based distros](#debianubuntu-based-distro) and use the command for the package manager of the target system(eg. `yum install`, `dnf install`, `pacman -S` etc.)
**Note**: There might be cases where one or more dependencies might not be available for your system. But that is highly unlikely. In such situations, please [create an issue](#issue-tracking-and-contributing).
## Build and Install the Latest Version
### Debian/Ubuntu based systems
There are two methods, these themes can be installed/used on a Debian/Ubuntu based system. First, download and unzip the source package using:
```
wget https://github.com/mamolinux/sucharu/archive/refs/heads/master.zip
unzip master.zip
cd sucharu-master
```
1. **Option 1:** Manually copying necessary files to root (`/`). For that, follow the steps below:
1. To build the themes, run:
```
make clean
make all
```
from the `/path/to/repo` in a terminal. It will create the **GTK**, **Metacity**, **XFWM** and **Cinnamon** themes in `usr/share/themes`, and **Plank themes** in `usr/share/plank/themes`.
2. Copy the contents of `usr/` to `/usr/`:
```
sudo cp -R usr /
```
3. To build **gnome-shell**, use meson as,
```
meson builddir
meson compile -C builddir
meson install -C builddir
```
2. **Option 2:** Build debian packages and install it. To build a debian package on your own:
1. from the `/path/to/repo` run:
```
dpkg-buildpackage --no-sign
```
This will create `sucharu-theme*.deb` packages at `../path/to/repo`.
2. Install the debian packages using
```
sudo dpkg -i *.deb
sudo apt install -f
```
After it is installed, set the themes from your distro's theme manager or use the [Theme Manager](https://hsbasu.github.io/theme-manager).
### Other Linux-based systems
1. Install the [dependencies](#other-linux-based-distro).
2. From instructions for [Debian/Ubuntu based systems](#debianubuntu-based-systems), follow **Option 1**.
### For Developers
Coming Soon or create a PR.
## User Manual
Coming Soon or create a PR.
## Issue Tracking and Contributing
If you are interested to contribute and enrich the code, you are most welcome. You can do it by:
1. If you find a bug, to open a new issue with details: [Click Here](https://github.com/mamolinux/sucharu/issues)
2. If you know how to fix a bug or want to add new feature/documentation to the existing package, please create a [Pull Request](https://github.com/mamolinux/sucharu/compare).
## Contributors
### Author
[Himadri Sekhar Basu](https://github.com/hsbasu) is the author and current maintainer.
## Donations
I am a freelance programmer. So, If you like this app and would like to offer me a coffee ( ☕ ) to motivate me further, you can do so via:
