nefarious
nefarious is a web application that automatically downloads Movies and TV Shows.
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:
- nefarious: http://localhost:8000
- Jackett: http://localhost:9117
- Transmission: http://localhost:9091
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.