51.5-354 updates
This commit is contained in:
buenosairesam
298
docs/INSTALL_STATUS.md
Normal file
298
docs/INSTALL_STATUS.md
Normal file
@@ -0,0 +1,298 @@
|
||||
# Deskmeter GNOME Extension - Installation Status
|
||||
|
||||
**Date**: 2025-12-19
|
||||
**GNOME Shell Version**: 49.2 (Wayland)
|
||||
**Extension UUID**: deskmeter-indicator@local
|
||||
|
||||
---
|
||||
|
||||
## ✅ Installation Complete
|
||||
|
||||
1. **Extension files installed** to `~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/`
|
||||
2. **metadata.json updated** to support GNOME Shell 48 and 49
|
||||
3. **Extension enabled** via dconf (added to enabled-extensions list)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ IMPORTANT: Required Before Testing
|
||||
|
||||
### 1. Log Out and Back In (Wayland Requirement)
|
||||
|
||||
Since you're on Wayland, GNOME Shell **cannot** be restarted without logging out. The extension will **only** load after you log back in.
|
||||
|
||||
```bash
|
||||
# After logging back in, verify extension is loaded:
|
||||
gnome-extensions list --enabled | grep deskmeter
|
||||
```
|
||||
|
||||
Expected output: `deskmeter-indicator@local`
|
||||
|
||||
---
|
||||
|
||||
### 2. Start dmweb Server
|
||||
|
||||
The extension requires the dmweb Flask server running on port 10000:
|
||||
|
||||
```bash
|
||||
# Navigate to dmweb directory
|
||||
cd ~/wdir/dm-gnomeext/../../dm/dmapp/dmweb
|
||||
# or wherever your dmapp directory is located
|
||||
|
||||
# Start the server
|
||||
python3 run.py
|
||||
```
|
||||
|
||||
**Test the API endpoint:**
|
||||
```bash
|
||||
curl http://localhost:10000/api/current_task
|
||||
```
|
||||
|
||||
Expected response:
|
||||
```json
|
||||
{"task_id":"12345678","task_path":"work/default"}
|
||||
```
|
||||
|
||||
If you get an error, dmweb is not running.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 What to Expect
|
||||
|
||||
After logging back in and starting dmweb, you should see:
|
||||
|
||||
- **Extension indicator** in the top-left panel (left of other indicators)
|
||||
- **Initial state**: Shows "loading..." for ~2 seconds
|
||||
- **Normal state**: Displays current task path (e.g., "work/default")
|
||||
- **After workspace switch**: Updates after 2.2 second delay
|
||||
- **Long paths**: Auto-truncates to show last 2 segments (e.g., ".../project/task")
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Extension Not Showing in Panel
|
||||
|
||||
```bash
|
||||
# 1. Check if extension is in enabled list
|
||||
gnome-extensions list --enabled | grep deskmeter
|
||||
|
||||
# 2. If not listed, manually enable again
|
||||
gnome-extensions enable deskmeter-indicator@local
|
||||
|
||||
# 3. Check extension info
|
||||
gnome-extensions info deskmeter-indicator@local
|
||||
|
||||
# 4. View GNOME Shell logs for errors
|
||||
journalctl --user -u org.gnome.Shell@wayland.service -f
|
||||
|
||||
# Filter for deskmeter errors:
|
||||
journalctl --user -u org.gnome.Shell@wayland.service --since "5 minutes ago" | grep -i deskmeter
|
||||
```
|
||||
|
||||
### Shows "offline" Instead of Task
|
||||
|
||||
```bash
|
||||
# Check if dmweb is running
|
||||
curl http://localhost:10000/api/current_task
|
||||
|
||||
# Check if port 10000 is listening
|
||||
ss -tlnp | grep 10000
|
||||
|
||||
# Start dmweb if not running
|
||||
cd ~/wdir/dm-gnomeext/../../dm/dmapp/dmweb
|
||||
python3 run.py
|
||||
```
|
||||
|
||||
### Shows "error" Instead of Task
|
||||
|
||||
This means the API is reachable but returned invalid JSON. Check dmweb logs:
|
||||
|
||||
```bash
|
||||
# In dmweb terminal, you should see the request
|
||||
# Look for Python errors or exceptions
|
||||
```
|
||||
|
||||
### Extension Shows in List but Not Enabled
|
||||
|
||||
```bash
|
||||
# Force enable via dconf
|
||||
dconf write /org/gnome/shell/enabled-extensions \
|
||||
"$(dconf read /org/gnome/shell/enabled-extensions | sed "s/]$/, 'deskmeter-indicator@local']/")"
|
||||
|
||||
# Verify it was added
|
||||
dconf read /org/gnome/shell/enabled-extensions
|
||||
|
||||
# Then log out/in again
|
||||
```
|
||||
|
||||
### Extension Loads but Causes GNOME Shell Issues
|
||||
|
||||
```bash
|
||||
# Disable the extension
|
||||
gnome-extensions disable deskmeter-indicator@local
|
||||
|
||||
# Or remove from dconf
|
||||
dconf write /org/gnome/shell/enabled-extensions \
|
||||
"$(dconf read /org/gnome/shell/enabled-extensions | sed "s/, 'deskmeter-indicator@local'//")"
|
||||
|
||||
# View detailed error logs
|
||||
journalctl --user -u org.gnome.Shell@wayland.service -n 200 | grep -A 10 -i "error.*deskmeter"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Debug Mode: View Live Logs
|
||||
|
||||
```bash
|
||||
# Watch GNOME Shell logs in real-time (useful for debugging)
|
||||
journalctl --user -u org.gnome.Shell@wayland.service -f | grep --line-buffered -i "deskmeter\|error"
|
||||
|
||||
# In another terminal, try interacting with the extension
|
||||
# (switch workspaces, etc.) and watch for log output
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Using GNOME Looking Glass for Debug
|
||||
|
||||
If the extension loads but doesn't work:
|
||||
|
||||
1. Press `Alt+F2`
|
||||
2. Type `lg` and press Enter
|
||||
3. Go to the **Extensions** tab
|
||||
4. Find `deskmeter-indicator@local`
|
||||
5. Check if it shows as **ACTIVE** or has error state
|
||||
6. Click on it to see error details
|
||||
|
||||
---
|
||||
|
||||
## 📝 Extension Files Location
|
||||
|
||||
```
|
||||
~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/
|
||||
├── extension.js (Main extension code)
|
||||
├── metadata.json (Extension metadata with GNOME version support)
|
||||
└── stylesheet.css (Panel label styling)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Update Extension After Code Changes
|
||||
|
||||
```bash
|
||||
# 1. Copy updated files
|
||||
cp -r gnome-extension/deskmeter-indicator@local/* \
|
||||
~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/
|
||||
|
||||
# 2. On Wayland: MUST log out and back in
|
||||
# (No way around this unfortunately)
|
||||
|
||||
# 3. On X11: Can reload with Alt+F2 → r → Enter
|
||||
# (But you're on Wayland)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Quick Test Checklist
|
||||
|
||||
After logging back in:
|
||||
|
||||
- [ ] Extension appears in `gnome-extensions list --enabled`
|
||||
- [ ] dmweb server is running (`curl http://localhost:10000/api/current_task` works)
|
||||
- [ ] Task indicator visible in top panel (left side)
|
||||
- [ ] Shows current task path (not "loading...", "offline", or "error")
|
||||
- [ ] Updates when switching workspaces (after ~2 second delay)
|
||||
|
||||
---
|
||||
|
||||
## 📚 Useful Commands Reference
|
||||
|
||||
```bash
|
||||
# List all extensions
|
||||
gnome-extensions list
|
||||
|
||||
# List enabled extensions
|
||||
gnome-extensions list --enabled
|
||||
|
||||
# Enable extension
|
||||
gnome-extensions enable deskmeter-indicator@local
|
||||
|
||||
# Disable extension
|
||||
gnome-extensions disable deskmeter-indicator@local
|
||||
|
||||
# Get extension info
|
||||
gnome-extensions info deskmeter-indicator@local
|
||||
|
||||
# View current dconf enabled extensions
|
||||
dconf read /org/gnome/shell/enabled-extensions
|
||||
|
||||
# Test dmweb API
|
||||
curl http://localhost:10000/api/current_task
|
||||
|
||||
# Check GNOME Shell version
|
||||
gnome-shell --version
|
||||
|
||||
# View GNOME Shell service status
|
||||
systemctl --user status org.gnome.Shell@wayland.service
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚨 If Everything Fails
|
||||
|
||||
1. **Collect logs:**
|
||||
```bash
|
||||
journalctl --user -u org.gnome.Shell@wayland.service --since "10 minutes ago" > /tmp/gnome-shell-logs.txt
|
||||
```
|
||||
|
||||
2. **Check extension syntax:**
|
||||
```bash
|
||||
cat ~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/extension.js | head -20
|
||||
cat ~/.local/share/gnome-shell/extensions/deskmeter-indicator@local/metadata.json
|
||||
```
|
||||
|
||||
3. **Disable and remove:**
|
||||
```bash
|
||||
gnome-extensions disable deskmeter-indicator@local
|
||||
rm -rf ~/.local/share/gnome-shell/extensions/deskmeter-indicator@local
|
||||
```
|
||||
|
||||
4. **Reinstall from scratch:**
|
||||
```bash
|
||||
cp -r gnome-extension/deskmeter-indicator@local ~/.local/share/gnome-shell/extensions/
|
||||
gnome-extensions enable deskmeter-indicator@local
|
||||
# Log out and back in
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 Project Structure
|
||||
|
||||
```
|
||||
dm-gnomeext/
|
||||
└── gnome-extension/
|
||||
├── deskmeter-indicator@local/
|
||||
│ ├── extension.js ← Main extension code
|
||||
│ ├── metadata.json ← Updated to support GNOME 49
|
||||
│ └── stylesheet.css ← Panel styling
|
||||
├── README.md
|
||||
├── install.sh
|
||||
└── update.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💡 Extension Behavior Notes
|
||||
|
||||
- **Debounce delay**: Extension waits 2.2 seconds after workspace switch before querying API
|
||||
- This allows dmcore (polls every 2s) to detect the change and update MongoDB
|
||||
- **Path truncation**: Paths longer than 40 chars show as `.../last/two`
|
||||
- **Error handling**:
|
||||
- "loading..." = Initial state or pending update
|
||||
- "offline" = Cannot reach API endpoint
|
||||
- "error" = API reachable but invalid response
|
||||
- "no task" = Valid response but no current task
|
||||
|
||||
---
|
||||
|
||||
Good luck! If you see the task indicator after logging back in, it's working perfectly.
|
||||
Reference in New Issue
Block a user