Jackett/README.md

273 lines
9.9 KiB
Markdown
Raw Normal View History

2017-02-02 12:01:47 +00:00
# Jackett
2015-08-25 20:30:32 +00:00
2017-01-21 05:36:04 +00:00
[![GitHub issues](https://img.shields.io/github/issues/Jackett/Jackett.svg?maxAge=60&style=flat-square)](https://github.com/Jackett/Jackett/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/Jackett/Jackett.svg?maxAge=60&style=flat-square)](https://github.com/Jackett/Jackett/pulls)
[![Github Releases](https://img.shields.io/github/downloads/Jackett/Jackett/total.svg?maxAge=60&style=flat-square)](https://github.com/Jackett/Jackett/releases/latest)
[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/jackett.svg?maxAge=60&style=flat-square)](https://hub.docker.com/r/linuxserver/jackett/)
2015-10-29 20:07:11 +00:00
This project is a new fork and is recruiting development help. If you are able to help out please contact us.
2015-08-25 20:30:32 +00:00
2017-01-20 12:50:50 +00:00
Jackett works as a proxy server: it translates queries from apps ([Sonarr](https://github.com/Sonarr/Sonarr), [Radarr](https://github.com/Radarr/Radarr), [SickRage](https://sickrage.github.io/), [CouchPotato](https://couchpota.to/), [Mylar](https://github.com/evilhero/mylar), 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.
2015-08-25 20:30:32 +00:00
2016-09-18 14:31:30 +00:00
Developer note: The software implements the [Torznab](https://github.com/Sonarr/Sonarr/wiki/Implementing-a-Torznab-indexer) (with [nZEDb](https://github.com/nZEDb/nZEDb/blob/dev/docs/newznab_api_specification.txt) category numbering) and [TorrentPotato](https://github.com/RuudBurger/CouchPotatoServer/wiki/Couchpotato-torrent-provider) APIs.
2015-11-18 20:00:26 +00:00
2015-08-25 20:30:32 +00:00
#### Supported Systems
* Windows using .NET 4.5
2017-01-29 14:06:31 +00:00
* Linux and OSX using Mono 4 (mono 3 is no longer supported).
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
### Supported Public Trackers
* EZTV
2017-03-10 19:53:31 +00:00
* Il Corsaro Nero <!-- maintained by bonny1992 -->
* Isohunt
* KickAssTorrent
* KickAssTorrent (kat.how clone)
* LimeTorrents
2017-03-18 07:37:15 +00:00
* Nyaa <!-- maintained by bonny1992 -->
* RARBG
2017-02-24 17:02:51 +00:00
* ShowRSS
* Sky torrents
* The Pirate Bay
2017-03-10 19:59:33 +00:00
* TNTVillage <!-- maintained by bonny1992 -->
2017-02-13 19:34:45 +00:00
* TorrentProject
2017-02-08 18:47:10 +00:00
* Torrentz2
2017-02-01 12:00:19 +00:00
### Supported Private Trackers
2017-01-24 17:45:34 +00:00
* 2 Fast 4 You
2017-01-03 18:01:05 +00:00
* 7tor
2016-01-09 02:08:39 +00:00
* Abnormal
2017-02-27 11:54:23 +00:00
* Acid-Lounge
2015-11-18 20:00:26 +00:00
* AlphaRatio
* Andraste
2015-11-18 20:00:26 +00:00
* AnimeBytes
* AnimeTorrents
2017-01-17 16:12:01 +00:00
* AOX
* Apollo (XANAX)
2017-02-13 19:15:15 +00:00
* ArabaFenice
2017-02-06 18:27:20 +00:00
* AsianDVDClub
2017-03-07 14:33:08 +00:00
* Audiobook Torrents
2015-11-18 20:00:26 +00:00
* Avistaz
2017-02-21 13:59:23 +00:00
* BakaBT [![(invite needed)][inviteneeded]](#)
2015-11-18 20:00:26 +00:00
* bB
* Best Friends
2015-11-18 20:00:26 +00:00
* BeyondHD
2017-03-28 18:02:23 +00:00
* BIGTorrent
2016-09-07 15:29:56 +00:00
* Bit-City Reloaded
2015-11-18 20:00:26 +00:00
* BIT-HDTV
2016-12-29 14:31:12 +00:00
* BitHQ
2017-01-05 18:14:41 +00:00
* BitHUmen
2015-11-18 20:00:26 +00:00
* BitMeTV
2017-02-21 13:59:23 +00:00
* BitSoup [![(invite needed)][inviteneeded]](#)
2017-01-12 18:13:36 +00:00
* Bitspyder
2016-11-27 18:07:33 +00:00
* Blu-bits
2017-01-20 17:34:24 +00:00
* BlueBird
2017-02-21 13:59:23 +00:00
* BroadcastTheNet [![(invite needed)][inviteneeded]](#)
2015-11-18 20:00:26 +00:00
* BTN
2017-02-06 17:26:18 +00:00
* BTNext
2017-02-27 18:37:32 +00:00
* Carpathians
2016-12-30 14:20:11 +00:00
* CHDBits
2017-03-22 18:58:27 +00:00
* Cinematik
2017-03-22 19:00:43 +00:00
* Cinemageddon
2016-09-18 14:27:21 +00:00
* CinemaZ
2017-03-22 19:03:10 +00:00
* Classix
2017-03-01 12:39:53 +00:00
* CZTeam
2015-11-20 10:50:33 +00:00
* DanishBits
2016-12-20 11:39:57 +00:00
* DataScene
2015-11-20 10:50:33 +00:00
* Demonoid
2017-02-08 14:21:40 +00:00
* Diablo Torrent
* DigitalHive
2017-03-08 18:00:28 +00:00
* Dragon World (DTW)
2017-03-08 19:47:21 +00:00
* Dragonworld Reloaded
2017-01-20 16:35:44 +00:00
* Dream Team
2016-11-21 18:07:09 +00:00
* EoT-Forum
2017-01-17 14:01:39 +00:00
* eStone
2016-11-23 09:19:38 +00:00
* Ethor.net (Thor's Land)
2016-12-21 17:18:25 +00:00
* FANO.IN
2015-11-18 20:00:26 +00:00
* FileList
2017-01-11 17:59:11 +00:00
* Freedom-HD
2015-11-18 20:00:26 +00:00
* Freshon
2017-02-08 18:46:22 +00:00
* FullMixMusic
2016-09-18 14:22:59 +00:00
* FunFile
2017-01-10 17:52:13 +00:00
* FunkyTorrents
2016-04-01 11:39:37 +00:00
* Fuzer
2017-01-30 17:04:18 +00:00
* GFXPeers
2016-09-06 11:50:16 +00:00
* Ghost City
2017-03-07 16:28:02 +00:00
* GigaTorrents [![(invite needed)][inviteneeded]](#)
2017-02-21 13:59:23 +00:00
* GimmePeers <!-- maintained by jamesb2147 -->
* GODS [![(invite needed)][inviteneeded]](#)
2016-12-15 08:32:11 +00:00
* Gormogon
2017-03-07 15:31:32 +00:00
* Greek Team
2017-01-17 16:49:43 +00:00
* Hardbay
2016-11-15 08:17:55 +00:00
* HD4Free
2015-11-18 20:00:26 +00:00
* HD-Space
* HD-Torrents
2017-03-22 19:06:00 +00:00
* HDBC
2016-12-23 16:35:30 +00:00
* HDClub
2017-01-30 17:22:42 +00:00
* HDHome
2017-02-13 15:44:37 +00:00
* HDPter
2017-01-03 12:21:07 +00:00
* HDSky
2017-03-23 04:43:27 +00:00
* HDTorrents.it
* Hebits
2017-01-20 17:07:50 +00:00
* Hon3y HD
2015-11-20 10:50:33 +00:00
* Hounddawgs
* House-of-Torrents
2017-01-20 17:07:50 +00:00
* Hyperay
2016-12-19 18:51:54 +00:00
* ICE Torrent
2015-11-18 20:00:26 +00:00
* Immortalseed
2017-01-12 11:18:22 +00:00
* Infinity-T
2017-01-27 14:44:40 +00:00
* inPeril
2017-02-02 16:47:16 +00:00
* Insane Tracker
2015-11-18 20:00:26 +00:00
* IPTorrents
2017-01-26 15:03:36 +00:00
* JPopsuki
2017-02-02 14:12:53 +00:00
* Kapaki
2017-03-22 19:02:22 +00:00
* Karagarga
2017-01-30 18:33:25 +00:00
* Le Paradis Du Net
2017-01-18 18:59:35 +00:00
* LinkoManija
2017-02-02 15:51:19 +00:00
* LosslessClub
2017-01-03 13:54:36 +00:00
* M-Team - TP
2017-01-18 20:43:22 +00:00
* Magico
2017-02-09 16:17:36 +00:00
* Majomparádé
* Mononoké-BT
2015-11-20 10:50:33 +00:00
* MoreThanTV
2016-04-20 10:14:55 +00:00
* MyAnonamouse
* myAmity
2016-12-09 16:01:01 +00:00
* MySpleen
2017-01-12 16:22:34 +00:00
* Nachtwerk
2015-11-20 10:50:33 +00:00
* NCore
2016-12-09 15:21:56 +00:00
* NetHD
2017-01-12 14:31:53 +00:00
* New Real World
2015-11-18 20:00:26 +00:00
* NextGen
2017-02-21 13:59:23 +00:00
* Norbits [![(invite needed)][inviteneeded]](#) <!-- added by DiseaseNO but no longer maintained? -->
2016-12-18 10:36:11 +00:00
* notwhat.cd
* Passione Torrent <!-- maintained by bonny1992 -->
2017-02-21 13:59:23 +00:00
* PassThePopcorn [![(invite needed)][inviteneeded]](#)
* PirateTheNet
2017-01-28 05:50:51 +00:00
* PiXELHD
2017-02-14 12:23:05 +00:00
* PolishSource
2017-03-14 12:30:23 +00:00
* PolishTracker
2016-08-18 10:55:58 +00:00
* Pretome
2015-11-18 20:00:26 +00:00
* PrivateHD
2017-03-13 18:08:25 +00:00
* Psytorrents
2017-03-01 16:30:58 +00:00
* PTFiles
2016-12-17 16:33:34 +00:00
* QcTorrent
2017-02-20 14:42:44 +00:00
* Redacted (PassTheHeadphones)
2017-02-23 18:07:31 +00:00
* RevolutionTT
2017-01-12 17:32:33 +00:00
* Rockhard Lossless
2017-02-02 12:01:47 +00:00
* RoDVD
2017-01-05 16:36:49 +00:00
* RuTracker
2015-11-18 20:00:26 +00:00
* SceneAccess
2017-03-20 19:13:08 +00:00
* SceneFZ
2015-11-18 20:00:26 +00:00
* SceneTime
2016-12-05 14:14:16 +00:00
* SDBits
2016-12-05 17:01:11 +00:00
* Secret Cinema
2016-11-02 18:18:33 +00:00
* Shareisland
2017-01-10 18:06:47 +00:00
* ShareSpaceDB
2017-03-06 18:31:35 +00:00
* Shazbat
2017-01-11 17:17:40 +00:00
* Shellife
2017-02-23 18:07:31 +00:00
* SpeedCD
2017-01-06 18:04:46 +00:00
* Superbits
2017-03-28 18:00:04 +00:00
* The Empire
2016-11-20 12:22:59 +00:00
* The Horror Charnel
2016-11-15 18:37:13 +00:00
* The New Retro
2016-11-29 13:20:23 +00:00
* The Shinning
2017-02-15 19:56:28 +00:00
* The-Torrents
2015-11-18 20:00:26 +00:00
* TehConnection
2016-12-08 05:38:18 +00:00
* TenYardTracker
* Torrent Network
2016-11-19 11:57:13 +00:00
* Torrent Sector Crew
* Torrent411
2016-11-29 18:35:49 +00:00
* TorrentBD
2015-11-18 20:00:26 +00:00
* TorrentBytes
2017-03-07 16:59:39 +00:00
* TorrentCCF [![(invite needed)][inviteneeded]](#)
2015-11-18 20:00:26 +00:00
* TorrentDay
* TorrentHeaven
2017-01-31 10:01:08 +00:00
* TorrentHR
2017-01-06 16:07:52 +00:00
* Torrenting
2015-11-18 20:00:26 +00:00
* TorrentLeech
2016-12-20 18:43:08 +00:00
* Torrents.Md
2016-09-07 12:00:25 +00:00
* Torrent-Syndikat
2016-12-10 12:49:39 +00:00
* ToTheGlory
2016-12-27 18:13:01 +00:00
* TranceTraffic
2016-05-14 12:44:49 +00:00
* TransmitheNet
2015-11-18 20:00:26 +00:00
* TV Chaos UK
2016-11-19 10:33:00 +00:00
* TV-Vault
2016-12-20 12:20:12 +00:00
* u-Torrent
2016-11-20 12:58:29 +00:00
* UHDBits
2017-03-08 14:28:08 +00:00
* Ultimate Gamer Club
2017-01-26 11:38:14 +00:00
* ULTRAHDCLUB
2017-03-28 18:01:03 +00:00
* Waffles
2017-02-21 13:59:23 +00:00
* World-In-HD [![(invite needed)][inviteneeded]](#)
2016-11-01 21:46:21 +00:00
* WorldOfP2P
* x264
2016-01-03 20:40:59 +00:00
* XSpeeds
2016-04-03 18:31:44 +00:00
* Xthor
2017-02-21 13:59:23 +00:00
* Xtreme Zone
2017-03-07 18:05:30 +00:00
* Ztracker
2015-08-25 20:30:32 +00:00
2017-02-21 13:59:23 +00:00
Trackers marked with [![(invite needed)][inviteneeded]](#) have no active maintainer and are missing features or are broken. If you have an invite for them please send it to kaso1717 -at- gmail.com to get them fixed/improved.
2017-02-01 12:00:19 +00:00
## Installation on Windows
2015-09-21 18:42:17 +00:00
We recommend you install Jackett as a Windows service using the supplied installer. You may also download the zipped version if you would like to configure everything manually.
2015-09-21 18:42:17 +00:00
To get started with using the installer for Jackett, follow the steps below:
1. Download the latest version of the Windows installer, "Jackett.Installer.Windows.exe" from the [releases](https://github.com/Jackett/Jackett/releases/latest) page.
2. When prompted if you would like this app to make changes to your computer, select "yes".
3. If you would like to install Jackett as a Windows Service, make sure the "Install as Windows Service" checkbox is filled.
4. Once the installation has finished, check the "Launch Jackett" box to get started.
5. Navigate your web browser to: http://127.0.0.1:9117
6. You're now ready to begin adding your trackers and using Jackett.
When installed as a service the tray icon acts as a way to open/start/stop Jackett. If you opted to not install it as a service then Jackett will run its web server from the tray tool.
Jackett can also be run from the command line if you would like to see log messages (Ensure the server isn't already running from the tray/service). This can be done by using "JackettConsole.exe" (for Command Prompt), found in the Jackett data folder: "%ProgramData%\Jackett".
2015-09-21 18:42:17 +00:00
2017-02-01 12:00:19 +00:00
## Installation on Linux/OSX
2017-02-26 08:09:32 +00:00
1. Install [Mono 4](http://www.mono-project.com/download/#download-lin) or better (version 4.8 is recommended)
2017-02-17 14:56:11 +00:00
* Follow the instructions on the mono website and install the `mono-devel` and the `ca-certificates-mono` packages.
* On Red Hat/CentOS/openSUSE/Fedora the `mono-locale-extras` package is also required.
2015-08-25 20:30:32 +00:00
2. Install libcurl:
2017-03-02 07:25:47 +00:00
* Debian/Ubunutu: `apt-get install libcurl4-openssl-dev`
* Redhat/Fedora: `yum install libcurl-devel`
2015-08-25 20:30:32 +00:00
* For other distros see the [Curl docs](http://curl.haxx.se/dlwiz/?type=devel).
2017-02-01 11:25:24 +00:00
3. Download and extract the latest `Jackett.Binaries.Mono.tar.gz` release from the [releases page](https://github.com/Jackett/Jackett/releases) and run Jackett using mono with the command `mono --debug JackettConsole.exe`.
Detailed instructions for [Ubuntu 14.x](http://www.htpcguides.com/install-jackett-on-ubuntu-14-x-for-custom-torrents-in-sonarr/) and [Ubuntu 15.x](http://www.htpcguides.com/install-jackett-ubuntu-15-x-for-custom-torrents-in-sonarr/)
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
## Installation using Docker
2017-01-21 05:36:04 +00:00
Detailed instructions are available at [LinuxServer.io Jackett Docker](https://hub.docker.com/r/linuxserver/jackett/). The Jackett Docker is highly recommended, especially if you are having Mono stability issues or having issues running Mono on your system eg. QNAP, Synology. Thanks to [LinuxServer.io](https://linuxserver.io)
2017-02-01 12:00:19 +00:00
## Installation on Synology
2015-12-06 19:48:10 +00:00
Jackett is available as beta package from [SynoCommuniy](https://synocommunity.com/)
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
## Troubleshooting
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
* __Command line switches__
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
You can pass various options when running via the command line, see --help for details.
2015-08-25 20:30:32 +00:00
* __Unable to connect to trackers with invalid SSL certificates__
2015-08-25 20:30:32 +00:00
You can disable certificate validation using the `--IgnoreSslErrors true` option but it's not recommended to use it as it enables Man-in-the-middle attacks on your connections.
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
* __Enable logging__
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
You can get additional logging with the command line switches `-t -l` or by enabeling `Enhanced logging` via the web interface.
Please post logs if you are unable to resolve your issue with these switches ensuring to remove your username/password/cookies.
The logfiles (log.txt/updater.txt) are stored in `%ProgramData%\Jackett` on Windows and `~/.config/Jackett/` on Linux/OSX.
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
## Creating an issue
2015-11-20 10:37:46 +00:00
Please supply as much information about the problem you are experiencing as possible. Your issue has a much greater chance of being resolved if logs are supplied so that we can see what is going on. Creating an issue with '### isn't working' doesn't help anyone to fix the problem.
2017-02-01 12:00:19 +00:00
## Contributing
2017-01-23 14:55:09 +00:00
All contributions are welcome just send a pull request. Jackett's framework allows our team (and any other volunteering dev) to implement new trackers in an hour or two. If you'd like support for a new tracker but are not a developer then feel free to leave a request on the [issues page](https://github.com/Jackett/Jackett/issues). It is recommended to use Visual studio 2015 when making code changes in this project.
2015-08-25 20:30:32 +00:00
2017-02-01 12:00:19 +00:00
## Screenshots
2015-08-25 20:30:32 +00:00
2016-12-05 17:43:04 +00:00
![screenshot](https://i.imgur.com/0d1nl7g.png "screenshot")
2017-02-21 13:59:23 +00:00
[inviteneeded]: https://raw.githubusercontent.com/Jackett/Jackett/master/.github/label-inviteneeded.png