How to use Jackett with Medusa

Introduction

From the official Jackett app github:

Jackett works as a proxy server: it translates queries from apps (Sonarr, Radarr, SickRage, CouchPotato, Mylar, Lidarr, DuckieTV, qBittorrent, Nefarious etc) into tracker-site-specific http queries, parses the html response, then sends results back to the requesting software. This allows for getting recent uploads (like RSS) and performing searches. Jackett is a single repository of maintained indexer scraping & translation logic - removing the burden from other apps.

In this guide, we will be using Jackett for scraping torrents into Medusa app

Installation

Go to your client area, click the Installable Apps section and add both applications via +Add Application button. You can find a more detailed guide regarding 1-click installation of the apps here

Jackett

Click Go to Application and a new window will be opened. After your successful login, then main page of the Jackett app will appear. On the top right corner you can find your API Key that will be needed afterwards

1) Click +Add indexer to add your indexer of your choice

Note: The API Key credential shown at the screenshot is temporary and used only for this guide. Your key will -obviously- differ than the one shown here.

2) Let's say we want to use Torrentz2 . Scroll downwards and click the wrench icon at the right section.

This will open up the settings of that indexer. You don't have to write down the codes for the categories as Medusa offers to automatically import them.
Press Okay button afterwards to add the indexer.

Your will be automatically navigated to Jackett's main screen where you can see that the indexer was successfully added.

NOTE: Don't close the window yet, as it will be needed later for the API Key and URL field at the Medusa app

Medusa

Assuming you have being already using the Medusa app, this guide will only show how to add and use the custom indexer. However, if you are new here, there is an excellent GUIDE regarding the installation and proper setting up of the app.

At the main page of Medusa, hover your mouse on the gears icon and choose Search settings from the dropdown menu

- Search settings

1) At the new window, click NZB Search tab, and tick the enable NZB search providers if you are not already using them. Choose Black hole for sending .nzb files to, and choose the appropriate folder location. You can copy-paste the path from this guide or else browse and navigate to that same folder.

/home/user/torrents_blackhole

Note: You HAVE to choose that folder or else your torrents won't be automatically added.

Click Save changes button at the bottom left corner

- Search providers

2) Hover your mouse at the gears icon at the top right corner, this time choosing Search Providers from the dropdown menu

Since you will be using your custom providers via Jackett app, head to the last tab Configure Jackett Providers.
Select --add new provider -- from the dropdown menu, and give it a label of your choice (e.g. Jackett (Torrentz2) ). Now for the rest two fields, you need to head back to your Jackett app.
Click the Copy Torznab Feed button in order to copy the link and paste it at the Site URL back at the Medusa app.
Similarly, copy from the top right corner the API Key and paste it at the corresponding field back at the Medusa app

After inputting all fields, click the Add button:

Select which search categories you want (for faster configuration, you can select all of them) and click the Select Categories . Don't forget to finalize your settings by clicking the Save Changes button at the bottom left corner!

3) Now your custom search provider is set. You will be automatically redirected to the first tab Provider Priorities in order to enable your custom provider

Your new provider should appear at the bottom of the list. Tick to enable it and click Save changes button

4) After finishing up with the Provider Priorities (first tab), click the Provider Options (second tab) at the top left corner of the Search Providers. Configure your provider and enable the search options as in the screenshot. Again, at the end click Save changes button at the bottom left corner.

You are now ready for adding your favourite shows via your custom indexer!