# NeonIcons 🌟

**NeonIcons** is a minimalist, filter-free neon icon theme designed for Linux desktops including **Linux Mint**, **Cinnamon**, **XFCE / Thunar**, **Puppy Linux / ROX-Filer**, **GNOME**, and **KDE Plasma**.

---

## ✨ Features

### 🎨 1. Filter-Free Double-Layer Neon Design
- **100% Filter-Free:** Built without any `<filter>` or `<feGaussianBlur>` elements to guarantee complete compatibility across all X11 and Wayland compositors (Compiz, KWin, XFWM, IceWM, ROX).
- **Double-Layer Glow Technique:**
  - **Outer Layer:** Wide semi-transparent glowing stroke (`stroke-width="8" opacity="0.3"`).
  - **Core Layer:** Sharp, clean neon inner line (`stroke-width="3"`).
- **Strict 3-Color Neon Palette:**
  - 🩵 **Cyan (`#00f3ff`):** Primary frames, window borders & structures
  - 🩷 **Magenta (`#ff007f`):** Functional highlights, flap lines, connectors
  - 💛 **Yellow (`#ffb703`):** Center accents, pointers, indicators & badges

---

### 🖥️ 2. Cross-Desktop & File Manager Compatibility
- **GTK File Managers:** Native support for Thunar (XFCE), Nemo (Cinnamon), and Nautilus (GNOME).
- **KDE Plasma:** Incorporates `breeze` inheritance for Dolphin, KRunner, Spectacle, and KDE System Settings.
- **Lightweight / Legacy Environments:** Full support for ROX-Filer (Puppy Linux, IceWM, Openbox) including `inode/directory` MIME mappings and underscore name variants (`application_x-yaml`, `application_x-abiword`).

---

### 📦 3. Comprehensive Icon Coverage

#### 🚀 Applications (`scalable/apps/`)
- **System Utilities:** Terminal, Thunar/Nemo, Browser/Firefox, Text Editor (Xed/Kate), Software Manager, System Settings, Media Player (Celluloid), Image Viewer (Pix/Gwenview), Calculator, System Monitor, Update Manager, Document Viewer, Email (Thunderbird), Music Player (Rhythmbox), Driver Manager.
- **KDE Plasma & GNOME Apps:** Dolphin, Konsole, Kate, KWrite, Spectacle, Gwenview, KRunner, Nautilus, GNOME Terminal, GNOME TextEditor, GNOME Calculator.

#### 📁 Folders & Special Places (`scalable/places/`)
- **Standard Folders:** Default Folder, Open Folder (`folder-open`).
- **XDG User Folders:** Home (`user-home`), Desktop (`user-desktop`), Documents (`folder-documents`), Downloads (`folder-downloads`), Music (`folder-music`), Pictures (`folder-pictures`), Videos (`folder-videos`), Templates (`folder-templates`), Public Share (`folder-publicshare`), Trash (`user-trash`).

#### 📄 Documents & MIME Types (`scalable/mimetypes/`)
- **LibreOffice & MS Office:** `.odt`, `.docx`, `.ods`, `.xlsx`, `.odp`, `.pptx`, `.odg`.
- **PDF Documents:** `.pdf` (`application-pdf`).
- **Archives & Compressed Files:** `.tar.gz`, `.zip`, `.7z`, `.rar`, `.tgz`, `.gz`.
- **Package Installers:** `.deb`, `.rpm`.
- **Source Code & Scripts:** Python (`.py`), Shell (`.sh`), m4 (`.m4`), CMake (`CMakeLists.txt`), Makefiles, HTML (`.html`, `.htm`), PO translations (`.po`), YAML (`.yaml`), INI/Config (`.ini`, `.rc`), AbiWord (`.abw`).
- **Zero-Size & Unknown Files:** Special handlers for $0\text{-byte}$ empty files (`application/x-zerosize`), binary streams (`application/octet-stream`), and unknown file fallbacks (`unknown.svg`).

#### 💽 Drives & Hardware Devices (`scalable/devices/`)
- **Storage & Media:** System Hard Disks, USB Flash Drives, Optical Discs (CD/DVD/Blu-ray), SD Cards, Network Drives, Computer/CPU.

#### 🔔 Status Indicators (`scalable/status/`)
- **System Tray:** Audio Volume (`audio-volume-high`), Battery (`battery-good`), Wireless/Wi-Fi (`network-wireless`), Dialog Alerts (Information, Warning, Error).

---

### 📏 4. Full Size Tier Support
Supports all standard GTK pixel size tiers alongside vector scalable SVGs:
- `scalable/`
- `16x16/`
- `22x22/`
- `24x24/`
- `32x32/`
- `48x48/`
- `64x64/`
- `128x128/`

---

## 🚀 Installation

### Option A: Install via Debian Package (`.deb`)
Recommended for Linux Mint, Ubuntu, and Debian:

```bash
sudo apt install ./neon-icon-theme_1.0.0_all.deb
```

### Option B: Manual Installation (User Directory)
For individual user installation without root privileges:

```bash
mkdir -p ~/.local/share/icons
cp -r NeonIcons ~/.local/share/icons/
gtk-update-icon-cache -f -t ~/.local/share/icons/NeonIcons
```

---

## 🛠️ Activation

1. **Linux Mint (Cinnamon):** Open *System Settings $\rightarrow$ Themes $\rightarrow$ Icons* and select **NeonIcons**.
2. **XFCE / Thunar:** Open *Settings $\rightarrow$ Appearance $\rightarrow$ Icons* and select **NeonIcons**.
3. **KDE Plasma / Dolphin:** Open *System Settings $\rightarrow$ Appearance $\rightarrow$ Icons* and select **NeonIcons**.
4. **ROX-Filer / Puppy Linux:** Open *Options $\rightarrow$ Types / Icons* and select **NeonIcons** (or press `Ctrl+R` to refresh).

---

## 📜 License
Released under the MIT License.