ClamUI

A modern Linux desktop application for ClamAV antivirus

Built with PyGObject, GTK4, and Adwaita for a native GNOME appearance

Features • Screenshots • Installation • Documentation

---

Features

ClamUI provides a comprehensive set of features designed to make antivirus protection on Linux both powerful and user-friendly.

Scanning & Protection Easy File Scanning — Native GTK4 file dialogs for intuitive file selection Async Scanning — Background processing keeps the UI responsive during scans Quarantine Management — Safely isolate and manage detected threats Scan Profiles — Create custom configurations for different use cases	Management & Integration Scan History — Track and review all past scan results Statistics Dashboard — Monitor scanning activity and threat detections VirusTotal Integration — Optional enhanced threat analysis via API File Manager Integration — Right-click "Scan with ClamUI" in Nautilus, Dolphin, and Nemo
User Experience Modern UI — Native Adwaita styling with proper GNOME integration System Tray — Quick access with actions and real-time scan progress Desktop Notifications — Stay informed of scan results and updates	Flexibility Multiple Scan Backends — Choose between daemon (clamd) or direct (clamscan) Scheduled Scans — Configure automatic scanning with systemd or cron Customizable Settings — Extensive configuration options for your workflow

---

Screenshots

Scan Results	Quarantine Management

ClamAV Components Status	Scan History

Scan Profiles	Settings

---

Quick Start

Flatpak (Recommended)

flatpak install flathub io.github.linx_systems.ClamUI
flatpak run io.github.linx_systems.ClamUI

From Source

git clone https://github.com/linx-systems/clamui.git
cd clamui
uv sync
uv run clamui

More Installation Options: See the Installation Guide for .deb packages and system-wide installation

---

Usage

GUI Application

1. Launch ClamUI from your application menu or terminal
2. Select a file or folder to scan
3. Click "Scan" to start the antivirus scan
4. View results and take action on any threats detected

Command Line

# Launch the application
clamui

# Scan specific files directly
clamui /path/to/file1 /path/to/folder

Detailed Instructions: See the User Guide

---

Configuration

ClamUI stores user preferences and can be configured through the Preferences dialog or by editing the configuration file directly.

Configuration Location: ~/.config/clamui/settings.json

Key Configuration Options

Category	Description
Scan Backend	Choose between automatic detection, daemon (clamd), or direct clamscan
Notifications	Control desktop notifications for scan results and updates
Auto-Quarantine	Automatically quarantine detected threats
Scheduled Scans	Configure automatic scanning with systemd or cron
System Tray	Enable start minimized and minimize to tray options
Scan Profiles	Create custom scan configurations with exclusion patterns

For complete configuration reference: See the Configuration Reference for all 15 settings and examples

---

Documentation

Comprehensive guides to help you get the most out of ClamUI:

Document	Description
User Guide	Complete guide to using ClamUI features
Installation Guide	Flatpak, .deb, context menu, and tray setup
Troubleshooting Guide	Common issues and solutions
Development Guide	Dev environment, testing, and contributing
Scan Backend Guide	Backend options, performance comparison, and selection guide
Security Policy	Security contact and reporting

---

Requirements

ClamUI requires the following components to be installed on your system:

Component	Description
ClamAV	The clamscan command-line tool must be installed
GTK4 + libadwaita	For the graphical interface
Python 3.10+	With PyGObject bindings

Platform-specific installation: See the Installation Guide for dependency installation instructions

---

Contributing

Contributions are welcome! Check out the Development Guide for:

• Setting up the development environment
• Running tests with coverage
• Code style guidelines
• Submitting pull requests

---

License

This project is open source. See LICENSE file for details.

---

Made with care for the Linux community

Star on GitHub • Report Bug • Request Feature