{"id":37096970,"url":"https://github.com/zynine-/hdhrviewerv2.bundle","last_synced_at":"2026-01-14T11:55:45.649Z","repository":{"id":89292870,"uuid":"68558990","full_name":"zynine-/HDHRViewerV2.bundle","owner":"zynine-","description":"HDHomeRun + Plex","archived":false,"fork":false,"pushed_at":"2018-09-22T13:29:23.000Z","size":268,"stargazers_count":93,"open_issues_count":17,"forks_count":16,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-12-07T13:58:27.520Z","etag":null,"topics":["hdhomerun","hdhomerun-device","hdhomerun-ip","plex","plex-channel","plex-client"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zynine-.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-09-19T01:42:02.000Z","updated_at":"2025-06-13T06:31:50.000Z","dependencies_parsed_at":"2024-01-16T17:02:27.842Z","dependency_job_id":"dd34e069-ec68-403d-b685-0806f431337b","html_url":"https://github.com/zynine-/HDHRViewerV2.bundle","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/zynine-/HDHRViewerV2.bundle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zynine-%2FHDHRViewerV2.bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zynine-%2FHDHRViewerV2.bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zynine-%2FHDHRViewerV2.bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zynine-%2FHDHRViewerV2.bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zynine-","download_url":"https://codeload.github.com/zynine-/HDHRViewerV2.bundle/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zynine-%2FHDHRViewerV2.bundle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28419272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hdhomerun","hdhomerun-device","hdhomerun-ip","plex","plex-channel","plex-client"],"created_at":"2026-01-14T11:55:45.013Z","updated_at":"2026-01-14T11:55:45.635Z","avatar_url":"https://github.com/zynine-.png","language":"Python","readme":"![GitHub release](https://img.shields.io/github/release/zynine-/HDHRViewerV2.bundle.svg?style=for-the-badge)\n\n# HDHRViewerV2.bundle\nWatch Live TV on Plex using HDHomeRun, at home or remotely. Compatibility may vary by Plex Media Server (PMS) version, Plex client version, etc... \n\n# Getting Started\n## 1. Installation\n### Method 1 : Unsupported AppStore V2 (UAS V2)\nThis is the best method. **HDHR Viewer 2** can be updated easily through the **UAS V2** interface.\n**UAS V2** is available at \u003chttps://forums.plex.tv/discussion/202282/unsupported-appstore-v2-as-in-totally-unsupported/p1\u003e\n\n### Method 2 : Manual Installation\nCopy **HDHRViewerV2.bundle** to Plex Plug-in Directory.\n\n1. Git clone or download the [latest github copy](https://github.com/zynine-/HDHRViewerV2.bundle/archive/master.zip).\n2. Unzip and rename the folder to **HDHRViewerV2.bundle**\n3. Copy the folder to Plex Media Server plug-in folder. [Read more: How do I find the Plug-Ins folder?](https://support.plex.tv/hc/en-us/articles/201106098-How-do-I-find-the-Plug-Ins-folder-)\n\n4. Make sure the directory structure looks like:\n```\nPlug-ins\n  |_ HDHRViewerV2.bundle\n    |_ Contents\n```\n\n### Method 3 : Scripts\nRun install scripts included. (Limited OS)\n\n## 2. Initial Plug-in Settings/Preferences\n\nMost Plex clients can't access the Plug-in Settings/Preferences. Use Plex/Web to configure it.\n\tOpen your browser to the Plex Web Admin page, select Channels, and you should see the HDHR Viewer Icon in the list.\n\tIf not, then go back to step 1 and correct the location where you copied the plgin package files\n\n### 0.9.x and above:\nMultiple tuners are supported, and tuners are automatically discovered. Tuners can be manually define in **HDHomeRun IP**. You can manually list multiple tuners, with space delimited. See examples below.\n\nFor full automatic discover (requires internet connection). Set **HDHomeRun IP:**\n\u003eauto\n\nExample of manual discover + multiple tuner + automatic discovery. Set **HDHomeRun IP:**\n\u003e192.168.1.111 192.168.1.112 192.168.1.113\n\n## 3. Generate required codec (PMS 0.9.17.x to 1.3.x, I think this was fixed with PMS 1.4.x)\n\nWith Plex Media Server 0.9.17.x to 1.3.x, there was a change in the Plex transcoder which caused playback issue on most clients for first time users. To fix this problem, download a short clip from your HDHomeRun device, and add it to your PMS library, and play it. Now try using the **HDHR Viewer 2** again.\n\n### 1. Download a short clip from your HDHomeRun tuner.\nDownload a short clip from your HDHomeRun device using your web browser:\n\n\u003ehttp://{tuner_ip}:5004/auto/v{channel.number}?duration={time_in_seconds}\n\nExample (tuner_ip=192.168.1.111; channel=2.1; duration=5 seconds):\n\n\u003ehttp://192.168.1.111:5004/auto/v2.1?duration=5\n\n### 2. Add to Plex Library\n\nAdd the videos to your **Movies** or **Home Videos** library.\n\n### 3. Play the added video\n\nPlay the video and it should generate the required AC3 codec.\n\n### 4. Now try using the plug-in.\n\nGo to **HDHR Viewer 2**, and try playing a video stream.\n\n## Common Issues and Resolution\n\n### Android devices (I think this was fixed with PMS 1.4.x)\nCertain android devices will have issue with playback. This is due to **Plex Media Server (PMS)** not transcoding the **ac3** audio stream to **aac** properly. You can try to change the audio codec listed **Android.xml** profile in PMS Resources folder from **aac** to **mp3**.\n\n### For other issues\nGo to \u003chttps://github.com/zynine-/HDHRViewerV2.bundle/issues?q=is%3Aissue+is%3Aopen+label%3A%22common+issues%22\u003e\n\n## HDHomeRun Compatibility\n\nCompatible with HDHomeRun that have DLNA or HTTP streaming capabilities.\nRecommended minimum firmware: 20161107\n\n### Compatible\n- HDHomeRun PRIME (HDHR3-CC)\n- HDHomeRun 4DC (HDHR3-4DC)\n- HDHomeRun DUAL (Gen4)\n- HDHomeRun CONNECT (HDHR4-2US/2DT)\n- HDHomeRun PLUS/EXTEND (HDTC-2US)\n- HDHomeRun EXTEND (HDTC-2US-M)\n\n### Not Compatible\n- HDHomeRun DUAL (HDHR3-US/EU/DT)\n- HDHomeRun DUAL (HDHR2-US/DT)\n- HDHomeRun DUAL (HDHR-US/EU/DT)\n\nPlease use [HDSurfer Plug-in for HDHomeRun](https://forums.plex.tv/discussion/83233/hdsurfer-plug-in-for-hdhomerun)\n\n## Server Compatibility/Requirement\n\nStandard Plex requirement for streaming to Plex Home Theater (PHT)\n\nHigh CPU requirement for transcoding to other clients (Web/Android/Roku/FireTV/etc…). Typical NAS devices may not have capable CPU for transcoding. Not compatible with Nvidia Shields (unless rooted, due to elevated privilages required for File-based functions (XMLTV, icons). I may spin-off another version just for Nvidia Shields, if enough users requeste it.)\n\nEstimated CPU requirement for 1080i MPEGTS transcoding:\n- Intel Core2 Quad 2.5Ghz or faster.\n- Intel Celeron/Pentium Gxxxx 3Ghz or faster.\n- Intel i3/i5/i7 Dual Core (1st Generation) 3Ghz of faster.\n- Intel i3/i5/i7 Dual Core (Later Generation) Turbo Speed 2.5Ghz or faster.\n- AMD Athlon Quad Core 3Ghz or faster.\n- AMD AthlonII/Phenom/A6/A8/A10 Quad Core 2.5Ghz or faster.\n\nCPU requirement may be much lower with PMS Hardware Transcoding Previews.\n\n## Client Compatibility\n\nNo client restriction known. Refer to: \u003chttps://github.com/zynine-/HDHRViewerV2.bundle/wiki/Compatibility-Report\u003e\n\n## Android Playback Issue \u0026 Resolution\n\nRefer to: \u003chttps://github.com/zynine-/HDHRViewerV2.bundle/issues/3\u003e * Not applicable to all PMS Versions.\n\n## Common Issues and Resolution\n\n- [Slow buffering or stutters on some clients](https://github.com/zynine-/HDHRViewerV2.bundle/issues/4)\n- [Interlacing](https://github.com/zynine-/HDHRViewerV2.bundle/issues/6)\n\n\u003chttps://github.com/zynine-/HDHRViewerV2.bundle/issues?q=is%3Aissue+is%3Aopen+label%3A%22common+issues%22\u003e\n\n## Refer to the Wiki for more setups\n\n\u003chttps://github.com/zynine-/HDHRViewerV2.bundle/wiki\u003e\n\n## Playback issues/troubleshooting.\n- Update to the latest firmware\n- Do a channel scan on the HDHomeRun, some channels may have changed from mpeg2 to h264, and can cause playback issues\n\nBefore you post in the plex forum, please read the following:\n\nThere are many different combinations (Hardware, Software, Firmware, Server, Client) possible, I do not have the resources to test every single combination or scenario.\n\nWhenever help is needed, please ALWAYS provide:\n\n- Plex Media Server Log Files (Make sure General-\u003eEnable Plex Media Server debug logging is checked.)\n- HDHRViewerV2 Log Files\n- Server Operating System :\n- Server CPU :\n- HDHomeRun Model/Firmware :\n- Is this a new installation or upgrade? What was upgraded?\n- Issues with Streaming, Channel Guide or other?\n- Is there any error message?\n- Have you successfully run on another other Clients? If yes, please list them.\n\nIf streaming issue:\n- Are you trying to stream locally on your network, or remotely?\n- What are you Player Online Streaming Quality?\n- Have you tried other Streaming Quality like Original or 4 Mbps 720p?\n\nOptional for streaming:\nA 5 second video clip of affected channel.\nhttps://forums.plex.tv/discussion/101755/hdhomerun-viewer\n\nFeel free to ask questions at: https://forums.plex.tv/discussion/101755/hdhomerun-viewer\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzynine-%2Fhdhrviewerv2.bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzynine-%2Fhdhrviewerv2.bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzynine-%2Fhdhrviewerv2.bundle/lists"}