This intelligent diagnostic script collects and analyzes system logs from your Framework laptop, automatically detecting hardware issues and providing actionable recommendations in plain English. It's specifically designed for Framework laptops with model-aware analysis and Framework-specific troubleshooting guidance.

• TL;DR - Quick Start
• Key Features
• Which distros does this work on?
• How to use this tool?
  • Prerequisites
  • Quick Start
• Diagnostic Options
  • 1. Last X Minutes
  • 2. Last 24 Hours
  • 3. Specific Time Range
  • 4. Filter Previously Created Log File
• Understanding the Results
  • System Information
  • Intelligent Recommendations
  • Pattern Analysis
  • Framework-Specific Features
• Example Output
• When to Contact Support
• Quick Commands
• Framework Resources
• Advanced Information

Download and run immediately:

curl -s https://raw.githubusercontent.com/FrameworkComputer/linux-docs/main/log-helper/combined.sh -o combined.sh && chmod +x combined.sh && bash combined.sh

Choose option 1 or 2, check the "INTELLIGENT RECOMMENDATIONS" section in the output for actionable solutions.

• 🔍 Intelligent Issue Detection: Automatically identifies GPU hangs, thermal problems, WiFi issues, USB connection problems, and more
• 🖥️ Framework-Specific Analysis: Detects your exact Framework model and provides model-specific recommendations
• 📋 Plain English Recommendations: Translates technical errors into clear, actionable advice
• 🌡️ Real-Time Hardware Monitoring: Shows current temperatures, power status, and connectivity
• ⚡ Smart Noise Filtering: Focuses on actual problems, ignoring routine system operations
• 🔧 Comprehensive Hardware Detection: Identifies your GPU, WiFi card, storage, RAM, and expansion cards

This tool works with all major Linux distributions and automatically installs required packages:

• Ubuntu/Debian/Linux Mint (officially supported by Framework)
• Fedora (officially supported by Framework)
• Bazzite/Project Bluefin (officially supported by Framework)
• Arch Linux/Manjaro/EndeavourOS (community supported)
• openSUSE Tumbleweed/Leap (community supported)
• NixOS (community supported)
• Pop!_OS (community supported)

Most systems already have curl installed. If needed:

Fedora:

sudo dnf install curl -y

Ubuntu/Debian:

sudo apt install curl -y

Bazzite/Bluefin: Already included, no installation needed.

Download and run the diagnostic tool:

curl -s https://raw.githubusercontent.com/FrameworkComputer/linux-docs/main/log-helper/combined.sh -o combined.sh && chmod +x combined.sh && bash combined.sh

For future runs:

./combined.sh

Best for recent issues

• Select option 1
• Enter the number of minutes (e.g., 30 for issues that happened 30 minutes ago)
• The tool will analyze logs from that timeframe and provide recommendations

Example use cases:

• Graphics crashed while gaming
• WiFi suddenly disconnected
• System became unresponsive
• Thermal throttling during heavy workload

Best for ongoing or intermittent issues

• Select option 2
• Analyzes the full day of system logs
• Identifies patterns like recurring WiFi drops or thermal cycling

Example use cases:

• Random system freezes throughout the day
• Intermittent USB connection issues
• Gradual performance degradation
• Battery or charging problems

Best when you know exactly when the issue occurred

• Select option 3
• Enter start time: YYYY-MM-DD HH:MM (24-hour format)
• Enter end time: YYYY-MM-DD HH:MM

Example:

• Start: 2025-01-15 14:30 (Jan 15, 2:30 PM)
• End: 2025-01-15 15:00 (Jan 15, 3:00 PM)

For advanced analysis of existing logs

• Run after creating a log file with options 1-3
• Search for specific keywords or phrases
• Creates filtered_log.txt with matching entries

The diagnostic tool creates combined_log.txt with several sections:

• Framework model detection
• Hardware specifications (GPU, WiFi, RAM, storage)
• Current temperatures and power status
• Linux distribution compatibility status

Color-coded by severity:

• 🔴 IMMEDIATE: Stop using immediately (dangerous temperatures, hardware faults)
• 🟠 URGENT: Address soon (GPU crashes, memory issues, storage problems)
• 🟡 IMPORTANT: Should fix (USB issues, WiFi problems, audio issues)
• 🔵 INFORMATIONAL: Status updates (distro compatibility, normal thermal behavior)
• 🟢 PREVENTIVE: Proactive suggestions (elevated temperatures, minor issues)

• WiFi stability (tracks disconnection frequency)
• USB connection reliability
• GPU stability monitoring
• Thermal management effectiveness

Model-Aware Recommendations:

• Framework Laptop 13: 60W charger verification
• Framework Laptop 16: 180W charger verification + GPU module checks
• Framework Desktop: Power supply diagnostics
• Expansion card troubleshooting

Thermal Management:

• Modern AMD (7040+ series): Higher temperature tolerance (95°C normal)
• Intel processors: Conservative thresholds (80°C watch point)
• Model-specific cooling guidance

Hardware Detection:

• MediaTek WiFi cards (MT7922/MT7925)
• Intel WiFi cards (iwlwifi)
• AMD GPUs (RDNA 2/3)
• Intel integrated graphics
• Framework expansion cards

🖥️  Framework Laptop 16 - checking GPU module and enhanced thermal envelope
🌡️  Current CPU: 67°C via Tctl (Modern AMD: runs hot by design - watch at 90°C, throttles at 95°C, critical at 100°C, emergency at 105°C)
✅ No issues detected

🔵 INFORMATIONAL Status:
• [DISTRO_COMPATIBILITY] ✅ Your Linux distribution (fedora 42) is officially supported and tested by Framework for your Framework Laptop 16 → You should have the best experience and full hardware support

Contact Framework Support if you see:

• Multiple 🔴 IMMEDIATE or 🟠 URGENT recommendations
• Repeated GPU crashes or system freezes
• Hardware fault messages (Machine Check, MCE errors)
• Persistent thermal issues despite cleaning

Include these files with your support ticket:

• combined_log.txt (the full diagnostic report)
• Screenshots of any error messages
• Description of when the issue occurs

After running the diagnostic:

# View full report
cat combined_log.txt

# View only recommendations
grep -A 20 "INTELLIGENT RECOMMENDATIONS" combined_log.txt

# Monitor temperatures in real-time
watch -n 2 sensors

# Check current system status
sensors

Support & Documentation:

• Support Center: https://frame.work/support
• Linux Guides: https://frame.work/linux
• Community Forum: https://community.frame.work/
• Knowledge Base: https://knowledgebase.frame.work/categories/linux-S1IUEcFbkx
• Linux Tools and Scripts: https://knowledgebase.frame.work/linux-on-framework-tools-and-scripts-rymax1Jdyg
• Framework Guides: https://guides.frame.work/
• Enhanced WiFi Analyzer: https://github.com/FrameworkComputer/linux-docs/tree/main/Enhanced-WiFi-Analyzer

• Deep dive into how it works
• Troubleshooting common issues

Note: Each diagnostic run overwrites the previous combined_log.txt file. Save important reports before running again.