在 Moode Audio 中实现开机自动启动 `startx`

在 Moode Audio 中实现开机自动启动 `startx`（例如用于运行图形界面应用），可以通过以下步骤配置：

---

**1. 确保系统支持图形环境**
Moode Audio 默认基于 Raspberry Pi OS Lite（无图形界面），需先安装必要组件：
```bash
# 更新系统
sudo apt update

# 安装 X Window 基础组件和工具
sudo apt install -y xserver-xorg xinit x11-xserver-utils

# 安装浏览器（可选）
sudo apt install -y chromium-browser
```

---

**2. 配置自动启动图形界面**

**方法一：通过 `~/.bash_profile` 自动登录并启动**
此方法适用于 用户自动登录到终端 后触发 `startx`。

1. 启用用户自动登录  
   编辑 `/etc/systemd/system/getty@tty1.service.d/override.conf`：
   ```bash
   sudo mkdir -p /etc/systemd/system/getty@tty1.service.d
   sudo nano /etc/systemd/system/getty@tty1.service.d/override.conf
   ```
   添加以下内容：
   ```ini
   [Service]
   ExecStart=
   ExecStart=-/sbin/agetty --autologin pi --noclear %I $TERM
   ```

2. 配置 `~/.bash_profile`  
   编辑用户配置文件：
   ```bash
   nano ~/.bash_profile
   ```
   添加以下内容（仅当在 `tty1` 且未启动 X 时运行）：
   ```bash
   if [ -z "$DISPLAY" ] && [ "$(tty)" = "/dev/tty1" ]; then
       exec startx -- :0 -nocursor
   fi
   ```

---

**方法二：通过 systemd 服务实现开机启动**
直接通过 systemd 管理 X 会话，适合更稳定的后台服务。

1. 创建用户级 systemd 服务文件  
   ```bash
   nano ~/.config/systemd/user/startx-autostart.service
   ```
   添加以下内容：
   ```ini
   [Unit]
   Description=Auto Start X11 Session
   After=network.target

[Service]
   Type=simple
   # 设置环境变量
   Environment="DISPLAY=:0"
   Environment="XAUTHORITY=/home/pi/.Xauthority"
   # 启动 X 会话并执行命令（例如浏览器）
   ExecStart=/usr/bin/startx /etc/X11/Xsession -- -keeptty -nolisten tcp :0 vt1

[Install]
   WantedBy=default.target
   ```

2. 启用并启动服务  
   ```bash
   systemctl --user daemon-reload
   systemctl --user enable startx-autostart.service
   systemctl --user start startx-autostart.service
   ```

---

**方法三：通过 `/etc/rc.local` 启动（传统方式）**
编辑 `/etc/rc.local`，在 `exit 0` 前添加：
```bash
# 以用户 pi 身份启动 X
su - pi -c "startx &"
```

---

**3. 配置 X 启动后执行的命令**
创建或修改 `~/.xinitrc`，定义启动图形界面后的动作：
```bash
nano ~/.xinitrc
```
示例（启动全屏浏览器）：
```bash
#!/bin/sh
# 禁用屏保和电源管理
xset s off
xset -dpms

# 启动 Chromium 浏览器
exec chromium-browser --app=http://localhost:8080 --kiosk --noerrdialogs --disable-infobars
```

赋予执行权限：
```bash
chmod +x ~/.xinitrc
```

---

**4. 解决常见问题**

**权限不足导致 X 启动失败**
• 将用户 `pi` 加入必要用户组：

```bash
  sudo usermod -aG tty,video pi
  ```
• 重启或重新登录使组权限生效。

**X Server 锁文件冲突**
如果提示 `Server is already active for display 0`，清理锁文件：
```bash
sudo rm /tmp/.X0-lock
```

**查看日志定位问题**
• Xorg 日志：

```bash
  cat /var/log/Xorg.0.log
  ```
• Systemd 服务日志：

```bash
  journalctl --user -u startx-autostart.service -f
  ```

---

**最终效果**
• 系统启动后自动进入 `tty1` 并运行 `startx`，加载 `~/.xinitrc` 中定义的应用（如全屏浏览器）。

• 适用于 Moode Audio 扩展显示功能（如播放器控制面板）。

通过以上步骤，即可在 Moode Audio 中实现开机自动启动图形界面。