nefarious

Web application that automates downloading Movies and TV Shows.
08 May 20202428

nefarious

nefarious is a web application that automatically downloads Movies and TV Shows.

Build Status Docker Pulls

It aims to combine features of Sonarr, Radarr and Ombi.

It uses Jackett and Transmission under the hood. Jackett searches for torrents and Transmission does the downloading.

Features:

  • Search TV & Movies
  • Auto download TV (individual episodes or full seasons)
  • Auto download Movies
  • Discover TV & Movies (by popularity, genres, year etc)
  • Find similar TV & Movies
  • Find recommended TV & Movies
  • Manually search and download Jackett's torrent results
  • Supports blacklisting torrent results (i.e permanently avoid a bad/fake torrent)
  • Supports quality profiles (i.e only download 1080p Movies and 720p TV)
  • Supports whether to download media with hardcoded subtitles or not
  • Supports user defined keywords to filter results (i.e ignore "x265", "hevc" codecs)
  • Auto download TV & Movies once it's released (routinely scans for newly released content)
  • Monitor transmission results & status from within the app
  • Self/auto updating application so you're always up-to-date
  • Supports multiple users and permission groups (i.e admin users and regular users)
  • Responsive Design (looks great on desktops, tablets and small devices like phones)
  • Movie trailers
  • Automatically renames media
  • Supports multiple languages (TMDB supports internationalized Titles, Descriptions and Poster artwork)
  • Webhook support (i.e can post to Slack, Telegram etc when media downloads)
  • Support user requests (i.e an unprivileged user must "request" to watch something)

Contents

Demo

Screenshots

Login

Search

TV Result

Movie Result

Movie Custom Quality Profile

Download Status

Discover

Wanted

Watching

Settings

Search Manual

Mobile Friendly

Dependencies

See DEPENDENCIES.md

Setup

You must have docker and docker-compose already installed. See dependencies.

Part 1

Clone the nefarious repository and start all the Docker containers:

git clone https://github.com/lardbit/nefarious.git
cd nefarious
docker-compose up -d

NOTE: the first time you bring up nefarious can take a few minutes.

Your default local URLs for all the various services will be:

See Part 2 for finalizing the configuration.

ARM devices

See ARM.md for arm-based architectures like the raspberry pi, odroid, pine etc.

Part 2

The default nefarious user/password is admin/admin. On first login you will be directed to the main nefarious settings and asked to configure your Jackett API token. Jackett's host in the main settings should remain jackett and the port should remain 9117. Copy your API Token from Jackett into the appropriate nefarious section. Don't forget to also add some indexers in Jackett to track your preferred content, and be sure to test them to see that they're working. Some popular examples are The Pirate Bay, 1337x, RARBG.

Transmission's host should remain transmission and port should remain 9091. It's possible to configure it with a username and password, but defaults to keeping them both blank. Entering both username and password in the nefarious settings should only be done if the Transmission settings of 'transmission-settings.json' were also configured for your desired user/pass. The Download Subdirectories can also be configured here as well. Bear in mind these are subdirectories, and that we will be configuring the parent download directory shortly. Leaving these as they are will be perfectly fine.

Global Language, Keyword Exclusions, Subtitles, and Picture Quality can also be configured here. TV and Movie quality profiles can be changed independently of each other if you wish to have differing profiles. Finally, user accounts and passwords can be added or modified as well. Feel free to change the defaults now if you so desire, or add additional users on your PC/system. Once all of your Settings are to your preference, first click Save then be sure to Verify Settings.

Transmission Configuration

In order to change the download folder (which is set to /tmp/transmission by default) look for the docker-compose.yml file in your nefarious folder and edit

/tmp/transmission:/downloads

to be like

/Your/Desired/Folder:/downloads

Leave the right side alone and only change the left side. The structure of the folder path is the same for both Linux and Windows. Once you've made your changes, save your docker-compose.yml file, open a terminal to your nefarious folder and type

docker-compose up -d

to update and apply your updates.

There is no default transmission user/pass, but feel free to edit the transmission-settings.json beforehand following the official settings to make any changes you'd like.

NOTE if you make any changes to transmission-settings.json you'll have to recreate the transmission container for the changes to take place:

docker-compose up -d --force-recreate transmission

Usage

See USAGE.md.

Troubleshooting

See TROUBLESHOOTING.md.

Development

See DEVELOPMENT.md.