📦 deps(thirdparty): update snapshots

2026-07-29 07:59:17 +00:00
parent 60364c6660
commit 0c634043e3
427 changed files with 26138 additions and 2336 deletions
@@ -0,0 +1,10 @@
+# AMD Radeon Support
+
+## Driver Architecture
+AMD GPUs use open-source kernel drivers (`amdgpu`) and the Mesa graphics stack included in Fedora by default.
+
+## Verification
+- Verify Mesa openGL driver: `glxinfo | grep "OpenGL vendor"`
+- Verify RADV Vulkan driver: `vulkaninfo | grep driverName`
+
+No proprietary driver installation is required for Hyprland on AMD GPUs.
@@ -0,0 +1,24 @@
+# Fedora Linux System Conventions
+
+## Package Management
+Fedora utilizes `dnf` as its primary package manager.
+
+```bash
+sudo dnf install <package>
+sudo dnf remove <package>
+sudo dnf check-update
+```
+
+## Desktop Sessions & Wayland
+Fedora Workstation uses Wayland by default with GDM (GNOME Display Manager) or SDDM (KDE).
+Session files are stored in:
+- `/usr/share/wayland-sessions/hyprland.desktop`
+- `/usr/share/xsessions/` (for X11 fallback sessions)
+
+## System Services
+User-level services are managed via systemd:
+```bash
+systemctl --user status pipewire
+systemctl --user status wireplumber
+systemctl --user status xdg-desktop-portal
+```
@@ -0,0 +1,22 @@
+# Hyprland Compositor & Configuration
+
+## Overview
+Hyprland is a dynamic tiling Wayland compositor that does not sacrifice appearance.
+
+## Key Config Locations
+- Main configuration: `~/.config/hypr/hyprland.conf`
+- Additional split configs: `~/.config/hypr/monitors.conf`, `~/.config/hypr/keybinds.conf`
+
+## Common Keybindings (Default Base)
+- `SUPER + RETURN`: Open terminal
+- `SUPER + SPACE`: Application launcher (`wofi` / `rofi`)
+- `SUPER + Q`: Close focused window
+- `SUPER + M`: Exit Hyprland session
+- `SUPER + R`: Reload Hyprland config
+
+## Monitor Syntax
+```text
+monitor=name,resolution@hz,position,scale
+# Example auto monitor setup:
+monitor=,preferred,auto,1
+```
@@ -0,0 +1,8 @@
+# Intel Graphics Support
+
+## Driver Architecture
+Intel Integrated & Arc graphics utilize kernel drivers (`i915` or `xe`) and the Mesa Intel driver (`iris` / `ANV`).
+
+## Verification
+- Verify hardware acceleration: `vainfo`
+- Check active driver: `lspci -nnk | grep -A 2 VGA`
@@ -0,0 +1,29 @@
+# NVIDIA Support on Fedora Wayland / Hyprland
+
+## Recommended Environment Variables
+Some NVIDIA setups may require Wayland environment flags in `~/.config/hypr/hyprland.conf`; confirm them against the installed driver and Hyprland versions:
+
+```text
+env = LIBVA_DRIVER_NAME,nvidia
+env = GBM_BACKEND,nvidia-drm
+env = __GLX_VENDOR_LIBRARY_NAME,nvidia
+env = NVD_BACKEND,direct
+```
+
+For cursor rendering issues, use the Hyprland-native config option (Hyprland v0.36+):
+```text
+cursor {
+    no_hardware_cursors = true
+}
+```
+
+> **Note**: The old `WLR_NO_HARDWARE_CURSORS=1` environment variable is **deprecated** since Hyprland v0.36+. Use the `cursor` config block above instead.
+
+## Drivers on Fedora
+If proprietary drivers are required, use packages maintained for Fedora, such as RPM Fusion's `akmod-nvidia`, after reviewing that repository's setup guidance. This skill does not enable RPM Fusion or install GPU drivers.
+Never use raw `.run` installers from NVIDIA's website as they break Fedora kernel updates.
+
+## Hybrid Graphics (Intel + NVIDIA / AMD + NVIDIA)
+Laptops with dual GPUs may need additional configuration:
+- Check active GPU: `supergfxctl` or `prime-run`
+- Verify render offloading: `__NV_PRIME_RENDER_OFFLOAD=1 glxinfo | grep vendor`
@@ -0,0 +1,18 @@
+# XDG Desktop Portals & PipeWire
+
+## Portals Requirement
+For screen sharing, file open dialogs, and screenshots under Hyprland:
+- `xdg-desktop-portal`
+- `xdg-desktop-portal-hyprland`
+- `xdg-desktop-portal-gtk`
+
+## Service Startup Order
+```text
+Hyprland starts
+  └─ exec-once = dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
+      └─ systemctl --user restart xdg-desktop-portal
+```
+
+## Audio Architecture
+PipeWire handles low-latency audio and video streams (screen sharing). WirePlumber manages session routing.
+Status check: `wpctl status`
@@ -0,0 +1,53 @@
+# Hyprland Troubleshooting Matrix
+
+## Symptom 1: Black Screen on Boot (NVIDIA)
+- **Cause**: Missing Wayland environment variables or modeset issue.
+- **Investigation**: Check the installed NVIDIA driver documentation and whether `nvidia_drm.modeset=1` is active. If the symptom is specifically cursor-related, test `cursor { no_hardware_cursors = true }` in `hyprland.conf`.
+
+## Symptom 2: Screen Sharing Not Working (OBS / Browser)
+- **Cause**: Inactive portal or pipewire environment variable missing.
+- **Fix**: Run:
+  ```bash
+  systemctl --user restart xdg-desktop-portal-hyprland
+  systemctl --user restart xdg-desktop-portal
+  ```
+
+## Symptom 3: No Sound Output
+- **Cause**: PipeWire or WirePlumber service failed.
+- **Fix**: Run:
+  ```bash
+  systemctl --user restart pipewire wireplumber
+  ```
+
+## Symptom 4: Cursor Missing or Invisible (NVIDIA)
+- **Cause**: Hardware cursor rendering not supported by GPU driver.
+- **Fix**: Add to `hyprland.conf`:
+  ```text
+  cursor {
+      no_hardware_cursors = true
+  }
+  ```
+
+## Symptom 5: Apps Blurry or Wrong Scale (XWayland)
+- **Cause**: XWayland apps not using native Wayland rendering.
+- **Fix**: Set environment variables in `hyprland.conf`:
+  ```text
+  env = GDK_BACKEND,wayland,x11
+  env = QT_QPA_PLATFORM,wayland;xcb
+  env = MOZ_ENABLE_WAYLAND,1
+  ```
+
+## Symptom 6: Multi-Monitor Not Working
+- **Cause**: Incorrect or missing monitor config.
+- **Fix**: Check connected monitors with `hyprctl monitors` and configure in `hyprland.conf`:
+  ```text
+  monitor=,preferred,auto,1
+  ```
+
+## Symptom 7: Flickering / Tearing (NVIDIA)
+- **Cause**: Missing DRM kernel module setting.
+- **Investigation**: Confirm the installed driver's recommended DRM settings before changing boot configuration. If its documentation requires these options, review and add them to `/etc/modprobe.d/nvidia.conf`:
+  ```text
+  options nvidia_drm modeset=1 fbdev=1
+  ```
+  Regenerating initramfs with `sudo dracut --force` is a privileged, boot-critical change. Back up the current configuration and obtain explicit approval before running it.
@@ -0,0 +1,9 @@
+# Wayland Session Environment
+
+## Key Environment Variables
+- `XDG_CURRENT_DESKTOP=Hyprland`
+- `XDG_SESSION_TYPE=wayland`
+- `XDG_SESSION_DESKTOP=Hyprland`
+- `MOZ_ENABLE_WAYLAND=1` (Firefox Wayland native mode)
+- `QT_QPA_PLATFORM=wayland;xcb` (Qt app compatibility)
+- `GDK_BACKEND=wayland,x11` (GTK app compatibility)