01. Overview & Architecture

Profile: 26.02.21
Schema validatedSource pinned
Purpose
Classic circular application icon theme.
Compatibility
Any distro (Server: BOTH)
Desktop Part
Icon themes
Window Manager & Theme
Any WM / DE / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: numix-circle-icon-theme-git (some from the Arch AUR)
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/numixproject/numix-icon-theme-circle ~/0xtsoa-review/numixproject-numix-icon-theme-circle# 1. clone to a review folder
$git -C ~/0xtsoa-review/numixproject-numix-icon-theme-circle checkout --detach 6d4a4aad60994e688ab9dc8f021cb4ec86e9e532# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Install numix-circle-icon-theme-git (AUR)
$yay -S numix-circle-icon-theme-git # AUR
$# Other distros: see the upstream README
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/numixproject/numix-icon-theme-circle/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // Numix Circle

Capture 01 // Fullscreen
Circle Screenshot
01 / 05

04. Documentation & Guide

README.md|GitHub Flavored Markdown

Numix Circle

Circle is an app icon theme for Linux from the Numix project intended to be used on top of our base icon theme. This readme provides information on installation, icon requests and hardcoded icons. Licensed under the GPL-3.0+

Circle Screenshot

Install

If using this with our base icon theme make sure you install both parts using the same method. This makes sure that the panel icons keep working as intended.

Distro Packages

If you use Fedora, Debian, Ubuntu, Gentoo or any of their derivatives then you're sorted! Numix Circle is available from the official repositories.

Distro Install Command
Fedora sudo dnf install numix-icon-theme-circle
Debian Ubuntu sudo apt install numix-icon-theme-circle
Gentoo sudo emerge -a numix-icon-theme-circle

Nightly Packages

If you use Ubuntu or any of its derivatives (including Mint and elementary OS) you can use our Numix PPA to get the very latest version of the theme. Fire up a Terminal and run the following:

sudo add-apt-repository ppa:numix/ppa
sudo apt update
sudo apt install numix-icon-theme-circle

For Arch users there's a community maintained package in the AUR which builds from this GitHub.

For Gentoo users there's a community maintained ebuild in the edgets overlay which builds icons directly from numix-core repository, so you receive latest commits.

Issues & Requests

The tracker for this repo is only for issues relating to the Linux packaging. Please make icon requests here using the relevant template. When filing your request please be respectful, patient, and remember that development is done solely by volunteers.

Hardcoded Icons

To deal with hardcoded application icons Numix uses the hardcode-fixer script. A list of the applications supported by the script can be found here.

Runtime Steam Icons

To fix icons of running Steam games, you can use Steam Icons Fixer script which will connect all icons available from our icon theme with your installed games.

GitHub Flavored Markdown (github-markdown-css)README snapshot at 6d4a4aad60