Configuring Overseerr - thomst08/requestrr GitHub Wiki

Configuring Overseerr

Overseerr can be used as a download client for both Movies and TV Shows.



Connecting Requestrr to Overseerr

#1 Disable CSRF in Overseerr

CSRF in Overseerr needs to be disabled for Requestrr to fully interact with Overseer, to do this, open Overseerr in your browser, then login.
Go to the Settings page and then make sure CSRF protection is disabled


#2 Copy your Overseerr API Key

Before closing Overseerr, copy the API key found in the settings page.


#3 Paste in your Overseerr API Key

Open Requstrr, go into the section you would like to connect Overseerr to ("Movie" or "TV Show"), select "Overseerr" in the "Download Client", paste the API key in the "API Key" field.


#4 Enter your Overseerr Servers IP

Enter the host or IP address for Overseerr Server (without the http://).
Note: If you are using Requestrr in a docker container, any localhost addresses will not work, you should use your servers local IP address in this situation (e.g. 192.168.0.10)


#5 Test your Settings

Now click on the Test Settings button, it should say that everything is good

If not, then the error message will tell you what to do.


#6 Save your Settings

Click on the "Save Changes" button at the bottom of the page to save the work we've done so far.

That's it, the bot should now be correctly connected to Overseerr!


Configuring Extra Settings

Configuring Permissions

Default Overseerr User ID

Requestrr supports per user permission coming from Overseerr, this means that you can link all of your discord users to Overseerr users in order to manage your quotas/permissions/etc, in Overseerr, and the bot will respect those settings.

Whenever a request is made through the bot and the bot is unable to find a "linked" user, it will then use permissions from the Default Overseerr User ID configured in Requestrr's web portal.

First get the ID of your Overseerr user, this can be found by going into "Users" and clicking "Edit" on your selected user or simply clicking on the user. The ID is found under their user-name at the top:

When in the "Movies" or "TV Show" section, enter the ID into the "Default Overseerr User ID for requests":

If you don't manually specify a default Overseerr User ID, then the bot will auto-approve all requests.


How to link a discord user to an Overseerr user

#1 Enable Developer Mode in Discord

Go into Discord and enable developer mode, to do this, go into "User Settings", "Advanced" under the "App Settings" section, from here, you can enable "Developer Mode":


#2 Copy Discord User ID

Find the Discord user that you wish to link to Overseerr, right click their name in Discord and click "Copy User ID":


#3 Paste User ID into Overseerr

Now go in Overseerr, create or go into "Edit Settings" for the user you want to connect, make sure you are on the "General" tab and paste the User ID that you got from Discord in the "Discord User ID" field:


#4 Save the user

Click "Save Changes" down the bottom.
That's it, now whenever that Discord user makes a request through the bot, the permissions/quotas you set for the Overseerr user will be applied.


Enabling Issues submissions

Requestrr allows for the submission of "Issues" to Overseerr, this enables users to report issues with linked media.
To do this simple enable "Use Issues" in the "Movies" or "TV Shows" section/s.

Users will be able to submit issues using the /issue command. Users will need to enter the category they wish to submit to with the media's name, e.g. /issue movie deadpool or /issue tv south park.
Upon submitting, the user will need to select from already managed media for any matching names to make sure the correct media is selected, then chose the type of issue, the user can make a submission and fill in a report of the issue.

Issues will be reported in Overseerr and can be viewed there.
Note: Issues do not link to the user who created the issue.

⚠️ **GitHub.com Fallback** ⚠️