{"id":43738393,"url":"https://github.com/asafelobotomy/xanados_clean","last_synced_at":"2026-02-05T11:09:26.680Z","repository":{"id":297092361,"uuid":"995627232","full_name":"asafelobotomy/xanados_clean","owner":"asafelobotomy","description":"This repository contains xanadOS_clean.sh, a comprehensive Bash script for Arch Linux maintenance.","archived":false,"fork":false,"pushed_at":"2025-07-23T20:35:12.000Z","size":2599,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-23T21:01:07.669Z","etag":null,"topics":["archlinux","audit","codex","maintenance","script","security"],"latest_commit_sha":null,"homepage":"https://github.com/asafelobotomy/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asafelobotomy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-03T19:20:42.000Z","updated_at":"2025-07-23T20:35:16.000Z","dependencies_parsed_at":"2025-06-04T04:34:22.659Z","dependency_job_id":"aa6f4b6e-42a3-4774-8732-d16196fd85aa","html_url":"https://github.com/asafelobotomy/xanados_clean","commit_stats":null,"previous_names":["asafelobotomy/xanados_clean"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/asafelobotomy/xanados_clean","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asafelobotomy%2Fxanados_clean","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asafelobotomy%2Fxanados_clean/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asafelobotomy%2Fxanados_clean/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asafelobotomy%2Fxanados_clean/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asafelobotomy","download_url":"https://codeload.github.com/asafelobotomy/xanados_clean/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asafelobotomy%2Fxanados_clean/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29120484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T10:47:47.471Z","status":"ssl_error","status_checked_at":"2026-02-05T10:45:08.119Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archlinux","audit","codex","maintenance","script","security"],"created_at":"2026-02-05T11:09:25.868Z","updated_at":"2026-02-05T11:09:26.654Z","avatar_url":"https://github.com/asafelobotomy.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xanadOS Clean - Arch Linux System Maintenance\n\n**Version 2.0.0** - Professional-grade maintenance automation for Arch Linux\nsystems with configuration management, error recovery, and comprehensive\ntesting.\n\nThis repository provides a comprehensive system maintenance script designed\nspecifically for Arch Linux and its derivatives (Manjaro, EndeavourOS, etc.).\nThe script combines package management, security scanning, backup operations,\nand system optimization into a single, reliable maintenance workflow.\n\n## ✨ Key Features\n\n### Core Functionality\n\n- **Smart Package Management**: Automatic package updates with AUR helper support (paru/yay)\n- **Intelligent Mirroring**: Optimized repository mirrors for faster downloads with reflector\n- **Multi-Backup Support**: Timeshift, Snapper, or rsync backup options with smart scheduling\n- **Security Scanning**: rkhunter and arch-audit vulnerability assessment\n- **Filesystem Maintenance**: Btrfs optimization and SSD TRIM support\n- **System Monitoring**: Failed services detection and journal error analysis\n- **Arch News**: Latest updates from Arch Linux newsfeeds\n\n### Enhanced Features (v2.0)\n\n- **🔧 Configuration Management**: Flexible settings via config files\n- **🛡️ Error Recovery System**: Checkpoint/resume and automatic rollback\n- **📋 Comprehensive Testing**: BATS unit testing framework\n- **📚 Enhanced Documentation**: Comprehensive user and developer guides\n- **⚡ Performance Optimizations**: Faster execution with progress tracking\n- **🔒 Security Hardening**: Input validation and privilege management\n\n### Latest Optimizations (2024-2025)\n\n- **🚀 Advanced Pacman Features**: Parallel downloads, colored output, enhanced security\n- **📰 Arch News Integration**: Automated breaking news checks with informant/newscheck\n- **🔧 Essential Tool Suite**: pacman-contrib, pkgfile, arch-audit, rebuild-detector\n- **⚡ Performance Tuning**: SSD optimization, zram compression, memory management\n- **🔒 Enhanced Security**: CVE scanning, package integrity, unowned file detection\n- **🔄 Automated Hooks**: Proactive maintenance monitoring and alerts\n\n## Quick Start\n\n### Installation\n\n#### Option 1: Automated Installation (Recommended)\n\n```bash\ngit clone https://github.com/asafelobotomy/xanados_clean.git\ncd xanados_clean\n./install.sh\n```\n\nThis will:\n\n- Install xanadOS Clean system-wide\n- Create symlinks for easy access\n- Set up systemd automation (optional)\n- Configure both full and simple modes\n\n#### Option 2: Manual Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/asafelobotomy/xanados_clean.git\n   cd xanados_clean\n   chmod +x xanados_clean.sh\n   ```\n\n2. Run the script:\n\n   ```bash\n   # Interactive mode (recommended)\n   ./xanados_clean.sh\n   \n   # Automatic mode\n   ./xanados_clean.sh --auto\n   ```\n\n### Usage Modes\n\nxanadOS Clean offers multiple modes to suit different user needs:\n\n#### 🔧 Full Mode (Default)\n\nComplete maintenance with all advanced features:\n\n```bash\nxanados-clean                    # Interactive\nxanados-clean --auto             # Automatic\n```\n\n- Full package management (pacman + AUR)\n- Security scanning (rkhunter, arch-audit)\n- Performance monitoring\n- Backup operations\n- System reporting\n- Error recovery\n\n#### 🚀 Simple Mode (New!)\n\nBasic maintenance for casual users (like arch-cleaner):\n\n```bash\nxanados-clean --simple           # Installed version\n./xanados_clean.sh --simple      # Local version\n```\n\n- System package updates\n- Orphaned package removal\n- Cache cleanup\n- Service status check\n- Fast execution (~2-3 minutes)\n\n#### 🏢 Automated Mode\n\nSystem-wide automation via systemd:\n\n```bash\n# Set up during installation\n./install.sh\n\n# Manual timer management\nsystemctl --user enable xanados-clean.timer\n```\nsystemctl --user start xanados-clean.timer\n```\n\n### Command Line Options\n\n```bash\n# Show help\n./xanados_clean.sh --help\n\n# Run automatically (non-interactive)\n./xanados_clean.sh --auto\n\n# Use custom configuration\n./xanados_clean.sh --config ~/.my-config.conf\n\n# Show current configuration\n./xanados_clean.sh --show-config\n\n# Create default configuration file\n./xanados_clean.sh --create-config\n\n# Test mode (dry run)\n./xanados_clean.sh --test-mode\n```\n\n### Configuration\n\nCreate a personalized configuration:\n\n```bash\n# Create default config in ~/.config/xanados_clean/\n./xanados_clean.sh --create-config\n\n# Edit the configuration\nnano ~/.config/xanados_clean/config.conf\n```\n\nKey configuration options:\n\n```bash\n# Enable/disable features\nENABLE_FLATPAK=true\nENABLE_SECURITY_SCAN=true\nENABLE_BTRFS_MAINTENANCE=auto\n## Configuration\n\nCreate a configuration file for customized settings:\n\n```bash\n./xanados_clean.sh --create-config\n```\n\nKey configuration options:\n\n```bash\n# General settings\nAUTO_MODE=false\nASK_EACH_STEP=false\n\n# Backup settings\nBACKUP_METHOD=timeshift\nBACKUP_SKIP_THRESHOLD_DAYS=7\n\n# Feature toggles\nENABLE_SECURITY_SCAN=true\nENABLE_ARCH_OPTIMIZATIONS=true\n```\n\n## Documentation\n\n- **[User Guide](docs/USER_GUIDE.md)** - Complete setup and usage instructions\n- **[Developer Guide](docs/DEVELOPER_GUIDE.md)** - API reference, testing, and development\n- **[Changelog](CHANGELOG.md)** - Version history and updates\n\n## Testing\n\nRun the test suite to verify functionality:\n\n```bash\n# Install BATS testing framework\nsudo pacman -S bats\n\n# Run all tests\ncd tests \u0026\u0026 ./run_tests.sh\n```\n\n## Project Structure\n\n```text\nxanados_clean/\n├── xanados_clean.sh        # Main script\n├── lib/                    # Core libraries\n│   ├── config.sh          # Configuration management\n│   ├── recovery.sh        # Error recovery system\n│   ├── performance.sh     # Performance monitoring\n│   ├── arch_optimizations.sh # Arch-specific features\n│   └── enhancements.sh    # Integration layer\n├── config/                 # Configuration files\n├── tests/                  # Test suite\n├── docs/                   # Documentation\n│   ├── USER_GUIDE.md      # User documentation\n│   └── DEVELOPER_GUIDE.md # Developer documentation\n└── archive/                # Historical documentation\n```\n\n## Requirements\n\n- **OS**: Arch Linux or derivatives (Manjaro, EndeavourOS)\n- **Shell**: Bash 4.0+\n- **Privileges**: sudo access\n- **Network**: Internet connection for updates\n- **Optional**: BATS (testing), Node.js (development)\n\n## License \u0026 Support\n\n- **License**: GPL-3.0\n- **Issues**: [GitHub Issues](https://github.com/asafelobotomy/xanados_clean/issues)\n- **Logs**: `~/Documents/system_maint.log`\n\nFor detailed usage instructions, see the [User Guide](docs/USER_GUIDE.md).  \nFor development information, see the [Developer Guide](docs/DEVELOPER_GUIDE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasafelobotomy%2Fxanados_clean","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasafelobotomy%2Fxanados_clean","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasafelobotomy%2Fxanados_clean/lists"}