# Linux on Framework Laptops Tools and Scripts

> Framework Script Summaries and Links     Framework Log Helper Combinedsh   This script collects and organizes system logs for troubleshooting Framework devic

Source: https://knowledgebase.frame.work/en_us/linux-on-framework-tools-and-scripts-rymax1Jdyg

Last updated: 2025-10-07T18:05:59.336Z

This collection of scripts and guides from Framework's GitHub repositories offers tools and resources to optimize, troubleshoot, and enhance various aspects of Framework devices running Linux. The scripts cover a wide range of functionality, including:

  

*   ## [GPUMode Ubuntu](https://github.com/FrameworkComputer/GPUMode?tab=readme-ov-file#gpumode-ubuntu)
    

           System tray application for manual GPU mode switching on Ubuntu laptops with AMD integrated and NVIDIA discrete graphics.

*   Manual GPU Mode Switching: Switch between Integrated and Hybrid modes via system tray
    
*   Power Change Prompts: Optional prompts to switch GPU modes when AC power plugs/unplugs
    
*   Automatic Power Profiles: Automatically switches system power profiles (performance/power-saver) based on AC/battery status
    
*   NVIDIA Mode Detection: Detects when BIOS is set to NVIDIA-only mode and provides guidance
    

  

*   ## [GPUMode Fedora](https://github.com/FrameworkComputer/GPUMode-Fedora?tab=readme-ov-file#gpumode-fedora)
    
    System tray application for manual GPU mode switching on Fedora laptops with AMD integrated and NVIDIA discrete graphics.
    
    *   Manual GPU Mode Switching: Switch between Integrated and Hybrid modes via system tray
        
    *   Power Change Prompts: Optional prompts to switch GPU modes when AC power plugs/unplugs
        
    *   Automatic Power Profiles: Automatically switches system power profiles (performance/power-saver) based on AC/battery status
        
    *   NVIDIA Mode Detection: Detects when BIOS is set to NVIDIA-only mode and provides guidance
        
    

  

*   ## [Linux Audio Diagnostic Script](https://github.com/FrameworkComputer/linux-docs/tree/main/misc/audio-diagnostic#-linux-audio-diagnostic-script)
    
    This script is a universal, read-only Linux audio diagnostic tool that checks PipeWire, PulseAudio, and ALSA for common problems, reporting on service health, default routing, available devices, profiles, and recent log events. It can optionally play a test sound, display detailed technical info (codecs, latency, battery levels), and highlight issues with clear ✅/⚠️/❌ indicators for quick troubleshooting.
    

  

*   ## **[WiFi Mesh Network Analyzer](https://github.com/FrameworkComputer/linux-docs/tree/main/MeshAnalyzer#wifi-mesh-network-analyzer)**
    
    This tool analyzes your WiFi mesh network to show you how well your nodes are positioned, which ones you're connected to, and provides recommendations to optimize your wireless performance - all from the Linux command line.
    

  

*   ## [Enhanced WiFi Analyzer](https://github.com/FrameworkComputer/linux-docs/tree/main/Enhanced-WiFi-Analyzer#-enhanced-wifi-analyzer)
    
    A comprehensive WiFi analysis and troubleshooting tool that diagnoses connectivity issues, optimizes performance, and provides distribution-specific fixes for modern Linux systems. Features DFS radar interference detection, WiFi 7/6E support, and modern VPN integration.
    

  

*   ## **[Framework Log Helper (Combined.sh)](https://github.com/FrameworkComputer/linux-docs/tree/main/log-helper#framework-log-helper-aka-combinedsh)**
    
    This script collects and organizes system logs for troubleshooting Framework devices, combining relevant logs into a single output for easier debugging.
    

  

