Jackett/README.md

24 KiB

Jackett

Jackett

GitHub issues GitHub pull requests Build Status GitHub Releases Docker Pulls Discord

This project is a new fork and is recruiting development help. If you are able to help out please contact us.

Please see our troubleshooting and contributing guidelines before submitting any issues or pull requests

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.

Developer note: The software implements the Torznab (with nZEDb category numbering) and TorrentPotato APIs.

Supported Systems

Supported Public Trackers
  • 1337x
  • 7torrents
  • ACG.RIP
  • ACGsou (36DM)
  • Anidex
  • Anime Tosho
  • AniRena
  • AniSource
  • AudioBook Bay (ABB)
  • BigFANGroup
  • BitRu
  • BT.etree
  • BTDB
  • BTDIGG
  • BTSOW
  • CiliPro (LIAORENCILI)
  • ConCen
  • Corsaro.red
  • cpasbien
  • cpasbienClone
  • Demonoid
  • dmhy
  • E-Hentai
  • EliteTorrent.biz
  • Epizod
  • ETTV
  • EXT Torrents
  • ExtraTorrent.cd
  • EZTV
  • Filebase
  • FireBit
  • Frozen Layer
  • GamesTorrents
  • GkTorrent
  • GloDLS
  • HDReactor
  • Horrible Subs
  • IBit
  • Idope
  • Il CorSaRo Blu
  • Il Corsaro Nero
  • Internet Archive (archive.org)
  • Isohunt2
  • iTorrent
  • KickAssTorrent (kat.li)
  • KickAssTorrent (KATcr)
  • Legit Torrents
  • LePorno
  • LimeTorrents
  • LinuxTracker
  • MacTorrents
  • Magnet4You
  • MagnetDL
  • MejorTorrent
  • Monova
  • MovCr
  • MoviesDVDR
  • MyPornClub
  • NewPCT (aka: tvsinpagar, descargas2020, torrentlocura, torrentrapid, tumejortorrent, pctnew, etc)
  • Newstudio
  • Nitro
  • NNTT
  • NoNaMe Club (NNM-Club)
  • Nyaa-Pantsu
  • Nyaa.si
  • OneJAV
  • OxTorrent
  • ParnuXi
  • PC-torrent
  • PiratBit
  • Pirateiro
  • Pornforall
  • PornLeech
  • PornoLive
  • PornoRip
  • PornoTor
  • ProPorn
  • ProStyleX
  • Rapidzona
  • RARBG
  • RinTor
  • RinTorNeT
  • Rus-media
  • RuTor
  • RuTracker.RU
  • seleZen
  • Sexy-Pics
  • shokweb
  • ShowRSS
  • SkyTorrentsClone
  • Solid Torrents
  • sosulki
  • sukebei-Pantsu
  • sukebei.Nyaa.si
  • The Pirate Bay (TPB)
  • Tokyo Tosho
  • TopNow
  • Torlock
  • TOROS
  • Torrent Bomb (토렌트봄)
  • Torrent Downloads (TD)
  • Torrent Oyun indir
  • torrent-pirat
  • Torrent4You
  • Torrent9
  • Torrent9Clone
  • TorrentDownload
  • TorrentFunk
  • TorrentGalaxy (TGx)
  • TorrentKitty
  • TorrentParadise
  • TorrentProject2
  • TorrentQuest
  • Torrents.csv
  • Torrentv
  • TorrentView (토렌트뷰)
  • Torrentz2
  • Torrentz2k
  • truPornolabs
  • Underverse
  • UnionDHT
  • XFSUB
  • xxxAdultTorrent
  • xxxtor
  • xxxtorrents
  • YourBittorrent
  • YTS.ag
  • zetorrents
  • Zooqle
