{"id":575,"date":"2026-06-18T04:43:07","date_gmt":"2026-06-18T04:43:07","guid":{"rendered":"https:\/\/www.mickeydesigns.com\/home\/?p=575"},"modified":"2026-06-18T14:40:41","modified_gmt":"2026-06-18T14:40:41","slug":"cliploop-help-troubleshooting","status":"publish","type":"post","link":"https:\/\/www.mickeydesigns.com\/home\/cliploop-help-troubleshooting\/","title":{"rendered":"ClipLoop \u2014 Help &amp; Troubleshooting Guide"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\"><strong>ClipLoop \u2014 Help &amp; Troubleshooting<\/strong><\/h2>\n\n\n\n<!-- ClipLoop \u2014 Help & Troubleshooting -->\n<!-- Paste this into a Custom HTML block in WordPress -->\n\n<style>\n.cl-guide { max-width: 800px; margin: 0 auto; font-size: 16px; line-height: 1.7; color: inherit; }\n.cl-guide h2 { font-size: 1.4em; margin: 2em 0 0.5em; padding-bottom: 0.3em; border-bottom: 1px solid #e0e0e0; }\n.cl-guide h3 { font-size: 1.1em; margin: 1.6em 0 0.4em; }\n.cl-guide p { margin: 0 0 1em; }\n.cl-guide ul, .cl-guide ol { margin: 0 0 1em 1.5em; padding: 0; }\n.cl-guide li { margin-bottom: 0.4em; }\n.cl-guide code { font-family: monospace; font-size: 0.9em; background: #f4f4f4; padding: 2px 5px; border-radius: 3px; }\n.cl-guide pre { background: #f4f4f4; border-left: 3px solid #ccc; padding: 1em; overflow-x: auto; border-radius: 3px; margin: 0 0 1em; }\n.cl-guide pre code { background: none; padding: 0; }\n.cl-guide table { width: 100%; border-collapse: collapse; margin: 0 0 1.5em; font-size: 0.95em; }\n.cl-guide th { background: #f4f4f4; text-align: left; padding: 8px 12px; border: 1px solid #ddd; font-weight: 600; }\n.cl-guide td { padding: 8px 12px; border: 1px solid #ddd; vertical-align: top; }\n.cl-guide blockquote { border-left: 3px solid #ccc; margin: 1em 0; padding: 0.6em 1.2em; background: #fafafa; color: #555; border-radius: 0 3px 3px 0; }\n.cl-guide blockquote p:last-child { margin: 0; }\n.cl-guide a { color: inherit; }\n.cl-guide strong { font-weight: 600; }\n.cl-toc { background: #fafafa; border: 0.5px solid #ddd; border-radius: 4px; padding: 1rem 1.25rem; margin: 0 0 2em; }\n.cl-toc h3 { margin: 0 0 0.6em; }\n.cl-toc ol { margin: 0; }\n<\/style>\n\n<div class=\"cl-guide\">\n\n<p>ClipLoop is an Apple TV app that plays a video on a seamless loop, either from a URL or from a video in your Photos library. This guide covers common questions and fixes.<\/p>\n\n<div class=\"cl-toc\">\n  <h3>Table of Contents<\/h3>\n  <ol>\n    <li><a href=\"#getting-started\">Getting Started<\/a><\/li>\n    <li><a href=\"#faq\">Frequently Asked Questions<\/a><\/li>\n    <li><a href=\"#troubleshooting\">Troubleshooting<\/a><\/li>\n    <li><a href=\"#tips\">Tips for the Best Loop<\/a><\/li>\n    <li><a href=\"#support\">Still Need Help?<\/a><\/li>\n  <\/ol>\n<\/div>\n\n<h2 id=\"getting-started\">Getting Started<\/h2>\n\n<h3>Loop a video from a URL<\/h3>\n\n<ol>\n  <li>From the home screen, press the gear icon (or press Menu \/ Back on the Siri Remote) to open Settings.<\/li>\n  <li>Enter the full URL to a video file (must start with <code>http:\/\/<\/code> or <code>https:\/\/<\/code>).<\/li>\n  <li>Select Apply URL. The video downloads to your Apple TV and starts looping automatically.<\/li>\n<\/ol>\n\n<h3>Loop a video from your Photos library<\/h3>\n\n<ol>\n  <li>Open Settings (gear icon or Menu \/ Back).<\/li>\n  <li>Select Select Video from Library.<\/li>\n  <li>The first time you do this, you&#8217;ll be asked to grant access to your photos. Choose Allow Access to All Photos (or Limited if you prefer).<\/li>\n  <li>Pick a video from the grid. It will be exported and start looping.<\/li>\n<\/ol>\n\n<h3>Change the video later<\/h3>\n\n<p>While a video is playing, press the Menu \/ Back button on the remote. The video will pause and Settings will appear so you can enter a new URL or pick a different video.<\/p>\n\n<h2 id=\"faq\">Frequently Asked Questions<\/h2>\n\n<p><strong>What video formats are supported?<\/strong><br>\nAny format your Apple TV can play natively (MP4\/H.264, H.265\/HEVC, MOV, etc.). HLS streams (.m3u8) are also supported for URL playback.<\/p>\n\n<p><strong>Is there a file size limit?<\/strong><br>\nYes \u2014 URL-loaded videos are capped at roughly 500 MB. For longer or higher-resolution content, host a lower-bitrate version or use the Photos library option.<\/p>\n\n<p><strong>Does ClipLoop keep playing if I leave the app?<\/strong><br>\nNo. When you switch to another app or put your Apple TV to sleep, playback pauses. It resumes automatically when you return.<\/p>\n\n<p><strong>Will my Apple TV go to sleep while a video is looping?<\/strong><br>\nNo. ClipLoop disables the screen-sleep timer while a video is playing, so the loop continues uninterrupted. Sleep is re-enabled when you exit the video.<\/p>\n\n<p><strong>Does the video have to re-download every time?<\/strong><br>\nNo. ClipLoop caches the downloaded video and restores it when you reopen the app \u2014 your last loop is right where you left it. After an app update, the cache is cleared and you&#8217;ll need to load a video again.<\/p>\n\n<p><strong>Can I play videos from Google Drive, Dropbox, iCloud Drive, YouTube, etc.?<\/strong><br>\nOnly if you have a direct link to the video file itself (one that returns a <code>video\/*<\/code> content type). Page links, share links, and streaming-platform URLs (YouTube, Vimeo, etc.) won&#8217;t work \u2014 those serve a web page, not the raw video file.<\/p>\n\n<h2 id=\"troubleshooting\">Troubleshooting<\/h2>\n\n<h3>&#8220;Invalid URL. Please enter a valid http or https URL.&#8221;<\/h3>\n\n<p>The URL field is empty, malformed, or missing a scheme. Make sure it starts with <code>http:\/\/<\/code> or <code>https:\/\/<\/code> and includes a host (for example, <code>https:\/\/example.com\/video.mp4<\/code>).<\/p>\n\n<h3>&#8220;Could not reach URL&#8221;<\/h3>\n\n<p>ClipLoop couldn&#8217;t connect to the server. Check that:<\/p>\n\n<ul>\n  <li>Your Apple TV is connected to the internet (try another app like the App Store).<\/li>\n  <li>The URL is correct and reachable from a browser on your phone or computer.<\/li>\n  <li>The server isn&#8217;t blocking requests from outside your network.<\/li>\n<\/ul>\n\n<h3>&#8220;Server returned status 403 \/ 404 \/ 5xx&#8221;<\/h3>\n\n<p>The server reached the URL but refused it or couldn&#8217;t find the file.<\/p>\n\n<ul>\n  <li><strong>403 \/ 401<\/strong> \u2014 The link requires authentication or a signed URL that has expired. Generate a fresh direct link.<\/li>\n  <li><strong>404<\/strong> \u2014 The file no longer exists at that location.<\/li>\n  <li><strong>5xx<\/strong> \u2014 The hosting server is having problems. Try again later.<\/li>\n<\/ul>\n\n<h3>&#8220;The URL does not point to a video file.&#8221;<\/h3>\n\n<p>The URL returned something other than a video (usually an HTML page). This is the most common issue with file-sharing services. You need a direct file link, not a shared\/preview page link. Some tips:<\/p>\n\n<ul>\n  <li><strong>Dropbox:<\/strong> change <code>?dl=0<\/code> to <code>?raw=1<\/code> at the end of the link.<\/li>\n  <li><strong>Google Drive:<\/strong> use a direct download URL, not the <code>\/view<\/code> page.<\/li>\n  <li><strong>Most web pages<\/strong> cannot be used directly \u2014 download the video and re-host it, or use the Photos library option instead.<\/li>\n<\/ul>\n\n<h3>&#8220;The URL does not contain a playable video.&#8221; \/ &#8220;Could not load video&#8221;<\/h3>\n\n<p>The file downloaded but Apple TV couldn&#8217;t decode it. The file may be corrupted, in an unsupported container, or use a codec tvOS doesn&#8217;t support. Try re-exporting the video as MP4 (H.264) with AAC audio.<\/p>\n\n<h3>&#8220;Download failed&#8221; or download stops partway<\/h3>\n\n<ul>\n  <li>The file may be larger than the 500 MB cap.<\/li>\n  <li>The connection dropped mid-download. Try again on a stronger Wi-Fi signal, or move closer to your router.<\/li>\n  <li>The hosting server may throttle large downloads.<\/li>\n<\/ul>\n\n<h3>Video loads but won&#8217;t start playing<\/h3>\n\n<p>After the video finishes loading, press the Play\/Pause button on the Siri Remote. The on-screen hint reminds you of this. If playback still doesn&#8217;t start, return to Settings and re-apply the URL.<\/p>\n\n<h3>Video freezes or hangs mid-loop<\/h3>\n\n<p>ClipLoop watches for stuck playback and automatically reloads the video every 10 seconds if it detects a hang. If freezing is frequent:<\/p>\n\n<ul>\n  <li>Reduce the video&#8217;s bitrate or resolution.<\/li>\n  <li>Use a wired Ethernet connection instead of Wi-Fi.<\/li>\n  <li>For URL-hosted videos, re-host on a faster server.<\/li>\n<\/ul>\n\n<h3>A brief flicker or overlay appears each time the video loops<\/h3>\n\n<p>ClipLoop uses Apple&#8217;s seamless loop player to avoid this. If you still see a flash, the source file may have unusual edit-list metadata. Re-exporting the video (a quick passthrough trim in QuickTime or another editor often works) usually resolves it.<\/p>\n\n<h3>Local video picker shows &#8220;Photos Access Denied&#8221;<\/h3>\n\n<p>ClipLoop needs permission to read videos from your library.<\/p>\n\n<ol>\n  <li>On your Apple TV, open Settings \u2192 Apps \u2192 ClipLoop.<\/li>\n  <li>Set Photos access to All Photos (or Limited Photos).<\/li>\n  <li>Reopen ClipLoop and try again.<\/li>\n<\/ol>\n\n<h3>Local video picker shows &#8220;No Videos Found&#8221;<\/h3>\n\n<ul>\n  <li>Your Photos library on this Apple TV doesn&#8217;t contain any videos.<\/li>\n  <li>Make sure you&#8217;re signed in to iCloud on the Apple TV with the same Apple ID you use for Photos, and that iCloud Photos is enabled on the device that owns the videos.<\/li>\n  <li>If you chose Limited Photos, the selected set may not include any videos \u2014 switch to All Photos in Settings.<\/li>\n<\/ul>\n\n<h3>Settings won&#8217;t open \/ the gear icon is missing<\/h3>\n\n<p>The gear is only shown when no video is playing. If a video is currently looping, press Menu \/ Back on the Siri Remote to pause and open Settings.<\/p>\n\n<h3>After updating the app, my video is gone<\/h3>\n\n<p>ClipLoop clears its saved URL and cached video on each app update so you start fresh. Open Settings and re-enter your URL or pick the video again. It will be remembered until the next update.<\/p>\n\n<h3>The app crashes or behaves oddly<\/h3>\n\n<ol>\n  <li>Force-quit ClipLoop: double-press the TV button, swipe up on ClipLoop.<\/li>\n  <li>Reopen the app.<\/li>\n  <li>If the issue persists, restart your Apple TV: Settings \u2192 System \u2192 Restart.<\/li>\n  <li>As a last resort, uninstall and reinstall ClipLoop.<\/li>\n<\/ol>\n\n<h2 id=\"tips\">Tips for the Best Loop<\/h2>\n\n<ul>\n  <li>Match the source resolution to your TV. A 1080p file usually looks identical to a 4K file on most TVs and uses far less bandwidth.<\/li>\n  <li>Use H.264 MP4 for the broadest compatibility and most reliable looping.<\/li>\n  <li>Keep loops short. A 10\u201360 second clip loops more smoothly and uses less storage than a multi-minute file.<\/li>\n  <li>Trim cleanly at the cut points. A clip that starts and ends on a matching frame creates a truly invisible loop.<\/li>\n  <li>Mute distracting audio. If the loop is for ambient or signage use, export with no audio track for a cleaner experience.<\/li>\n<\/ul>\n\n<h2 id=\"support\">Still Need Help?<\/h2>\n\n<p>If you&#8217;re still stuck, contact support with:<\/p>\n\n<ul>\n  <li>The Apple TV model and tvOS version (Settings \u2192 System \u2192 About).<\/li>\n  <li>The ClipLoop version.<\/li>\n  <li>The exact error message shown on screen.<\/li>\n  <li>For URL issues: the URL you tried (if you can share it) and what happens when you open it in a desktop browser.<\/li>\n<\/ul>\n\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>ClipLoop \u2014 Help &amp; Troubleshooting ClipLoop is an Apple TV app that plays a video on a seamless loop, either from a URL or from a video in your Photos library. This guide covers common questions and fixes. Table of Contents Getting Started Frequently Asked Questions Troubleshooting Tips for the Best Loop Still Need Help? &#8230; <a title=\"ClipLoop \u2014 Help &amp; Troubleshooting Guide\" class=\"read-more\" href=\"https:\/\/www.mickeydesigns.com\/home\/cliploop-help-troubleshooting\/\" aria-label=\"Read more about ClipLoop \u2014 Help &amp; Troubleshooting Guide\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":443,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"elementor_header_footer","format":"standard","meta":{"footnotes":""},"categories":[1,20],"tags":[],"class_list":["post-575","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-1","category-help"],"_links":{"self":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/575","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/comments?post=575"}],"version-history":[{"count":2,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/575\/revisions"}],"predecessor-version":[{"id":598,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/posts\/575\/revisions\/598"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media\/443"}],"wp:attachment":[{"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/media?parent=575"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/categories?post=575"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.mickeydesigns.com\/home\/wp-json\/wp\/v2\/tags?post=575"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}