[{"data":1,"prerenderedAt":329},["ShallowReactive",2],{"navigation":3,"/docs/configuration/stream-downloader":107,"/docs/configuration/stream-downloader-surround":324},[4,18,24,49,66,75,81,87],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Overview","/docs/overview","docs/1.overview",[9,13],{"title":10,"path":11,"stem":12},"What is Reaparr?","/docs/overview/what-is-reaparr","docs/1.overview/1.what-is-reaparr",{"title":14,"path":15,"stem":16},"Similar Projects","/docs/overview/similar-projects","docs/1.overview/2.similar-projects",false,{"title":19,"path":20,"stem":21,"children":22},"Getting started","/docs/getting-started","docs/2.getting-started/index",[23],{"title":19,"path":20,"stem":21},{"title":25,"path":26,"stem":27,"children":28,"page":17},"Installation","/docs/installation","docs/3.installation",[29,33,37,41,45],{"title":30,"path":31,"stem":32},"Docker Compose","/docs/installation/docker","docs/3.installation/1.docker",{"title":34,"path":35,"stem":36},"Unraid","/docs/installation/unraid","docs/3.installation/2.unraid",{"title":38,"path":39,"stem":40},"Windows","/docs/installation/windows","docs/3.installation/4.windows",{"title":42,"path":43,"stem":44},"MacOS","/docs/installation/macos","docs/3.installation/5.macos",{"title":46,"path":47,"stem":48},"Synology","/docs/installation/synology","docs/3.installation/6.synology",{"title":50,"path":51,"stem":52,"children":53,"page":17},"Configuration","/docs/configuration","docs/4.configuration",[54,58,62],{"title":55,"path":56,"stem":57},"Reaparr Setup","/docs/configuration/set-up","docs/4.configuration/1.set-up",{"title":59,"path":60,"stem":61},"Header Authentication","/docs/configuration/header-authentication","docs/4.configuration/2.header-authentication",{"title":63,"path":64,"stem":65},"Stream Downloader","/docs/configuration/stream-downloader","docs/4.configuration/3.stream-downloader",{"title":67,"path":68,"stem":69,"children":70,"page":17},"Integration","/docs/integration","docs/5.integration",[71],{"title":72,"path":73,"stem":74},"Sonarr/Radarr","/docs/integration/sonarr-radarr","docs/5.integration/1.sonarr-radarr",{"title":76,"path":77,"stem":78,"children":79},"Frequently Asked Questions","/docs/faq","docs/6.faq/index",[80],{"title":76,"path":77,"stem":78},{"title":82,"path":83,"stem":84,"children":85},"Troubleshooting","/docs/troubleshooting","docs/7.troubleshooting/index",[86],{"title":82,"path":83,"stem":84},{"title":88,"path":89,"stem":90,"children":91,"page":17},"Contributing","/docs/contributing","docs/8.contributing",[92,95,99,103],{"title":5,"path":93,"stem":94},"/docs/contributing/overview","docs/8.contributing/1.overview",{"title":96,"path":97,"stem":98},"Documentation","/docs/contributing/documentation","docs/8.contributing/2.documentation",{"title":100,"path":101,"stem":102},"Project development","/docs/contributing/dev-setup","docs/8.contributing/3.dev-setup",{"title":104,"path":105,"stem":106},"Translating","/docs/contributing/translating","docs/8.contributing/4.translating",{"id":108,"title":63,"body":109,"description":316,"extension":317,"meta":318,"navigation":319,"path":64,"seo":320,"stem":65,"__hash__":323},"docs/docs/4.configuration/3.stream-downloader.md",{"type":110,"value":111,"toc":306},"minimark",[112,116,121,126,137,140,144,162,166,169,238,242,245,274,277,280,284,287,290,300,303],[113,114,115],"p",{},"Reaparr supports two download methods for fetching media from your Plex server. Direct downloading is the default and works for most setups. The stream downloader is an alternative that can be enabled per server when direct downloading fails.",[117,118,120],"h2",{"id":119},"download-methods","Download methods",[122,123,125],"h3",{"id":124},"direct-download-default","Direct download (default)",[113,127,128,129,136],{},"The direct download client fetches the original media file from Plex using standard HTTP range requests with multi-threaded downloading, powered by ",[130,131,135],"a",{"href":132,"rel":133},"https://github.com/bezzad/Downloader",[134],"nofollow","Downloader",". The file is downloaded as-is, with no transcoding, exactly as it was stored on the Plex server. This is the recommended method for all setups.",[113,138,139],{},"Direct downloads supports pause and resume — if a download is interrupted, Reaparr can pick up from where it left off.",[122,141,143],{"id":142},"stream-downloader","Stream downloader",[113,145,146,147,151,152,155,156,161],{},"The stream downloader uses Plex's MPEG-DASH streaming pipeline to download media. Instead of fetching the raw file, Reaparr initiates a Plex transcoding session via the ",[148,149,150],"code",{},"video/:/transcode/universal"," endpoint, retrieves a DASH manifest (",[148,153,154],{},".mpd","), and uses ",[130,157,160],{"href":158,"rel":159},"https://github.com/emarsden/dash-mpd-cli",[134],"dash-mpd-cli"," to download and mux the resulting video and audio segments into a single output file.",[163,164],"prose-warning",{"description":165},"The stream downloader always routes media through Plex's transcoding pipeline. The downloaded file will never match source quality — video and/or audio will be re-encoded regardless of the original format. This is a last resort. If at all possible, ask the server owner to grant you download permission so that direct downloading works instead.",[113,167,168],{},"Key differences from direct downloading:",[170,171,172,186],"table",{},[173,174,175],"thead",{},[176,177,178,181,184],"tr",{},[179,180],"th",{},[179,182,183],{},"Direct download",[179,185,143],{},[187,188,189,201,212,227],"tbody",{},[176,190,191,195,198],{},[192,193,194],"td",{},"Quality",[192,196,197],{},"Original — no transcoding",[192,199,200],{},"Always transcoded — quality loss",[176,202,203,206,209],{},[192,204,205],{},"Pause / resume",[192,207,208],{},"Supported",[192,210,211],{},"Not supported",[176,213,214,217,222],{},[192,215,216],{},"Library",[192,218,219],{},[130,220,135],{"href":132,"rel":221},[134],[192,223,224],{},[130,225,160],{"href":158,"rel":226},[134],[176,228,229,232,235],{},[192,230,231],{},"Recommended",[192,233,234],{},"Yes (default)",[192,236,237],{},"Last resort only",[117,239,241],{"id":240},"enabling-the-stream-downloader","Enabling the stream downloader",[113,243,244],{},"The stream downloader is disabled by default and must be enabled individually for each Plex server.",[246,247,248,257,260,267],"ol",{},[249,250,251,252,256],"li",{},"Open ",[253,254,255],"strong",{},"Settings"," in Reaparr",[249,258,259],{},"Navigate to your Plex server and open its settings dialog",[249,261,262,263,266],{},"Go to the ",[253,264,265],{},"Server Configuration"," tab",[249,268,269,270,273],{},"Toggle ",[253,271,272],{},"Allow Stream Downloader"," on",[113,275,276],{},"Once enabled, all new or restarted downloads from that server will use the DASH stream downloader instead of direct downloading.",[113,278,279],{},"To revert, toggle the setting back off. The change takes effect immediately for any new downloads started after the toggle.",[117,281,283],{"id":282},"when-to-use-it","When to use it",[113,285,286],{},"The best solution is always to ask the server owner to grant you download permission in Plex. This allows direct downloading to work and guarantees you receive the original, unmodified file.",[113,288,289],{},"Only enable the stream downloader if direct downloading is failing. There have also been cases where a Plex account has download permission but direct downloading still fails. The clearest signal that the stream downloader may help is the following error:",[291,292,297],"pre",{"className":293,"code":295,"language":296},[294],"language-text","Empty download stream\n","text",[148,298,295],{"__ignoreMap":299},"",[113,301,302],{},"This error means Plex refused the direct file request entirely. The stream downloader works around this by going through the streaming pipeline instead, which Plex permits even without explicit download access.",[113,304,305],{},"In all other cases, leave the stream downloader disabled.",{"title":299,"searchDepth":307,"depth":307,"links":308},2,[309,314,315],{"id":119,"depth":307,"text":120,"children":310},[311,313],{"id":124,"depth":312,"text":125},3,{"id":142,"depth":312,"text":143},{"id":240,"depth":307,"text":241},{"id":282,"depth":307,"text":283},"Learn when and how to enable the stream downloader as a fallback to direct downloading in Reaparr.","md",{},true,{"title":321,"description":322},"Stream Downloader | Reaparr Docs","Configure the DASH stream downloader in Reaparr as a fallback when direct downloading fails — enabled per server via the Server Config tab.","ZiNSEkpJXRYqsX1p3o-wg4mOS6WrPWIp7zGL-guY28w",[325,327],{"title":59,"path":60,"stem":61,"description":326,"children":-1},"Configure Reaparr to automatically authenticate users via HTTP headers injected by a reverse proxy, removing the need for separate credentials.",{"title":72,"path":73,"stem":74,"description":328,"children":-1},"Guide on how to integrate Reaparr with Sonarr and Radarr, allowing you to search for media from within those applications and have Reaparr handle the downloading.",1774688594118]