View On GitHub Download .zip Download .tar.gz Download Binary (.deb)
## Features and Screenshots Coming soon or create a Pull Request. ### Sample Screenshot ## 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) ## Dependencies ``` debhelper-compat (= 13) dh-migrations libglib2.0-dev meson (>= 0.60) sassc python3 ``` ### Debian/Ubuntu based distro ``` sudo apt install debhelper libglib2.0-dev \ meson sassc python3 ``` ### 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, the icon 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-theme-icon/archive/refs/heads/master.zip unzip master.zip cd sucharu-theme-icon-master ``` 1. **Option 1:** Manually copying necessary files to root (`/`). For that, follow the steps below: 1. To build the **icon** themes, run meson as: ``` rm -rf builddir meson builddir meson compile -C builddir meson install -C builddir ``` from the `/path/to/repo` in a terminal. It will install the **icon** themes in `/usr/share/icons` for all users. 2. To avoid using `sudo` and install the themes for single user: ``` rm -rf builddir meson -Dprefix=$HOME/.local builddir meson compile -C builddir meson install -C builddir ``` from the `/path/to/repo` in a terminal. It will install the **icon** themes in `/home/{localuser}/.local/share/icons` for the user **localuser**. 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-icon*.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) to change themes automatically at certain interval. ### 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 1. Scalable icons: To add a new scalable icon, 1. put the **svg** in `icons/src/scalable/_variant_/_context_/` directory. Where `_variant_` is either **default** or **dark**. 2. Run `render-symbolic-icons.sh` from `icons/src/scalable/` 3. Copy the reduced **svg** from `icons/Sucharu{_variant_}/scalable/_context_/` to `icons/src/scalable/_variant_/_context_/` 2. Fullcolor icons: To add a new Fullcolor icon, 1. put the **svg** in `icons/src/fullcolor/default/_context_/` directory. 2. Run `render-bitmaps.py new-icon.svg` from `icons/src/fullcolor/` to generate the **png** files in `icons/Sucharu/PxP/_context_/`. ## User Manual Coming soon or create a Pull Request. ## 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-theme-icon/issues/new/choose) 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-theme-icon/compare). ## Contributors ### [Himadri Sekhar Basu](https://hsbasu.github.io) 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:
