JellyfinWatch 🎬

A Discord bot that monitors your Jellyfin server and displays real-time statistics in a beautiful dashboard. Built with Python and Discord.py.

✨ Features

• 📊 Real-time server statistics
• 📺 Library overview with item counts and episode tracking
• 👥 User activity monitoring
• 🎥 Currently playing content tracking
• ⚙️ Customizable dashboard appearance
• 🔄 Automatic updates every 60 seconds
• 🎨 Beautiful embed design with Jellyfin branding
• 🔒 Secure authentication with Jellyfin API
• 🛠️ Easy setup and configuration
• 🎌 Smart emoji detection for different content types
• 🔄 Cog management system for modular functionality

📸 Screenshots

🚀 Getting Started

Prerequisites

• Python 3.8 or higher
• Discord Bot Token
• Jellyfin Server URL and API Key
• Discord Server with admin permissions

Creating a Discord Bot

1. Go to the Discord Developer Portal
2. Click "New Application" and give it a name
3. Go to the "Bot" tab and click "Add Bot"
4. Under "Privileged Gateway Intents", enable:
   • PRESENCE INTENT
   • SERVER MEMBERS INTENT
   • MESSAGE CONTENT INTENT
5. Click "Reset Token" to get your bot token (save this for later)
6. Go to "OAuth2" → "URL Generator"
7. Select these scopes:
   • bot
   • applications.commands
8. Select these bot permissions:
   • Send Messages
   • Embed Links
   • Attach Files
   • Read Message History
   • Use Slash Commands
9. Copy the generated URL and open it in your browser to invite the bot to your server

Installation

1. Clone the repository:

git clone https://github.com/d3v1l1989/JellyfinWatch.git
cd JellyfinWatch

2. Install dependencies:

pip install -r requirements.txt

3. Configure your environment variables in .env:

DISCORD_TOKEN=your_discord_bot_token
JELLYFIN_URL=your_jellyfin_server_url
JELLYFIN_API_KEY=your_jellyfin_api_key
JELLYFIN_USERNAME=your_jellyfin_username
JELLYFIN_PASSWORD=your_jellyfin_password
CHANNEL_ID=your_discord_channel_id
DISCORD_AUTHORIZED_USERS=user_id1,user_id2
RUNNING_IN_DOCKER=false

4. Run the bot:

python main.py

Docker Installation

1. Create a docker-compose.yml file:

version: '3.8'

services:
  jellywatch:
    image: ghcr.io/d3v1l1989/jellyfinwatch:latest
    container_name: jellywatch
    restart: unless-stopped
    user: "1000:1000"
    environment:
      - DISCORD_TOKEN=${DISCORD_TOKEN}
      - JELLYFIN_URL=${JELLYFIN_URL}
      - JELLYFIN_API_KEY=${JELLYFIN_API_KEY}
      - JELLYFIN_USERNAME=${JELLYFIN_USERNAME}
      - JELLYFIN_PASSWORD=${JELLYFIN_PASSWORD}
      - CHANNEL_ID=${CHANNEL_ID}
      - DISCORD_AUTHORIZED_USERS=${DISCORD_AUTHORIZED_USERS}
      - RUNNING_IN_DOCKER=true
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs

2. Create necessary directories and environment file:

# Create directories
mkdir -p data logs

# Set correct permissions
sudo chown -R 1000:1000 data logs

# Copy and edit environment file
cp .env.example .env
nano .env  # Edit with your configuration

3. Start the container:

docker compose up -d

🛠️ Configuration

The bot uses a .env file for configuration. Here are the available options:

• DISCORD_TOKEN: Your Discord bot token
• JELLYFIN_URL: Your Jellyfin server URL
• JELLYFIN_API_KEY: Your Jellyfin API key
• JELLYFIN_USERNAME: Your Jellyfin username
• JELLYFIN_PASSWORD: Your Jellyfin password
• CHANNEL_ID: The Discord channel ID where the dashboard will be displayed
• DISCORD_AUTHORIZED_USERS: Comma-separated list of Discord user IDs authorized to use admin commands
• RUNNING_IN_DOCKER: Set to "true" if running in Docker, "false" otherwise

🤖 Commands

Admin Commands

• /update_libraries - Update library sections in the dashboard
• /episodes - Toggle display of episode counts in library stats
• /refresh - Refresh the dashboard embed immediately
• /sync - Sync slash commands with Discord
• /load - Load a specific cog (admin only)
• /unload - Unload a specific cog (admin only)
• /reload - Reload a specific cog (admin only)
• /cogs - List all available cogs

🎨 Dashboard Features

The dashboard provides real-time information about your Jellyfin server, including:

• Server status and uptime
• Active streams count
• Library statistics with smart emoji detection
• Episode counts for TV shows and anime libraries
• Beautiful Jellyfin-themed design