alexander/lenovo-gentoo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
4 Commits 1 Branch 0 Tags
main
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE

README.md

Gentoo ThinkPad Workstation Documentation

Complete documentation for a Lenovo ThinkPad running Gentoo Linux with Hyprland window manager.

Quick Links

Documentation Structure

docs/
├── guides/                      # Comprehensive guides
│   ├── gentoo/                  # Gentoo-specific guides
│   ├── hyprland/                # Hyprland window manager guides
│   ├── hardware/                # Hardware configuration guides
│   ├── system/                  # System management guides
│   └── troubleshooting/         # Troubleshooting guides
├── reference/                   # Quick reference materials
└── technical/                   # Technical specifications

User Guides

Gentoo Linux

Guide Description
Gentoo General Usage Complete Gentoo commands reference
Emerge Tool Guide Package manager (emerge) detailed reference

Key Topics:

  • System information and monitoring
  • Service management (OpenRC)
  • Kernel management and compilation
  • System updates and maintenance
  • File management and permissions
  • Development tools (Docker, Git)

Hyprland Window Manager

Guide Description
Hyprland Usage Guide Complete Hyprland reference with all keybindings
Lid Automation Automatic lid handling and monitor switching
Monitor Dock via DisplayLink DisplayLink monitor setup

Key Topics:

  • All keybindings and shortcuts
  • Monitor management (laptop + 2 external)
  • Workspace management
  • Window operations
  • hyprctl command reference
  • Custom automation scripts

Hardware Configuration

Guide Description
Power Management AC/Battery profiles, conservation mode
Bluetooth Setup Bluetooth configuration and troubleshooting
Touchpad/Touchscreen Input device configuration

Key Topics:

  • Automatic power profile switching
  • Battery charge thresholds (20-80%)
  • Bluetooth pairing and management
  • Touchpad gestures and settings

System Management

Guide Description
Backup Setup Automated NAS backups with network trigger
Security Hardening Firewall, fail2ban, SSH security
Dotfiles Management Original chezmoi setup guide
Chezmoi Guide Complete chezmoi usage reference

Key Topics:

  • Four backup types (full, home, incremental, configs)
  • Network-triggered automatic backups
  • nftables firewall configuration
  • Cross-platform dotfile syncing with chezmoi
  • Templates for multi-machine configs

Troubleshooting

Guide Description
Troubleshooting Guide Solutions for all common issues
Fix DisplayLink Artifacts DisplayLink optimization

Key Topics:

  • Bluetooth, WiFi, audio issues
  • Power management problems
  • Monitor and lid automation issues
  • Dotfile management issues
  • Kernel and service problems

Reference Materials

Quick Reference

Document Description
User Guide Quick command reference for everyday tasks
System Overview Hardware specs and software stack
Feature Status Current state and working features
Post-Reboot Checklist Verify system after reboot

Management Scripts

All interactive management scripts are installed system-wide with ZSH autocompletion:

Script Purpose Documentation
wifi-setup WiFi connection management scripts/wifi-setup/README.md
bluetooth-setup Bluetooth device management scripts/bluetooth-setup/README.md
audio-setup Audio device switching scripts/audio-setup/README.md
monitor-setup Monitor configuration scripts/monitor-setup/README.md
battery-setup Battery threshold management scripts/battery-setup/README.md
backup-setup Backup management scripts/backup-setup/README.md

Technical Documentation

Document Description
Lid Automation Implementation Technical specs for lid automation
Kernel Config Complete working kernel configuration

System Specifications

Hardware

  • Model: Lenovo ThinkPad P14s Gen6 (14")
  • CPU: AMD Ryzen AI 7 PRO 350 (8 cores, 2.0-5.0 GHz)
  • RAM: 96GB DDR5-5600MHz
  • Storage: 512GB NVMe PCIe 4.0 SSD
  • Display: 14" 2.8K OLED (2880x1800) @ 120Hz VRR
  • WiFi: MediaTek MT7925 Wi-Fi 7 + Bluetooth 5.4
  • Dock: USB-C with 2x DisplayLink monitors (2560x1440 @ 60Hz)

Software

  • OS: Gentoo Linux (OpenRC)
  • Kernel: 6.12.41-gentoo-x86_64 (manual compilation)
  • Display: Wayland (pure, no X11/XWayland)
  • WM: Hyprland 0.49.0
  • Status Bar: Waybar (Catppuccin Mocha theme)
  • Terminal: Ghostty (pure Wayland)
  • Editor: Neovim with LSP
  • Theme: Catppuccin Mocha (system-wide)

Key Features

✅ Fully Working

  • Multi-Monitor Support: Laptop + 2 external DisplayLink monitors
  • Lid Automation: Smart suspend/monitor switching based on external monitors
  • Power Management: Automatic AC/Battery profiles (~30-50% battery improvement)
  • Battery Conservation: 20-80% charge thresholds (extended lifespan)
  • Automated Backups: NAS backups with network trigger
  • Security: nftables firewall (default deny incoming)
  • Dotfile Sync: chezmoi for cross-platform configuration management
  • Hardware Support: WiFi 7, Bluetooth 5.4, touchpad, touchscreen, webcam
  • Professional UI: Catppuccin Mocha theme with Nerd Font icons

🎯 Design Goals

  1. Minimal footprint - No bloated desktop environments
  2. Performance first - Optimized for OLED and battery life
  3. Wayland native - Modern display protocol
  4. Single-user system - Optimized for developer workflow
  5. Rock solid - Stability over bleeding edge
  6. Well documented - Comprehensive guides for everything

Getting Started

New Users

  1. Start with User Guide for essential commands
  2. Read System Overview to understand the setup
  3. Check Feature Status for what's working
  4. Bookmark Troubleshooting for when issues arise

Learning Gentoo

  1. Gentoo General Usage - System commands
  2. Emerge Tool Guide - Package management

Learning Hyprland

  1. Hyprland Usage Guide - All keybindings and commands
  2. Lid Automation - How lid automation works

Daily Tasks

  • WiFi: wifi-setup connect "NetworkName"
  • Bluetooth: bluetooth-setup pair AA:BB:CC:DD:EE:FF
  • Audio: audio-setup output 2
  • Monitors: monitor-setup status
  • Backup: backup-setup status
  • Update system: sudo emerge --sync && sudo emerge -uDNav @world

Contributing

This is personal system documentation, but suggestions and improvements are welcome.

Documentation Style

  • Clear and concise: Focus on practical usage
  • Complete examples: Show actual commands with output
  • Cross-referenced: Link to related documentation
  • Up-to-date: Reflect current system state

Reporting Issues

If you find errors or outdated information:

  1. Check Feature Status for current state
  2. Verify against actual system behavior
  3. Consult Troubleshooting

Resources

Gentoo

Hyprland

Tools

Project Status

Overall: 🟢 Excellent - Production Ready

Core system setup is ~99% complete. Only development-specific tools remain (Kotlin, Android, IoT tooling) which will be configured as needed.

See Feature Status for detailed progress.

For Claude Code

If you're Claude Code working on this project, see CLAUDE.md for operational guidelines, system architecture, and important notes.

Last Updated: 2025-11-16

Description
No description provided
Readme 327 KiB
Languages
Shell 100%