Skip to content

jedvalley123/nzbhydra

 
 

Repository files navigation

nzbhydra Build Status Average time to resolve an issue Percentage of issues still open

NZBHydra is a meta search for NZB indexers and the "spiritual successor" to NZBmegasearcH. It provides easy access to a number of raw and newznab based indexers.

Features

  • Searches Binsearch, NZBIndex, NZBClub, omgwtfnzbs.org, Womble and most newznab compatible indexers (see https://github.com/theotherp/nzbhydra/issues/20 and https://github.com/theotherp/nzbhydra/wiki/Supported-Search-Types-And-Indexer-Hosts )
  • Search by IMDB, TMDB, TVDB, TVRage and TVMaze ID (including season and episode) and filter by age and size. If an ID is not supported by an indexer it is attempted to be converted (e.g. TMDB to IMDB)
  • Query generation, meaning when you search for a movie using e.g. an IMDB ID a query will be generated for raw indexers. Searching for a series season 1 episode 2 will also generate queries for raw indexers, like s01e02 and 1x02
  • Grouping of results with the same title and of duplicate results, accounting for result posting time, size, group and poster. By default only one of the duplicates is shown. You can provide an indexer score to influence which one that might be
  • Compatible with Sonarr, CP, NZB 360, SickBeard, Mylar and Lazy Librarian (and others)
  • Either proxy the NZBs from the indexers (keeping all X-NZB headers), redirect or use direct links in search results
  • Included function to add results (single or a bunch) to multiple instances of SABnzbd or NZBGet(v13+) and show NFOs where available. Option to decide if links are added as links or the NZBs are uploaded. Select category in GUI or define a default.
  • Statistics on indexers (average response time, share of results, access errors), NZB download history and search history (both via internal GUI and API). Indexers with problems are paused for an increasing time span (like in sonarr)
  • Multi user capabilities so that you can share with your friends but keep the config safe
  • Login by HTTP basic auth or form
  • Define required and forbidden words
  • Fine tune categories with separate required and forbidden words. Completely ignore categories in search results. Map newznab categories to internal categories
  • Reverse proxy compatible. See https://github.com/theotherp/nzbhydra/wiki/Reverse-proxy
  • Dark theme and Bright theme (slightly out of date)

How to run

If you downloaded the source run with Python 2.7.9+. Runs on http://0.0.0.0:5075 by default. See the console output on how to choose the port and host using command line parameters.

If you downloaded the windows release just start with NzbHydraTray.exe. Your default browser should open to the NZBHydra web interface.

You're also free to use the docker container by linuxserver.io. Although I do my best to keep that container nice and working please use their forum for support regarding that container.

Install

Install scripts are provided for Ubuntu upstart based systems in the contrib directory. To install:

sudo cp contrib/defaults /etc/default/nzbhydra
sudo cp contrib/init.ubuntu /etc/init.d/nzbhydra
sudo chmod +x /etc/init.d/nzbhydra
sudo update-rc.d nzbhydra defaults

Edit the default configuration options:

sudo nano /etc/default/nzbhydra

Start the service:

sudo service start nzbhydra

TODO

  • Better query generation
  • More stats?
  • Include comments, rating, etc or link to them
  • Clean up code base
  • Better test coverage so updates don't break stuff
  • ...? Let me know if you have an idea.

To note

As I said query generation is very basic. When selecting a category and doing a search the category will only be used for newznab indexers, for all the raw indexers we will just search using the query. Generating "proper" queries from a category is very hard so you will need to do the filtering visually. Especially with raw indexers that don't support "OR" queries we would need to send a lot of requests to get all the different combinations

Newznab providers don't send information on NFO availablity. If the search results show an NFO link for such an indexer you will need to just try if you can get one.

The program is currently in beta. Upgrading to an new version might cause loss of the configuration, stats or history. The console will contain debug information. It will crash. It is definitely not ready for general use.

Development and how you can help

Generally testing and any bug reports are very welcome.

Any pull requests are also welcome, but I feel I and the program would mostly profit from:

  • Unicode handling. I have no idea what I'm doing.
  • Advice regarding stability, error handling, net code (I program Java by day and it shows) and performance

Please send merge requests to the develop branch!

Contact

Send me an email at TheOtherP@gmx.de or a PM at https://www.reddit.com/user/TheOtherP

Donate

If you like to help me with any running or upcoming costs you're welcome to send money to my bitcoin: 13x4cfm5BNzedsSqdPcexUhAF3cP8LYrsk Or send me an appreciation mail and give the money to someone who needs it, like Doctors without borders

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

About

Meta search for NZB indexers

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 71.1%
  • JavaScript 24.4%
  • CSS 2.8%
  • HTML 1.6%
  • C 0.1%
  • Shell 0.0%