Supported Semi-Private Trackers
  • AniDUB
  • ArenaBG
  • BaibaKo
  • BookTracker
  • CasStudioTV
  • CzTorrent
  • cool-torrent
  • Darmowe torrenty
  • Deildu
  • DimeADozen (EzTorrent)
  • DXP (Deaf Experts)
  • EniaHD
  • Erzsebet
  • Erzsebet.pl
  • ExKinoRay
  • ExtremlymTorrents
  • Gay-Torrents.net
  • Gay-Torrents.org
  • HD Dolby
  • HamsterStudio
  • IV-Torrents
  • KinoNaVse100
  • Kinorun
  • Kinozal
  • Korsar
  • LostFilm.tv
  • MVGroup Forum
  • MVGroup Main
  • Marine Tracker
  • Metal Tracker
  • MuziekFrabriek
  • NetHD (VietTorrent)
  • PornoLab
  • PussyTorrents
  • Rainbow Tracker
  • RiperAM
  • RockBox
  • RuTracker
  • Rustorka
  • SDkino
  • Sharewood
  • SkTorrent
  • SkTorrent-org
  • SoundPark
  • Toloka.to
  • Torrent-Explosiv
  • Torrents-Local
  • TribalMixes
  • Union Fansub
  • YggTorrent (YGG)
  • Ztracker
