{"id":28469634,"url":"https://github.com/andreas-glaser/asus-linux-mint","last_synced_at":"2026-01-16T13:47:28.680Z","repository":{"id":296821363,"uuid":"994565227","full_name":"andreas-glaser/asus-linux-mint","owner":"andreas-glaser","description":"An automated installation script for asusctl and supergfxctl on ASUS ROG/TUF laptops running Linux Mint.","archived":false,"fork":false,"pushed_at":"2026-01-14T22:41:45.000Z","size":122,"stargazers_count":30,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-15T04:54:02.094Z","etag":null,"topics":["asus","asusctl","bash","debian","linux","linux-mint","supergfxctl"],"latest_commit_sha":null,"homepage":"https://github.com/andreas-glaser/asus-linux-mint","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andreas-glaser.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-02T06:17:10.000Z","updated_at":"2026-01-14T22:39:44.000Z","dependencies_parsed_at":"2025-09-06T07:06:00.949Z","dependency_job_id":null,"html_url":"https://github.com/andreas-glaser/asus-linux-mint","commit_stats":null,"previous_names":["andreas-glaser/asus-linux-mint"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/andreas-glaser/asus-linux-mint","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreas-glaser%2Fasus-linux-mint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreas-glaser%2Fasus-linux-mint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreas-glaser%2Fasus-linux-mint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreas-glaser%2Fasus-linux-mint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andreas-glaser","download_url":"https://codeload.github.com/andreas-glaser/asus-linux-mint/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreas-glaser%2Fasus-linux-mint/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479034,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: 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":["asus","asusctl","bash","debian","linux","linux-mint","supergfxctl"],"created_at":"2025-06-07T09:08:07.723Z","updated_at":"2026-01-16T13:47:28.672Z","avatar_url":"https://github.com/andreas-glaser.png","language":"Shell","readme":"# ASUS Linux Tools Installer for Linux Mint\n\nAn automated installation script for [asusctl](https://gitlab.com/asus-linux/asusctl) and [supergfxctl](https://gitlab.com/asus-linux/supergfxctl) on ASUS ROG/TUF laptops running **Linux Mint**.\n\n## 🚀 Features\n\n- **Automated installation** of latest asusctl and supergfxctl for Linux Mint\n- **System firmware updates** via fwupd for optimal hardware compatibility\n- **Kernel compatibility checking** with automatic upgrade options\n- **NVIDIA driver preparation** with nouveau blacklist configuration\n- **Comprehensive dependency management** including linux-firmware\n- **Proper systemd service configuration** \n- **Comprehensive error handling** with colored output\n- **Linux Mint compatibility** for version 22.3\n- **Safe uninstallation** with complete cleanup\n- **ASUS ROG/TUF hardware support** for all major laptop models\n\n## 📋 Requirements\n\n- **Linux Mint 22.3** (Cinnamon, MATE, or Xfce edition)\n- **ASUS ROG/TUF laptop** with compatible hardware\n- **Internet connection** for downloading dependencies\n- **Sudo privileges** for system modifications\n\n## 🧰 Kernel\n\n- Default: Linux Mint 22.3 ships the HWE kernel 6.14, which is recommended and sufficient for ASUS laptops.\n- Optional: If you need newer hardware fixes, you can install a newer mainline kernel and keep 6.14 as fallback.\n\n### 🔧 Optional: Install a newer mainline kernel\n\nIf you need bleeding‑edge support or want to test newer kernels, you can install a mainline kernel and retain the distro kernel as a backup:\n\n\u003cdetails\u003e\n\u003csummary\u003e📋 Click to expand mainline kernel installation methods\u003c/summary\u003e\n\n**⚠️ Important Warnings:**\n- Mainline kernels are experimental and unsigned\n- Always keep a working kernel as backup\n- You may need to reinstall NVIDIA drivers after kernel updates\n- Test thoroughly before relying on mainline kernels\n\n**Option 1: Ubuntu Mainline Kernel Installer**\n```bash\n# Install the mainline kernel tool\nsudo apt install -y wget\nwget -qO - https://raw.githubusercontent.com/pimlie/ubuntu-mainline-kernel.sh/master/ubuntu-mainline-kernel.sh | sudo bash\n\n# Install latest stable kernel\nsudo ubuntu-mainline-kernel.sh -i\n```\n\n**Option 2: Manual Installation**\n1. Visit [Ubuntu Mainline Kernels](https://kernel.ubuntu.com/mainline/)\n2. Download the latest stable mainline kernel packages for your architecture\n3. Install using: `sudo dpkg -i *.deb`\n\n**Option 3: GUI Tool (TuxInvader)**\n```bash\nsudo add-apt-repository ppa:tuxinvader/mainline\nsudo apt update \u0026\u0026 sudo apt install mainline\n# Launch 'mainline' GUI and install latest kernel\n```\n\n\u003c/details\u003e\n\n## 🛠️ Installation\n\n### Quick Install (Recommended)\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/andreas-glaser/asus-linux-mint/main/install-asus-linux.sh | bash\n```\n\n### Manual Install\n\n```bash\n# Download the script\nwget https://raw.githubusercontent.com/andreas-glaser/asus-linux-mint/main/install-asus-linux.sh\n\n# Make it executable\nchmod +x install-asus-linux.sh\n\n# Run the installer\n./install-asus-linux.sh\n```\n\n### Custom Build Directory\n\n```bash\n# Use custom directory for build files\nASUS_BUILD_DIR=\"/opt/asus-build\" ./install-asus-linux.sh\n```\n\n### Optional: Install ROG Control Center (GUI)\n\nBy default, the installer includes `rog-control-center` (GUI).\n\n```bash\n# Skip the GUI (CLI + daemon only)\nASUS_INSTALL_ROG_GUI=0 ./install-asus-linux.sh\n```\n\n## 📦 What Gets Installed\n\n### Core Components\n- **asusctl** - Primary ASUS laptop control utility\n- **supergfxctl** - GPU switching and power management\n- **Rust toolchain** - Latest stable version via rustup\n- **Build dependencies** - All required development packages\n- **linux-firmware** - Essential hardware firmware blobs\n\n### System Configuration\n- **systemd services** - asusd, supergfxd, and asusd-user\n- **udev rules** - Hardware detection and device permissions\n- **DBus configuration** - Inter-process communication setup\n- **Firmware updates** - Latest BIOS, EC, and device firmware\n- **Kernel compatibility** - Ensures minimum required kernel version\n- **NVIDIA preparation** - Nouveau driver blacklist for proper GPU switching\n\n### Hardware Features Enabled\n- **Fan curve control** - Custom cooling profiles\n- **RGB lighting control** - Keyboard and logo lighting\n- **Power profiles** - Battery optimization modes\n- **GPU switching** - Integrated/Hybrid/Discrete modes\n- **Keyboard shortcuts** - Fn key combinations\n- **Thermal management** - Advanced cooling control\n\n## 🔧 Usage\n\n### Basic Commands\n\n```bash\n# Check ASUS laptop status\nasusctl -s\n\n# Check GPU switching status\nsupergfxctl --status\n\n# Switch to integrated graphics (power saving)\nsupergfxctl --mode Integrated\n\n# Switch to hybrid graphics (balanced)\nsupergfxctl --mode Hybrid\n\n# Set fan curve to performance mode\nasusctl fan-curve -p performance\n\n# Control RGB lighting\nasusctl led-pow -s on\nasusctl led-mode static\n```\n\n### Service Management\n\n```bash\n# Check service status\nsudo systemctl status asusd supergfxd\n\n# Restart services if needed\nsudo systemctl restart asusd supergfxd\n\n# View service logs\nsudo journalctl -u asusd.service -f\nsudo journalctl -u supergfxd.service -f\n```\n\n## 🗑️ Uninstallation\n\n### Quick Uninstall\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/andreas-glaser/asus-linux-mint/main/uninstall-asus-linux.sh | bash\n```\n\n### Manual Uninstall\n\n```bash\n# Download the uninstall script\nwget https://raw.githubusercontent.com/andreas-glaser/asus-linux-mint/main/uninstall-asus-linux.sh\n\n# Make it executable\nchmod +x uninstall-asus-linux.sh\n\n# Run the uninstaller\n./uninstall-asus-linux.sh\n```\n\n### What Gets Removed\n- All ASUS Linux tool binaries and libraries\n- System services and configuration files\n- Build directories and source code\n- Desktop applications and icons\n- Optional: nouveau blacklist configuration\n- Optional: build directories\n\n### What Gets Preserved\n- System firmware updates\n- Kernel upgrades\n- System packages (linux-firmware, build tools)\n- Rust toolchain\n- User data and personal settings\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n**Services not starting:**\n```bash\n# Check service logs\nsudo journalctl -u asusd.service -n 50\nsudo journalctl -u supergfxd.service -n 50\n\n# Reload and restart\nsudo systemctl daemon-reload\nsudo systemctl restart asusd supergfxd\n```\n\n**GPU switching not working:**\n```bash\n# Ensure nouveau is blacklisted\ncat /etc/modprobe.d/blacklist-nouveau.conf\n\n# Check GPU status\nsupergfxctl --status\nlspci | grep -i vga\n\n# Reboot after GPU mode changes\nsudo reboot\n```\n\n**Permission issues:**\n```bash\n# Check user groups\ngroups $USER\n\n# Add user to appropriate groups\nsudo usermod -a -G users $USER\n```\n\n**Build failures:**\n```bash\n# Clean and rebuild\nrm -rf ~/.local/src/asus-linux\n./install-asus-linux.sh\n\n# Check dependencies\nsudo apt update \u0026\u0026 sudo apt upgrade\n```\n\n### Support Information\n\nWhen reporting issues, please include:\n- Linux Mint version and edition\n- ASUS laptop model\n- Kernel version (`uname -r`)\n- Graphics hardware (`lspci | grep -i vga`)\n- Service status (`sudo systemctl status asusd supergfxd`)\n- Installation logs and error messages\n\nFor more help, visit:\n- [ASUS Linux Community](https://asus-linux.org/)\n- [asusctl GitLab Issues](https://gitlab.com/asus-linux/asusctl/-/issues)\n- [supergfxctl GitLab Issues](https://gitlab.com/asus-linux/supergfxctl/-/issues)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit issues, feature requests, or pull requests.\n\n## ⚠️ Disclaimer\n\nThis script modifies system configurations and installs software that may affect your system's stability. Use at your own risk. Always ensure you have backups before making system changes.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreas-glaser%2Fasus-linux-mint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandreas-glaser%2Fasus-linux-mint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreas-glaser%2Fasus-linux-mint/lists"}