Discord-Jellyseerr Bot

This Discord bot integrates with Jellyseerr to provide commands for searching, requesting, and getting notifications about media in your Jellyseerr instance.

Features

Search for movies and TV shows
Get detailed information about media
Request movies and TV shows to be added to your library
Get recommendations for similar content
Simple interface for interacting with your Jellyseerr instance

Installation

Clone this repository:

git clone https://github.com/yourusername/discord-jellyseerr.git
cd discord-jellyseerr

Install the required dependencies:
```
pip install -r requirements.txt
```
Copy the .env.example file to .env and edit it with your configuration:
```
cp .env.example .env
```

Edit the .env file with your Discord bot token and Jellyseerr API details:

DISCORD_BOT_TOKEN=your_discord_bot_token_here
JELLYSEERR_URL=http://your-jellyseerr-instance:5055
JELLYSEERR_EMAIL=your_jellyseerr_email@example.com
JELLYSEERR_PASSWORD=your_jellyseerr_password

Run the bot:
```
python main.py
```
Alternatively, use the provided shell script:
```
./run.sh
```

Setting up the Discord Bot

Go to the Discord Developer Portal
Create a new application and set up a bot
Enable the following Privileged Gateway Intents:
- MESSAGE CONTENT INTENT
Invite the bot to your server with the following permissions:
- Send Messages
- Embed Links
- Attach Files
- Read Message History
- Use External Emojis
- Add Reactions

Jellyseerr Authentication

This bot uses a local Jellyseerr user account for authentication:

Create or use an existing local user account in Jellyseerr
Provide the email address and password in the .env file
The bot will automatically authenticate and maintain the session

Using a dedicated user account provides better tracking of requests and actions performed by the bot.

Important: Jellyseerr requires the email address for login, not the username.

Commands

Search & Discovery

!search <query> - Search for movies and TV shows
!movie <id> - Get detailed information about a movie
!tv <id> - Get detailed information about a TV show
!trending - Show trending movies and TV shows

Requests

!request movie <id> - Request a movie
!request tv <id> [seasons] - Request a TV show (all or specific seasons)
!requests [status] [page] - List media requests

Other

!help - Show the help message
!status - Check Jellyseerr server status

Webhooks

For notifications about request approvals, media availability, and other events, Jellyseerr provides built-in webhook support for Discord. Configure these directly in the Jellyseerr settings panel under "Notifications".

This bot does not handle notifications, as the native webhook integration provides a more reliable solution with customizable notifications.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

3.1 KiB Raw Blame History