Supported Private Trackers
  • 0day.kiev
  • 1ptbar
  • 2 Fast 4 You
  • 32Pages (32P)
  • 3ChangTrai (3CT)
  • 3D Torrents (3DT)
  • 3evils
  • 4thD (4th Dimension)
  • 52PT
  • 720pier
  • AST4u
  • Abnormal
  • Acid Lounge (A-L)
  • Aftershock
  • Aidoru!Online
  • Aither
  • AlphaRatio (AR)
  • AmigosShareClub
  • AnimeBytes (AB)
  • AnimeTorrents (AnT)
  • Anthelion
  • Araba Fenice (Phoenix)
  • ArabP2P
  • Asgaard (AG)
  • AsianCinema
  • Asylum Share
  • AudioNews (AN)
  • Audiobook Torrents (ABT + RNS)
  • AvistaZ (AsiaTorrents)
  • Awesome-HD (AHD)
  • BIGTorrent
  • BIT-HDTV
  • BJ-Share (BJ)
  • BRObits
  • BTGigs (TG)
  • BTNext (BTNT)
  • BTSCHOOL
  • Back-ups
  • BaconBits (bB)
  • BakaBT
  • BeiTai
  • BeyondHD (BHD)
  • BiT-TiTAN
  • Bibliotik
  • BigTower
  • Bit-City Reloaded
  • BitHUmen
  • BitTorrentFiles
  • BiTTuRK
  • Bithorlo (BHO)
  • Bitspyder
  • BlueBird
  • Blutopia (BLU)
  • Boxing Torrents
  • Brasil Tracker
  • BroadCity
  • BroadcasTheNet (BTN)
  • BrokenStones
  • BWTorrents
  • CCFBits
  • CGPeers
  • CHDBits
  • Carp-Hunter
  • Carpathians
  • CartoonChaos (CC)
  • CasaTorrent
  • ChannelX
  • ChileBT
  • Cinecalidad
  • CinemaMovies
  • CinemaZ (EuTorrents)
  • Cinemageddon
  • Cinematik
  • Classix
  • Concertos
  • CrazyHD
  • CrazySpirits
  • CrnaBerza
  • DXDHD
  • DanishBits (DB)
  • Dark-Shadow
  • Dark Tracker
  • Das Unerwartete
  • DataScene (DS)
  • DesiReleasers
  • DesiTorrents
  • Diablo Torrent
  • DICMusic
  • DigitalCore
  • DigitalHive
  • DivTeam
  • DivxTotal
  • DocumentaryTorrents (DT)
  • Dragonworld Reloaded
  • EbookParadijs
  • Ebooks-Shares
  • EfectoDoppler
  • Elite-Tracker
  • Empornium (EMP)
  • EpubLibre
  • eShareNet
  • eStone (XiDER, BeLoad)
  • Ethor.net (Thor's Land)
  • ExoticaZ (YourExotic)
  • ExtremeBits
  • ExtremeTorrents
  • FANO.IN
  • Fantastic Heaven
  • Femdomcult
  • FileList (FL)
  • Film-Paleis
  • FinElite (FE)
  • FinVip
  • FocusX
  • Fou-Du-Cinema
  • FreeTorrent
  • FullMixMusic
  • FunFile (FF)
  • FunkyTorrents (FT)
  • Fuzer (FZ)
  • GAYtorrent.ru
  • GFXPeers
  • Galeriens (LaPauseTorrents)
  • GazelleGames (GGn)
  • Generation-Free
  • GigaTorrents
  • GimmePeers (formerly ILT)
  • GiroTorrent
  • GreekDiamond
  • Greek Team
  • HD-Bits.com
  • HD-Forever (HDF)
  • HD-Olimpo
  • HD-Only (HDO)
  • HD-Space (HDS)
  • HD-Spain
  • HD-Torrents (HDT)
  • HD4FANS
  • HDArea (HDA)
  • HDBits
  • HDCenter
  • HDChina (HDWing)
  • HDC (HDCiTY)
  • HDCity
  • HDDisk (HDD)
  • HDHome (HDBigger)
  • HDME
  • HDRoute
  • HDSky
  • HDStreet
  • HDTime
  • HDTorrents.it
  • HDTurk
  • HDU
  • HDZone
  • HaiDan
  • HQSource (HQS)
  • HacheDe
  • Hebits
  • HellasTZ
  • Hon3y HD
  • Horror Site
  • HuSh
  • ICE Torrent
  • IPTorrents (IPT)
  • ImmortalSeed (iS)
  • Immortuos
  • Insane Tracker
  • JPopsuki
  • JPTV
  • Karagarga
  • Keep Friends
  • LastFiles
  • Le Saloon
  • LeChaudron
  • LeagueHD
  • LearnFlakes
  • LegacyHD (HD4Free)
  • Libble
  • LibraNet (LN)
  • LinkoManija
  • LosslessClub
  • M-Team TP (MTTP)
  • Magico (Trellas)
  • Majomparádé (TurkDepo)
  • MicroBit (µBit)
  • Milkie
  • MMA-Torrents
  • Mononoké-BT
  • MoreThanTV (MTV)
  • MyAnonamouse (MAM)
  • myAmity
  • MySpleen
  • NBTorrents
  • NCore
  • Nebulance (NBL) (TransmiTheNet)
  • NetCosmo
  • NetLab
  • New Real World
  • NorBits
  • NordicBits (NB)
  • notwhat.cd
  • oMg[WtF]trackr
  • OnlineSelfEducation
  • ONLYscene
  • Orpheus
  • OshenPT
  • Ourbits (HDPter)
  • P2PBG
  • P2PElite
  • PTFiles (PTF)
  • PThome
  • PWTorrents (PWT)
  • Partis
  • PassThePopcorn (PTP)
  • Peers.FM
  • Pirata Digital
  • PirateTheNet (PTN)
  • PixelCove (Ultimate Gamer)
  • PiXELHD (PxHD)
  • Pleasuredome
  • PolishSource (PS)
  • PolishTracker
  • PornBits (PB)
  • Pornbay
  • Pretome
  • PrivateHD (PHD)
  • ProAudioTorrents (PAT)
  • Psytorrents
  • PTerClub
  • PTMSG
  • PTSBAO
  • PuntoTorrent
  • PuroVicio
  • R3V WTF!
  • RPTorrents
  • Racing4Everyone (R4E)
  • RacingForMe (RFM)
  • Red Star Torrent (RST)
  • Redacted (PassTheHeadphones)
  • RetroFlix
  • RevolutionTT
  • Romanian Metal Torrents (RMT)
  • SDBits
  • SceneFZ
  • SceneHD
  • ScenePalace (SP)
  • SceneRush
  • SceneTime
  • Secret Cinema
  • SeedFile (SF)
  • ShareUniversity
  • Shareisland
  • Shazbat
  • Shellife (SL)
  • SiamBIT
  • SnowPT (SSPT)
  • SoulVoice
  • SpaceTorrent
  • SpeedCD
  • Speedmaster HD
  • SpeedTorrent Reloaded
  • Spirit of Revolution
  • SportsCult
  • SpringSunday
  • Superbits (SBS)
  • TEKNO3D
  • TLFBits
  • TOrrent-tuRK (TORK)
  • TTsWEB
  • TV Chaos UK (TVCUK)
  • TV-Vault
  • TVstore
  • TakeaByte
  • Tapochek
  • Tasmanit
  • TeamHD
  • TeamOS
  • TellyTorrent
  • TenYardTorrents (TYT)
  • The-Unknown
  • The Falling Angels (TFA)
  • The Geeks
  • The Horror Charnel (THC)
  • The New Retro
  • The Occult
  • The Place
  • The Shinning (TsH)
  • The Show
  • The Vault
  • TheAudioScene
  • TheEmpire (TE)
  • TJUPT
  • ToTheGlory (TTG)
  • Torrent Network (TN)
  • Torrent Sector Crew (TSC)
  • Torrent-Syndikat
  • Torrent.LT
  • TorrentBD
  • TorrentBytes (TBy)
  • TorrentCCF (TCCF)
  • TorrentDay (TD)
  • TorrentDB
  • TorrentFactory
  • TorrentHR
  • TorrentHeaven
  • TorrentLeech (TL)
  • TorrentLeech.pl
  • TorrentSeeds (TS)
  • Torrentech (TTH)
  • Torrenting (TT)
  • Torrentland
  • TotallyKids (TK)
  • TorrentSeed
  • TranceTraffic
  • Trezzor
  • TurkSeed
  • TurkTorrent (TT)
  • Twilight Torrents
  • Twilights Zoom
  • U2 (U2分享園@動漫花園)
  • UHDBits
  • UnionGang
  • UnlimitZ
  • Vizuk
  • WDT (Wrestling Desires Torrents / Ultimate Wrestling Torrents)
  • World-In-HD
  • Witch-Hunter (Demon-Site)
  • World-of-Tomorrow
  • x-ite.me (XM)
  • xBytesV2
  • XSpeeds (XS)
  • XWT-Classics
  • XWTorrents (XWT)
  • Xthor
  • XtreMeZone (MYXZ)
  • YDYPT
  • YingK
  • Zamunda.net
  • Zelka.org

Trackers marked with (invite needed) have no active maintainer and are missing features or are broken. If you have an invite for them please send it to garfieldsixtynine -at- gmail.com to get them fixed/improved.

Aggregate indexers

A special "all" indexer is available at /api/v2.0/indexers/all/results/torznab. It will query all configured indexers and return the combined results.

If your client supports multiple feeds it's recommended to add each indexer directly instead of using the all indexer. Using the all indexer has no advantages (besides reduced management overhead), only disadvantages:

  • you lose control over indexer specific settings (categories, search modes, etc.)
  • mixing search modes (IMDB, query, etc.) might cause low-quality results
  • indexer specific categories (>= 100000) can't be used.
  • slow indexers will slow down the overall result
  • total results are limited to 1000

To get all Jackett indexers including their capabilities you can use t=indexers on the all indexer. To get only configured/unconfigured indexers you can also add configured=true/false as a query parameter.

Installation on Windows

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.

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 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".

Install on Linux (AMDx64)

On most operating systems all the required dependencies will already be present. In case they are not, you can refer to this page https://github.com/dotnet/core/blob/master/Documentation/linux-prereqs.md

Install as service

  1. Download and extract the latest Jackett.Binaries.LinuxAMDx64.tar.gz release from the releases page
  2. To install Jackett as a service, open a Terminal, cd to the jackett folder and run sudo ./install_service_systemd.sh You need root permissions to install the service. The service will start on each logon. You can always stop it by running systemctl stop jackett.service from Terminal. You can start it again it using systemctl start jackett.service. Logs are stored as usual under ~/.config/Jackett/log.txt and also in journalctl -u jackett.service.

Run without installing as a service

Download and extract the latest Jackett.Binaries.LinuxAMDx64.tar.gz release from the releases page, open a Terminal, cd to the jackett folder and run Jackett with the command ./jackett

home directory

If you want to run it with a user without a /home directory you need to add Environment=XDG_CONFIG_HOME=/path/to/folder to your systemd file, this folder will be used to store your config files.

Install on Linux (ARMv7 or above)

On most operating systems all the required dependencies will already be present. In case they are not, you can refer to this page https://github.com/dotnet/core/blob/master/Documentation/linux-prereqs.md

Install as service

  1. Download and extract the latest Jackett.Binaries.LinuxARM32.tar.gz or Jackett.Binaries.LinuxARM64.tar.gz (32 bit is the most common on ARM) release from the releases page
  2. To install Jackett as a service, open a Terminal, cd to the jackett folder and run sudo ./install_service_systemd.sh You need root permissions to install the service. The service will start on each logon. You can always stop it by running systemctl stop jackett.service from Terminal. You can start it again it using systemctl start jackett.service. Logs are stored as usual under ~/.config/Jackett/log.txt and also in journalctl -u jackett.service.

Run without installing as a service

Download and extract the latest Jackett.Binaries.LinuxARM32.tar.gz or Jackett.Binaries.LinuxARM64.tar.gz (32 bit is the most common on ARM) release from the releases page, open a Terminal, cd to the jackett folder and run Jackett with the command ./jackett

home directory

If you want to run it with a user without a /home directory you need to add Environment=XDG_CONFIG_HOME=/path/to/folder to your systemd file, this folder will be used to store your config files.

Installation on Linux (ARMv6 or below)

  1. Install Mono 5.8 or better (using the latest stable release is recommended)
    • 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.
  2. Install libcurl:
    • Debian/Ubuntu: apt-get install libcurl4-openssl-dev
    • Redhat/Fedora: yum install libcurl-devel
    • For other distros see the Curl docs.
  3. Download and extract the latest Jackett.Binaries.Mono.tar.gz release from the releases page and run Jackett using mono with the command mono --debug JackettConsole.exe.
  4. (Optional) To install Jackett as a service, open the Terminal and run sudo ./install_service_systemd_mono.sh You need root permissions to install the service. The service will start on each logon. You can always stop it by running systemctl stop jackett.service from Terminal. You can start it again it using systemctl start jackett.service. Logs are stored as usual under ~/.config/Jackett/log.txt and also in journalctl -u jackett.service.

If you want to run it with a user without a /home directory you need to add Environment=XDG_CONFIG_HOME=/path/to/folder to your systemd file, this folder will be used to store your config files.

Mono must be compiled with the Roslyn compiler (default), using MCS will cause "An error has occurred." errors (See https://github.com/Jackett/Jackett/issues/2704).

Installation on Linux via Ansible

On a CentOS/RedHat 7 system: jewflix.jackett

On an Ubuntu 16 system: chrisjohnson00.jackett

Installation on macOS

Prerequisites

macOS 10.13 or greater

Install as service

  1. Download and extract the latest Jackett.Binaries.macOS.tar.gz release from the releases page.
  2. Open the extracted folder and double-click on install_service_macos.
  3. If the installation was a success, you can close the Terminal window.

The service will start on each logon. You can always stop it by running launchctl unload ~/Library/LaunchAgents/org.user.Jackett.plist from Terminal. You can start it again it using launchctl load ~/Library/LaunchAgents/org.user.Jackett.plist. Logs are stored as usual under ~/.config/Jackett/log.txt.

Run without installing as a service

Download and extract the latest Jackett.Binaries.macOS.tar.gz release from the releases page and run Jackett with the command ./jackett.

Installation using Docker

Detailed instructions are available at LinuxServer.io Jackett Docker. The Jackett Docker is highly recommended, especially if you are having Mono stability issues or having issues running Mono on your system e.g. QNAP, Synology. Thanks to LinuxServer.io

Installation on Synology

Jackett is available as a beta package from SynoCommunity

Running Jackett behind a reverse proxy

When running jackett behind a reverse proxy make sure that the original hostname of the request is passed to Jackett. If HTTPS is used also set the X-Forwarded-Proto header to "https". Don't forget to adjust the "Base Path Override" Jackett option accordingly.

Example config for apache:

<Location /jackett>
    ProxyPreserveHost On
    RequestHeader set X-Forwarded-Proto expr=%{REQUEST_SCHEME}
    ProxyPass http://127.0.0.1:9117
    ProxyPassReverse http://127.0.0.1:9117
</Location>

Example config for Nginx:

location /jackett {
	proxy_pass http://127.0.0.1:9117;
	proxy_set_header X-Real-IP $remote_addr;
	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	proxy_set_header X-Forwarded-Proto $scheme;
	proxy_set_header X-Forwarded-Host $http_host;
	proxy_redirect off;
}

Configuring OMDb

This feature is used as a fallback (when using the aggregate Indexer) to get the movie/series title if only the IMDB ID is provided in the request. To use it, please just request a free API key on OMDb (1,000 daily requests limit) and paste the key in Jackett

Command line switches

You can pass various options when running via the command line:

Command Line Switches
  • -i, --Install Install Jackett windows service (Must be admin)

  • -s, --Start Start the Jacket Windows service (Must be admin)

  • -k, --Stop Stop the Jacket Windows service (Must be admin)

  • -u, --Uninstall Uninstall Jackett windows service (Must be admin).

  • -r, --ReserveUrls (Re)Register windows port reservations (Required for listening on all interfaces).

  • -l, --Logging Log all requests/responses to Jackett

  • -t, --Tracing Enable tracing

  • -c, --UseClient Override web client selection. [automatic(Default)/httpclient/httpclient2]

  • -j, --ProxyConnection use proxy - e.g. 127.0.0.1:8888

  • -x, --ListenPublic Listen publicly

  • -z, --ListenPrivate Only allow local access

  • -p, --Port Web server port

  • -m, --MigrateSettings Migrate settings manually (Must be an admin on Windows)

  • -n, --IgnoreSslErrors [true/false] Ignores invalid SSL certificates

  • -d, --DataFolder Specify the location of the data folder (Must be an admin on Windows)

    • e.g. --DataFolder="D:\Your Data\Jackett".
    • Don't use this on Unix (mono) systems. On Unix just adjust the HOME directory of the user to the datadir or set the XDG_CONFIG_HOME environment variable.
  • --NoRestart Don't restart after update

  • --PIDFile Specify the location of PID file

  • --NoUpdates Disable automatic updates

  • --help Display this help screen.

  • --version Display version information.

Building from source

Windows

  • Install the .NET Core SDK
  • Clone Jackett
  • Open PowerShell and from the src directory, run dotnet restore
  • Open the Jackett solution in Visual Studio 2019 (version 16.4 or above)
  • Right-click on the Jackett solution and click 'Rebuild Solution' to restore NuGet packages
  • Select Jackett.Server as the startup project
  • In the drop-down menu of the run button select "Jackett.Server" instead of "IIS Express"
  • Build/Start the project

OSX

# manually install osx dotnet via:
https://dotnet.microsoft.com/download?initial-os=macos
# then:
git clone https://github.com/Jackett/Jackett.git
cd Jackett/src

# dotnet core version
dotnet publish Jackett.Server -f netcoreapp3.1 --self-contained -r osx-x64 -c Debug # takes care of everything
./Jackett.Server/bin/Debug/netcoreapp3.1/osx-x64/jackett # run jackett

Linux

sudo apt install mono-complete nuget msbuild dotnet-sdk-3.1 # install build tools (Debian/ubuntu)
git clone https://github.com/Jackett/Jackett.git
cd Jackett/src

# dotnet core version
dotnet publish Jackett.Server -f netcoreapp3.1 --self-contained -r linux-x64 -c Debug # takes care of everything
./Jackett.Server/bin/Debug/netcoreapp3.1/linux-x64/jackett # run jackett

Screenshots

screenshot

screenshot

screenshot