Add KDE Plasma installation guide and revert documentation
This commit is contained in:
nearxos
210
chromium-setup/KDE-INSTALLATION-SUMMARY.md
Normal file
210
chromium-setup/KDE-INSTALLATION-SUMMARY.md
Normal file
@@ -0,0 +1,210 @@
|
||||
# KDE Plasma Installation Summary
|
||||
|
||||
## Installation Status: ✅ COMPLETE
|
||||
|
||||
**Date**: 2026-01-09
|
||||
**Device**: Raspberry Pi Compute Module 4 (8GB RAM)
|
||||
**Previous Desktop**: LXDE with Openbox
|
||||
**New Desktop**: KDE Plasma (X11)
|
||||
|
||||
---
|
||||
|
||||
## What Was Installed
|
||||
|
||||
### Core Packages
|
||||
- ✅ `kde-plasma-desktop` - KDE Plasma desktop environment
|
||||
- ✅ `maliit-keyboard` - On-screen keyboard for touchscreen
|
||||
- ✅ Additional KDE components and dependencies
|
||||
|
||||
### Available Sessions
|
||||
- ✅ **Plasma (X11)** - `/usr/share/xsessions/plasmax11.desktop`
|
||||
- ✅ **LXDE/Openbox** - Still available for revert
|
||||
- ✅ **RPD-X** - Original Raspberry Pi desktop
|
||||
|
||||
---
|
||||
|
||||
## Current System State
|
||||
|
||||
### Session Manager Status
|
||||
- **Current Default**: `/usr/bin/startx-rpd` (LXDE - unchanged)
|
||||
- **KDE Available**: `/usr/bin/startplasma-x11` (priority 40)
|
||||
- **LXDE Available**: `/usr/bin/lxsession` (priority 49)
|
||||
|
||||
### Backup Created
|
||||
- ✅ Desktop configuration backed up to: `~/desktop-backup/`
|
||||
- ✅ Session manager configuration saved
|
||||
|
||||
---
|
||||
|
||||
## How to Use KDE Plasma
|
||||
|
||||
### First Time Setup
|
||||
|
||||
1. **Log out of current session**
|
||||
```bash
|
||||
# Or simply reboot
|
||||
sudo reboot
|
||||
```
|
||||
|
||||
2. **At login screen:**
|
||||
- Look for session/desktop selector (usually top-right corner)
|
||||
- Click and select **"Plasma (X11)"** or **"plasmax11"**
|
||||
- Enter credentials and log in
|
||||
|
||||
3. **First boot into KDE:**
|
||||
- KDE will initialize (may take 30-60 seconds first time)
|
||||
- You may see a welcome screen - you can skip it
|
||||
- Desktop will appear with KDE panel
|
||||
|
||||
4. **Configure for Touchscreen:**
|
||||
- System Settings > Input Devices > Virtual Keyboard
|
||||
- Enable "Show on-screen keyboard when needed"
|
||||
- System Settings > Display and Monitor
|
||||
- Set scale to 125% or 150% for better touch targets
|
||||
- System Settings > Workspace Behavior > Desktop Effects
|
||||
- Disable heavy effects for better performance
|
||||
|
||||
---
|
||||
|
||||
## Chromium Autostart
|
||||
|
||||
Your existing Chromium autostart configuration will work with KDE:
|
||||
- ✅ File: `~/.config/autostart/chromium-kiosk.desktop`
|
||||
- ✅ Script: `~/start-chromium.sh`
|
||||
|
||||
Chromium will start automatically when KDE desktop loads.
|
||||
|
||||
---
|
||||
|
||||
## Reverting to LXDE
|
||||
|
||||
### Quick Method (Recommended)
|
||||
1. Log out
|
||||
2. At login screen, select "Openbox" or "RPD-X" session
|
||||
3. Log in
|
||||
|
||||
### Using Revert Script
|
||||
```bash
|
||||
# Copy revert-to-lxde.sh to device
|
||||
scp revert-to-lxde.sh pi@10.130.60.253:~/
|
||||
ssh pi@10.130.60.253 "chmod +x ~/revert-to-lxde.sh && ~/revert-to-lxde.sh"
|
||||
```
|
||||
|
||||
### Manual Revert
|
||||
```bash
|
||||
sudo update-alternatives --config x-session-manager
|
||||
# Select: /usr/bin/startx-rpd or /usr/bin/lxsession
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Performance Expectations
|
||||
|
||||
### RAM Usage
|
||||
- **LXDE**: ~200-300MB
|
||||
- **KDE Plasma**: ~400-800MB
|
||||
- **Available**: ~6.7GB (plenty of headroom)
|
||||
|
||||
### CPU Usage
|
||||
- **Idle**: Low (< 5%)
|
||||
- **Active**: Moderate (10-30%)
|
||||
- **Heavy tasks**: May see some lag on Cortex-A72
|
||||
|
||||
### Boot Time
|
||||
- **LXDE**: ~20-30 seconds
|
||||
- **KDE Plasma**: ~30-45 seconds (first boot may be longer)
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### KDE Won't Start
|
||||
```bash
|
||||
# Check if installed
|
||||
dpkg -l | grep kde-plasma
|
||||
|
||||
# Check available sessions
|
||||
ls /usr/share/xsessions/
|
||||
|
||||
# Try manual start (if logged in via SSH)
|
||||
DISPLAY=:0 startplasma-x11
|
||||
```
|
||||
|
||||
### Performance Issues
|
||||
- Disable desktop effects: System Settings > Workspace Behavior > Desktop Effects
|
||||
- Reduce animations: System Settings > Workspace Behavior > General Behavior
|
||||
- Use X11 (already configured) instead of Wayland
|
||||
|
||||
### Touchscreen Issues
|
||||
```bash
|
||||
# Check touchscreen device
|
||||
xinput list
|
||||
|
||||
# Calibrate if needed
|
||||
sudo apt-get install xinput-calibrator
|
||||
xinput_calibrator
|
||||
```
|
||||
|
||||
### Chromium Not Starting
|
||||
- Check autostart file: `cat ~/.config/autostart/chromium-kiosk.desktop`
|
||||
- Check script: `cat ~/start-chromium.sh`
|
||||
- Manual test: `DISPLAY=:0 ~/start-chromium.sh`
|
||||
|
||||
---
|
||||
|
||||
## Files and Locations
|
||||
|
||||
### Configuration Files
|
||||
- KDE config: `~/.config/plasma*`
|
||||
- KDE panel: `~/.config/plasma-org.kde.plasma.desktop-appletsrc`
|
||||
- Window manager: `~/.config/kwinrc`
|
||||
- Session: `/usr/share/xsessions/plasmax11.desktop`
|
||||
|
||||
### Backup Location
|
||||
- `~/desktop-backup/` - Original LXDE configuration
|
||||
|
||||
### Documentation
|
||||
- `KDE-INSTALLATION-GUIDE.md` - Full installation and revert guide
|
||||
- `revert-to-lxde.sh` - Automated revert script
|
||||
- `TOUCHSCREEN-DESKTOP-OPTIONS.md` - Desktop environment comparison
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. ✅ **Reboot the device**
|
||||
```bash
|
||||
ssh pi@10.130.60.253 "sudo reboot"
|
||||
```
|
||||
|
||||
2. ✅ **Select KDE at login**
|
||||
- Choose "Plasma (X11)" from session selector
|
||||
|
||||
3. ✅ **Configure touchscreen settings**
|
||||
- Enable on-screen keyboard
|
||||
- Adjust UI scaling
|
||||
- Disable heavy effects
|
||||
|
||||
4. ✅ **Test Chromium autostart**
|
||||
- Verify Chromium starts in fullscreen
|
||||
- Check if it properly fills the screen
|
||||
|
||||
---
|
||||
|
||||
## Support
|
||||
|
||||
If you encounter issues:
|
||||
1. Check logs: `journalctl -xe`
|
||||
2. Check X session: `~/.xsession-errors`
|
||||
3. Verify packages: `dpkg -l | grep kde`
|
||||
4. Review documentation: `KDE-INSTALLATION-GUIDE.md`
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
|
||||
- KDE Plasma is installed but **not set as default** - you choose at login
|
||||
- LXDE is still available and can be selected at any time
|
||||
- All original configurations are backed up
|
||||
- Chromium autostart will work with both desktops
|
||||
- Performance should be acceptable on Pi 4 with 8GB RAM
|
||||
Reference in New Issue
Block a user