112 lines
3.1 KiB
Markdown
112 lines
3.1 KiB
Markdown
# Troubleshooting Guide - Jellycleanarr TUI
|
|
|
|
## Data Verification ✅
|
|
|
|
The file **`jellycleanarr_data_dump.txt`** contains a complete dump of all API requests and responses.
|
|
|
|
**Key findings**:
|
|
- ✅ API connection working
|
|
- ✅ 12 users found
|
|
- ✅ 3 libraries found
|
|
- ✅ Playback stats queries working
|
|
- ✅ Data formatted correctly for tables
|
|
|
|
Example data that should display:
|
|
```
|
|
HRiggs: 346 plays, 3h 9m watch time
|
|
TV: 204 plays, 5d 1h 16m watch time
|
|
Landman - s02e05: 13 plays
|
|
```
|
|
|
|
## Issue: Blank TUI
|
|
|
|
The TUI header, tabs, and footer render, but the content area (tables) is blank.
|
|
|
|
### Fixes Applied
|
|
|
|
1. **API Client** - Fixed data format conversion from list-of-lists to dictionaries
|
|
2. **StatsTable** - Moved column initialization to proper lifecycle method
|
|
3. **CSS** - Added explicit height configuration
|
|
|
|
### Things to Try
|
|
|
|
#### 1. Run with Textual Developer Console
|
|
|
|
Open two terminals:
|
|
|
|
**Terminal 1:**
|
|
```bash
|
|
.venv/Scripts/python.exe -m textual console
|
|
```
|
|
|
|
**Terminal 2:**
|
|
```bash
|
|
.venv/Scripts/python.exe -m jellycleanarr
|
|
```
|
|
|
|
This will show you internal logs and help diagnose rendering issues.
|
|
|
|
#### 2. Check Terminal Compatibility
|
|
|
|
Some terminals don't render TUIs properly. Try running in:
|
|
- Windows Terminal (recommended)
|
|
- PowerShell
|
|
- Git Bash
|
|
- WSL terminal
|
|
|
|
#### 3. Verify Data Loading
|
|
|
|
Run the verification script:
|
|
```bash
|
|
.venv/Scripts/python.exe -c "import asyncio; from src.jellycleanarr.services.stats_service import StatsService; from src.jellycleanarr.api.client import JellyfinClient; from src.jellycleanarr.config import settings; async def test(): c = JellyfinClient(settings.jellyfin_address, settings.jellyfin_api_key); s = StatsService(c); m, l = await s.get_user_stats(limit=3); print(f'Users: {[(u.username, u.total_plays) for u in m]}'); await c.close(); asyncio.run(test())"
|
|
```
|
|
|
|
#### 4. Try Running with --dev Flag
|
|
|
|
```bash
|
|
.venv/Scripts/python.exe -m jellycleanarr --dev
|
|
```
|
|
|
|
#### 5. Check for Rendering in Specific Area
|
|
|
|
Try pressing:
|
|
- `r` to refresh
|
|
- `1`, `2`, `3` to switch tabs
|
|
- Resize the terminal window
|
|
|
|
Sometimes TUI elements need a refresh or resize to render properly.
|
|
|
|
#### 6. Update Textual
|
|
|
|
Current version: `^0.83.0`
|
|
|
|
Try updating to latest:
|
|
```bash
|
|
uv pip install --upgrade textual
|
|
```
|
|
|
|
## If Still Blank
|
|
|
|
The data is definitely loading correctly (verified in dump file). The issue is likely:
|
|
|
|
1. **CSS/Layout**: Tables exist but are hidden/collapsed
|
|
2. **Textual Bug**: Version-specific rendering issue
|
|
3. **Terminal**: Terminal emulator doesn't support required features
|
|
|
|
### Alternative: Export Data
|
|
|
|
Since the API is working, you could:
|
|
1. Use the dump file for analysis
|
|
2. Create a web-based version instead of TUI
|
|
3. Export data to CSV/JSON for external viewing
|
|
|
|
## Files for Review
|
|
|
|
- `jellycleanarr_data_dump.txt` - Complete API data dump (1590 lines)
|
|
- `DEBUGGING_NOTES.md` - Technical details on fixes applied
|
|
- `FIXES.md` - Summary of all fixes
|
|
|
|
## Contact/Support
|
|
|
|
If the issue persists, the problem is likely environmental (terminal, Textual version, etc.) rather than with the code logic, since all data fetching and processing is confirmed working.
|