Linux Notes (Arch / Manjaro KDE)

简体中文

📖 Introduction

This repository is a practical guide for Arch-based Manjaro Linux (KDE Plasma). It covers system installation, post-install configuration, software setup, full-stack development tools, Windows compatibility, media workflows, and day-to-day troubleshooting notes.

👉 Online docs: https://duanluan.github.io/linux-notes/

🗂️ Core content index

1. 🚀 System Installation

• Version history: Deepin 23.1 → Xubuntu 24.04.2 → Manjaro (current)
• Boot media: Ventoy + Manjaro KDE Plasma ISO
• Installation flow: BIOS boot / partitioning (swap or hibernation) / time zone and language setup

2. ⚙️ System Configuration (Must Read)

• System basics: faillock policy / update precautions / NTP time sync
• Pacman and mirrors: mirror switching / parallel downloads / temporary ArchLinuxCN enablement
• GitHub and AUR acceleration: axel + makepkg DLAGENTS / URL rewrite / curl and wget wrappers / hosts acceleration
• Input methods and desktop experience: Fcitx5 / DPI scaling / English home directories / global shortcut conflict cleanup / terminal paste ^[[200~ / X11 client limit
• Remote setup: virtual display setup (Intel or AMD GRUB injection + NVIDIA X11 EDID) / black-screen signal reset and rollback

3. 🛠️ Software Installation (classified by purpose)

💻 System and Essentials

• Base packages: base-devel / GPU drivers / X11 session recovery
• Package management: yay / paru / debtap / Spark Store
• Performance and stability: Zram + swappiness / EarlyOOM
• Input methods: Fcitx5 + Rime setup and model configuration
• Terminal and productivity: Tmux / Nushell / fzf / zoxide
• Wine ecosystem: deepin-wine8 or 10-stable + spark-dwine-helper
• Fonts and browsers: Chinese and coding fonts / Edge / Chrome / Tor Browser

🔧 Tools and Productivity

• Networking and proxy: FlClash / Clash Verge / Clash Party / Brook / proxychains / EasyTier / cpolar / ngrok
• Virtualization and compatibility: VMware / VirtualBox / Docker (Buildx, Compose, Portainer) / WinBoat / xDroid / Wine / Proton-GE / Wine runners
• Writing, knowledge, and utility tools: Sublime Text / Typora / Obsidian / Pandoc / XMind / Draw.io / XnView MP / uTools / Rubick
• Screen capture and recording: Snipaste / Flameshot / eSearch / SimpleScreenRecorder / OBS / StartLive
• Downloads and sync: FDM / Gopeed / qBittorrent EE / Transmission / Xunlei / Synology Drive / Syncthing / LocalSend / CopyQ
• Remote desktop tools: RustDesk / ToDesk / Sunlogin / TeamViewer / AnyDesk / Remote Desktop Manager + FreeRDP
• Other utilities: Geekbench / KeePassXC / GnuPG + GpgFrontend / Sunshine + Moonlight / VLC / SMPlayer / PeaZip / Calibre

🤖 AI and Assistants

• LLM desktop clients: Cherry Studio / Chatbox
• Coding agents and desktops: OpenCode / Claude Code / Codex CLI / OpenAI Codex Desktop / Cline CLI
• CLI management and context tools: CC Switch / rtk / Cockpit Tools
• AI IDEs: Cursor / Windsurf / Antigravity / Kiro / Trae / Qoder

👨‍💻 Full-Stack Development Environment

• General tools: Git (SSH keys / identity / useful defaults) / act for local GitHub Actions runs / Rebased
• Frontend and mobile: nvm + Node.js + pnpm + nrm / Flutter (FVM) / Android Studio / VS Code / WeChat Developer Tools
• JetBrains tools: Toolbox App / IntelliJ IDEA / WebStorm / PyCharm
• Backend and system-level tooling: Java (JDK, Maven, Gradle, JMeter) / Python (pipx, uv, cnpip) / Rust (Cargo mirror setup)
• Database and API tooling: DataGrip / Navicat / DBeaver EE / Redis Desktop / Offset Explorer / Apifox / Apipost / Postman
• Terminal clients: MobaXterm / WindTerm / WoTerm

🎨 Image, Video, and Audio Editing

• Image and design: GIMP + PhotoGIMP / Krita / Blender / Figma Linux / Aseprite
• Video post-production: DaVinci Resolve (including Studio setup) / Kdenlive / HandBrake
• Audio editing: Audacity

🎮 Games and Entertainment

• Platforms: Steam / Heroic / Lutris
• Utilities: Watt Toolkit (Steam++)
• Minecraft: HMCL (scaling fix) / LauncherX

💬 Communication and Office

• Messaging and meetings: WeChat / QQ / DingTalk / Feishu / Tencent Meeting
• Email: Thunderbird
• Office suites: WPS Office (365 or CN) / LibreOffice / OnlyOffice
• Music players: NetEase Cloud Music (including UnblockNeteaseMusic) / SPlayer / YesPlayMusic / VutronMusic / go-musicfox / MoeKoeMusic / LX Music
• Video and cloud storage: Bilibili client / PiliPlus / Baidu Netdisk

---

4. 🚑 Troubleshooting

• Wi-Fi password prompt after KDE wallet is closed
• KDE panel freezes
• Forgot root password (Live CD + chroot)
• AUR "validity check" failed (PKGBUILD SKIP)
• Bluetooth missing from the tray / missing firmware fix
• mesonbuild is missing (upgrade conflict handling)
• X11 ↔ Wayland input method environment variable conflict handling

5. 🐞 Known Bugs

• Offset Explorer text overlay
• Snipaste Wayland shortcut key conflict
• Ctrl+H cannot input Chinese under Edge Wayland

6. 🧹 Software Uninstallation

• Package Management: pacman/yay/paru -Rns cascade cleanup
• Targeted Cleanup: VMware Workstation Pro / WinBoat (container + config) / Firefox leftovers

7. 🧩 Tips & Tricks

• Meta + mouse: move/zoom window
• Auto-start management at boot
• Turn off animation effects
• Open multiple directories in a single Dolphin window with tabs

---

🤝 Contribution and feedback

Issues and PRs are welcome if you want to add more practical setup notes.

📄 License

This project is for reference. Rights to some scripts or software belong to their original authors.

Licensed under the Apache License, Version 2.0.

Copyright © 2025-PRESENT duanluan