*   ## **[Disable Accidental Wakeup Script](https://github.com/FrameworkComputer/linux-docs/tree/main/disable-accidental-wakeup#disable-accidental-wakeup-script)**
    
    The problem: In some instances, Framework Laptop 16 can accidentally come out of its suspend state. This usually occurs when traveling, walking, taking a bus, placing the laptop into a backpack. Overall the agreed upon cause is that this happens due to keyboard presses while it's in a state of suspend, thus waking it up.
    
    The workaround: Our engineering team has it [on their roadmap](https://community.frame.work/t/responded-waking-from-suspend-w-lid-closed/47497/73) to fix this on the BIOS level, however until that is available this script is a reliable workaround.
    

  

*   ## **[Fingerprint Checker](https://github.com/FrameworkComputer/linux-docs/tree/main/Fingerprint-Checker#fingerprint-checker)**
    
    A utility to verify and clear fingerprint data on Framework devices, ensuring proper functionality and resolving configuration issues.
    

  

*   ## **[Discrete Graphics Usage Detection](https://github.com/FrameworkComputer/dri_prime1-detection/tree/main?tab=readme-ov-file#discrete-graphics-usage-detection)**
    
    Monitors and reports on discrete graphics usage for devices with dual GPUs, helping users identify active GPU processes.
    

  

*   ## **[Ethernet and Wi-Fi Diagnostic Scripts](https://github.com/FrameworkComputer/linux-docs/tree/main/Network-Diagnostic-Scripts#ethernet-and-wi-fi-diagnostic-scripts)**
    
    Tools to troubleshoot network connectivity, including tests for Ethernet and Wi-Fi performance, diagnostics, and configuration issues.
    
*   ## **[Tuned PPD Customizer Script](https://github.com/FrameworkComputer/linux-docs/tree/main/Tuned-PPD-Customizer-Script#tuned-ppd-customizer-script-usage-guide)**
    
    Customizes and optimizes Tuned profiles for performance and power management on Framework devices.
    
*   ## **[Disable Accidental Wakeup Script](https://github.com/FrameworkComputer/linux-docs/tree/main/disable-accidental-wakeup#disable-accidental-wakeup-script)**
    
    Prevents accidental device wakeups from USB devices or other unintended events by disabling specific wakeup sources.
    
*   ## **[Easy Effects for FW 16 and 13](https://github.com/FrameworkComputer/linux-docs/tree/main/easy-effects#easy-effects-for-fw-16-and-13)**
    
    Installs and configures Easy Effects for audio processing on Framework laptops, including presets for noise suppression and equalization.
    
*   ## **[Mission Center Installer for Ubuntu 24.04](https://github.com/FrameworkComputer/linux-docs/tree/main/flatpaks#mission-center-installer-for-ubuntu-2404)**
    
    Sets up the Mission Center application as a Flatpak for Ubuntu, providing a streamlined installation process.
    
*   ## **[Fedora Hibernation Option](https://github.com/FrameworkComputer/linux-docs/blob/main/hibernation/hibernate-fedora-automatic.md#fedora-41-hibernation-option-not-fedora-official)**
    
    Guides users through enabling hibernation on Fedora 41 systems, including configuration for encrypted swap.
    
*   ## **[Ubuntu Kernel Switcher](https://github.com/FrameworkComputer/linux-docs/tree/main/ubuntu-kernel-switcher#ubuntu-kernel-switcher)**
    
    Automates switching between different Ubuntu kernel versions, simplifying upgrades or downgrades for compatibility testing.
    
*   ## **[USB Event Logger Script](https://github.com/FrameworkComputer/linux-docs/tree/main/usb-events#usb-event-logger-script)**
    
    Logs USB events such as connections, disconnections, and power changes, aiding in USB device troubleshooting.
    
*   ## **[Wi-Fi Power Save Utility](https://github.com/FrameworkComputer/linux-docs/tree/main/wifi-powersave#wi-fi-power-save-utility)**
    
    Adjusts Wi-Fi power save settings to optimize battery life while maintaining connectivity on Framework devices.
    
*   ## **[Mediatek/Intel Wi-Fi Drop Tester](https://github.com/FrameworkComputer/network-tester?tab=readme-ov-file#mediatekintel-wi-fi-drop-tester)**
    
    Diagnoses and resolves Wi-Fi connection drops on Mediatek and Intel wireless devices, offering testing and troubleshooting options.
    
*   ## **[dGPU Power State Linux](https://github.com/FrameworkComputer/dgpu-power-state-linux?tab=readme-ov-file#dgpu-power-state-linux)**
    
    Monitors discrete GPU power states, verifying proper functionality and dGPU power draw behavior.
    
*   ## **[Steam Drive Mounter](https://github.com/FrameworkComputer/steam-drive-mounter/blob/main/README.md#steam-drive-mounter)**
    
    Provides a script to easily mount and manage a second NVMe drives for use with Steam, streamlining game library organization.
