Skip to content

FEATURES.md

Latest commit

 

History

History
203 lines (174 loc) · 6.92 KB

FEATURES.md

File metadata and controls

203 lines (174 loc) · 6.92 KB

OpsDec - Feature Overview

100% vibe coded - Built with AI assistance and good vibes 🤖✨

Current Features (v0.2.0)

📊 Real-Time Monitoring

  • Live Activity Dashboard - See who's watching what, right now
  • WebSocket Updates - Real-time updates without page refresh
  • Session Details - View playback progress, device info, and streaming quality
  • Multi-User Tracking - Monitor multiple users simultaneously

📈 Statistics & Analytics

  • Dashboard Overview

    • Total plays and active sessions counter
    • 30-day play history chart
    • Statistics card with monthly metrics
    • Top watchers and listeners with avatars
    • Popular movies, TV shows, and audiobooks
    • User dropdowns showing who watched/listened to each item
    • Server branding with official logos

  • User Statistics

    • Individual user profiles
    • Watch time tracking
    • Play counts by media type
    • Recent activity timeline
    • Most watched content per user
    • Sortable user table (username, watch time, listen time, last seen)
    • Server breakdown with logos
    • Expandable rows showing per-server statistics

  • Watch History

    • Complete playback history
    • Advanced search functionality (title, show, username)
    • Multi-filter system (user, server, media type)
    • Flexible pagination (25, 50, 100, 250 items per page)
    • Sortable columns (all 7 columns with visual indicators)
    • Server identification with logos
    • Completion percentage tracking

🔌 Server Integration

Plex Support

  • ✅ Active session monitoring
  • ✅ User tracking
  • ✅ Library access
  • ✅ Recently added media
  • ✅ Session state (playing/paused/buffering)
  • ✅ Progress tracking
  • ✅ Metadata retrieval

Emby Support

  • ✅ Active session monitoring
  • ✅ User tracking
  • ✅ Library access
  • ✅ Recently added media
  • ✅ Session state (playing/paused/buffering)
  • ✅ Progress tracking
  • ✅ Metadata retrieval

Audiobookshelf Support

  • ✅ Active session monitoring
  • ✅ User tracking
  • ✅ Library access
  • ✅ Recently added media
  • ✅ Session state (playing/paused/buffering)
  • ✅ Progress tracking
  • ✅ Metadata retrieval

Sappho Support

  • ✅ Active session monitoring
  • ✅ User tracking
  • ✅ Library access
  • ✅ Session state (playing/paused/buffering)
  • ✅ Progress tracking
  • ✅ Metadata retrieval
  • ✅ User mapping support

Multi-Server

  • ✅ Monitor Plex, Emby, Audiobookshelf, and Sappho simultaneously
  • ✅ Unified dashboard for all servers
  • ✅ Aggregated statistics
  • ✅ Per-server activity breakdown
  • ✅ Server-specific branding (logos and icons)

🎨 User Interface

  • Tautulli-Inspired Design - Familiar, polished dark theme
  • Fully Mobile Responsive - Optimized layouts for mobile, tablet, and desktop
  • Real-Time Updates - Live activity refresh
  • Interactive Charts - Visual play history
  • Media Thumbnails - Poster art and backdrop images
  • Progress Indicators - Visual playback progress bars
  • Settings UI - Manage server configurations through web interface
  • Environment Badge - Visual indicators for env-configured servers
  • User Mapping Interface - Consolidate users across different servers

🗄️ Data Management

  • SQLite Database - Lightweight, file-based storage
  • Session Tracking - Detailed playback sessions
  • Historical Data - Complete watch history
  • User Profiles - Cached user information
  • Library Stats - Media library metadata

🐳 Deployment

  • Docker Support - Production-ready container
  • Docker Compose - Easy multi-container setup
  • Environment Configuration - Flexible setup via env vars
  • Volume Persistence - Data survives container restarts
  • Health Checks - Built-in container health monitoring

🔧 Configuration

  • Flexible Setup - Configure servers via environment variables or UI
  • Dual Configuration Methods - Environment variables (Docker) or web UI
  • Settings Management - Add, edit, and delete servers through web interface
  • Environment Variable Display - View env-configured servers in UI (read-only)
  • Adjustable Polling - Customize activity check frequency
  • Production Mode - Optimized for production deployment

Upcoming Features

🎯 Phase 2 (Next Release)

  • Audiobookshelf Integration - Monitor audiobook listening ✅ COMPLETED
  • Advanced Filtering - Filter history by date, media type, etc. ✅ COMPLETED
  • Search Functionality - Search media and users ✅ COMPLETED
  • Mobile Responsive - Fully optimized mobile interface ✅ COMPLETED
  • Sappho Integration - Monitor Sappho audiobook server ✅ COMPLETED
  • User Mapping - Consolidate users across servers ✅ COMPLETED
  • Export Data - CSV/JSON export for statistics
  • Date Range Filtering - Filter history by custom date ranges

🎯 Phase 3

  • Notifications - Discord, Email, Webhook support
  • User Authentication - Multi-user dashboard access
  • Custom Widgets - Configurable dashboard widgets
  • Theme Options - Light mode, custom themes
  • API Documentation - Interactive API docs

🎯 Phase 4

  • Jellyfin Support - Add Jellyfin server support
  • Performance Metrics - Server performance tracking
  • Bandwidth Monitoring - Track streaming bandwidth
  • Geolocation - Track viewing locations
  • Custom Reports - Generate custom statistics reports

🎯 Future Considerations

  • Mobile App - Native iOS/Android app
  • Newsletter - Weekly/monthly stats via email
  • Multi-Language - i18n support
  • Plugins System - Extensible plugin architecture
  • Advanced Analytics - ML-based recommendations
  • Social Features - Share stats with friends
  • Parental Controls - Content monitoring for families

Feature Comparison

Feature Tautulli OpsDec
Plex Support ✅ ✅
Emby Support ❌ ✅
Audiobookshelf ❌ ✅
Real-time Monitoring ✅ ✅
Watch History ✅ ✅
User Statistics ✅ ✅
Notifications ✅ 🔮 Planned
Docker Support ✅ ✅
Modern UI ✅ ✅
Multi-Server ❌ ✅
Open Source ✅ ✅
Python-based ✅ ❌ (Node.js)
React Frontend ❌ ✅

Technical Features

Backend

  • RESTful API architecture
  • WebSocket real-time communication
  • SQLite with WAL mode
  • Async/await patterns
  • Error handling and logging
  • Health check endpoints
  • CORS support

Frontend

  • React 18 with hooks
  • Client-side routing
  • State management
  • API client abstraction
  • Utility functions for formatting
  • Responsive design
  • Icon library integration

DevOps

  • Multi-stage Docker builds
  • Docker Compose configuration
  • Environment-based config
  • Production optimization
  • Security best practices
  • Automated health checks

Note: This is an active development project. Features marked with 🔮 are planned for future releases.