Linux on Framework Laptops Tools and Scripts
February 25 2025 8:14am • Est. Read Time: 2 MINThis 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:
- System Diagnostics and Logs: Tools to collect system logs, detect GPU usage, and diagnose network connectivity issues.
- Power Management: Utilities to customize power-saving settings, manage hibernation, and prevent accidental wakeups.
- Device Configuration: Scripts to set up fingerprint readers, Wi-Fi power save, and kernel switching on Ubuntu.
- Audio and Graphics Optimization: Easy Effects setup for audio processing and discrete GPU usage detection.
- System Enhancements: Enabling hibernation on Fedora, configuring USB event logging, and installing Mission Center as a Flatpak.
- Wi-Fi and Ethernet Testing: Diagnostic tools for troubleshooting Wi-Fi drops and network performance.
Framework Log Helper (Combined.sh)
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
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 to fix this on the BIOS level, however until that is available this script is a reliable workaround.
Fingerprint Checker
A utility to verify and clear fingerprint data on Framework devices, ensuring proper functionality and resolving configuration issues.
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
Tools to troubleshoot network connectivity, including tests for Ethernet and Wi-Fi performance, diagnostics, and configuration issues.
Tuned PPD Customizer Script
Customizes and optimizes Tuned profiles for performance and power management on Framework devices.
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
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
Sets up the Mission Center application as a Flatpak for Ubuntu, providing a streamlined installation process.
Fedora 41 Hibernation Option
Guides users through enabling hibernation on Fedora 41 systems, including configuration for encrypted swap.
Ubuntu Kernel Switcher
Automates switching between different Ubuntu kernel versions, simplifying upgrades or downgrades for compatibility testing.
USB Event Logger Script
Logs USB events such as connections, disconnections, and power changes, aiding in USB device troubleshooting.
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
Diagnoses and resolves Wi-Fi connection drops on Mediatek and Intel wireless devices, offering testing and troubleshooting options.
dGPU Power State Linux
Monitors discrete GPU power states, verifying proper functionality and dGPU power draw behavior.
Steam Drive Mounter
Provides a script to easily mount and manage a second NVMe drives for use with Steam, streamlining game library organization.