One-click character swap for videos: an open-source, local Higgsfield Genjutsu alternative built on ComfyUI and MiniMax H3, with FLUX.3 Klein relighting.
Specify a film or show, and the agent will perform cross-source searches, select the best versions, and save them to your own Quark, 115, GuangYa, 123, or Tianyi cloud drives while tracking missing episodes. Available as macOS / Windows desktop versions; AGPL open-source and self-hosted.
Couch Cast: send videos from websites on your Android phone to Kodi on Fire TV. Free, no ads. / Dal telefono a Kodi sulla Fire TV, gratis e senza pubblicità.
A personal Android app (Android 13 or later) for watching videos from streaming sites on a Fire TV. On the phone it is called Couch Cast; the repo, releases and APK (CastToKodi.apk) keep the old name, so updates and Obtainium keep working.
[!NOTE]
The app speaks English and Italian: it follows the phone's language (Italian only if the phone is in Italian) and you can change it in ⋮ → Settings → App language.
✨ How it works
📱 Phone (browser + remote) ──video link──▶ 📺 Kodi on the Fire TV ──▶ 🌐 streaming site
🔎 The phone is the browser: open the site in the app and start the player.
🎯 The app picks up the video stream (.m3u8 / .mp4) and sends it to Kodi, which plays it directly.
🔋 The video does not go through the phone: full quality, and the phone can be locked. Only at the start does the phone hand Kodi the playlist and the key, which the Fire TV alone downloads too slowly.
🚫 Popups, window.open and jumps to other domains are blocked: they are almost all of the ads on those sites. The 🛡 shield in the top bar counts what was blocked and, when tapped, opens the one you needed.
📋 Episode queue in Kodi's playlist, and on some anime sites, if you want, the next episodes are queued automatically.
⏯️ Keep watching: the app remembers which episode of each series you reached and at what minute, even when the site changes domain.
🎮 Kodi remote inside the app: the Kodi bar at the bottom is always there and opens it full screen, with the queue next to it.
📺 Compatible devices
The app talks to Kodi, not to the TV: it works on any device that runs Kodi with remote control over HTTP. The ⏻ button instead uses network ADB (port 5555) and HDMI-CEC, so it only works on Fire OS and Android TV.
Device
Kodi
Send to Kodi
⏻ Power on
Fire TV Stick / Cube with Fire OS, TVs with built-in Fire TV
APK via Downloader
✅
✅ Network ADB debugging built in
Fire TV with Vega OS (Stick 4K Select, Stick HD 2026)
❌ cannot be installed
❌
❌
Android TV (Sony Bravia, Philips, TCL, Hisense Android, Sharp…)
Play Store
✅
⚠️ depends on the model: needs ADB debugging on port 5555
Nvidia Shield TV
Play Store
✅
✅ Developer options → Network debugging
Generic Android boxes (Xiaomi Mi Box, Homatics, Onn…)
Play Store or APK
✅
⚠️ like Android TV
Google TV (Chromecast with Google TV, Google TV Streamer, Google TV sets)
Play Store
✅
⚠️ usually not: Wireless debugging uses code pairing and a changing port, not 5555
Windows / Mac / Linux PC connected to the TV
kodi.tv
✅
❌
Raspberry Pi, LibreELEC, CoreELEC, OSMC
kodi.tv / dedicated image
✅
❌
Xbox One / Series
Microsoft Store
✅
❌
LG webOS
⚠️ community port only (Homebrew, developer mode), webOS 4+
⚠️ in theory yes, not tested
❌
Apple TV (HD and 4K)
⚠️ sideload only, with Xcode from a Mac, must be re-signed
⚠️ in theory yes, not tested
❌
Samsung Tizen, Roku, Chromecast without Google TV
❌ Kodi does not exist
❌
❌
✅ = works, ⚠️ = works with limits or not verified, ❌ = no. Only actually tested on a Fire TV with Fire OS. Tried it on another device? Tell me how it went; found a bug? Report it.
On Samsung, LG or Roku TVs you can still plug a device from the list into HDMI (e.g. a Fire TV Stick with Fire OS or a Chromecast with Google TV).
⏻ on Android TV / Google TV: the app connects with "classic" ADB on port 5555. If the device only has Android 11+ Wireless debugging, port 5555 can be opened once from a PC (adb tcpip 5555), but it closes again on every reboot. In deep sleep many devices turn off the network: then the button has nothing to wake up.
🛠️ Setup (once)
📺 Fire TV
You need a Fire TV with Fire OS (e.g. Fire TV Stick 4K Max and earlier): check in Settings → My Fire TV → About. Vega OS models (Fire TV Stick 4K Select, Fire TV Stick HD 2026) do not allow installing Kodi.
Kodi is not in the Amazon Appstore: install the Downloader app from the Appstore, allow it to install "apps from unknown sources" (in My Fire TV → Developer options; if you don't see them, click the device name 7 times in About) and download the 32-bit ARM Android APK from kodi.tv.
In Kodi: Settings → Services → Control, turn on Allow remote control via HTTP. Note the port (usually 8080), username and password.
In Kodi: Settings → Services → General, turn on Announce services to other systems: this way the app finds Kodi by itself. If that doesn't work, note the Fire TV's IP (Settings → My Fire TV → About → Network) and type it in by hand.
To turn the TV on from the phone (power button in the Kodi bar at the bottom): turn on My Fire TV → Developer options → ADB debugging, Settings → Display & Sounds → HDMI CEC Device Control and HDMI-CEC on the TV (Anynet+, SimpLink, Bravia Sync… depending on the brand). If Alexa already turns the TV on to the right input, CEC is fine.
📱 App on the phone, without a PC
On every push to main, GitHub Actions builds the APK and publishes it as the release "Versione X.Y.Z" (tag vX.Y.Z), with the list of changes taken from CHANGELOG.md (in Italian). From the phone open releases/latest and download CastToKodi.apk.
Builds are signed with a fixed key (repo secrets KEYSTORE_BASE64 and KEYSTORE_PASSWORD; the original is not in the repo), so each APK installs over the previous one. If the key is lost a new one is needed, and the app must be uninstalled once.
🔔 On startup the app tells you if there is a new version, with what's new: Update downloads it and installs it over the old one (the first time Android asks you to allow Couch Cast to install apps). Obtainium with the repo address works too.
PC
Install Android Studio (developer.android.com/studio). On first launch it downloads the SDK and JDK by itself.
File → Open on the project folder and wait for the Gradle sync.
Phone
Settings → About phone: tap "Build number" 7 times to unlock Developer options.
Settings → System → Developer options: turn on USB debugging.
Connect the phone via USB, pick it in Android Studio and press ▶️ Run.
▶️ Usage
[!TIP]
First time? There is a step-by-step guide, with examples and fixes for common problems: 📖 How to use Couch Cast.
📡 On first launch Where is Kodi? opens: in Automatic the app looks for Kodi on the network and you pick it; in Manual you type IP:port (e.g. 192.168.1.50:8080). Below, username and password if set in Kodi (if missing, the app asks for them on the first send). You can change it later with ⋮ → Settings → Kodi. If the Fire TV changes IP, the app finds it again by itself when sending. Credentials stay on the phone, with the password encrypted, tied to that Kodi and to the home network: on another network they are asked again.
🔌 With the TV off press the power button in the Kodi bar at the bottom (or Turn on on the home page): the app finds the Fire TV on the network by itself (even without Kodi open), wakes it up, the TV turns on and after a few seconds switches to its input, then Kodi opens; when it answers the app says "Kodi is ready". The first time the TV asks to allow debugging from this phone: tick Always allow and press OK. If the Fire TV is in deep sleep it does not answer on the network: then you need Alexa or the remote.
🏠 On launch the home page opens: Kodi's state with a button to turn it on or open the remote, Keep watching with a card for each series, stopped at the right episode and minute (the ✕ removes it, after a confirmation), the Last page you opened (also with a ✕) and your favourites as icons (long-press to rename or remove). How the row of series works: guide. You get back to it with Back from a site's first page or with ⋮ → Home page. In the top bar type an address or a search (e.g. jojo episode 1, goes to Google). With ★ you save the page to favourites (with a name of your choice) and reopen them; with ⋮ next to a favourite you rename or remove it.
🎬 Go to the episode and start the player (the stream is only detected once it starts). If you found the page in Chrome or another app, Share → Couch Cast opens it here; if the link is already a video (.m3u8, .mp4) the app offers to send it straight to Kodi. Then at the bottom right, over the site, Send to Kodi and the round + (queue) button show up.
📤 Press Send to Kodi. Ads are already filtered out; if more than one video is left a panel slides up from the bottom with a big frame taken from each one and its length on top, so an episode stands out from a trailer (on protected videos the frame may be missing). The first, "Full video", is almost always the right one and is already selected, with and under it; videos shorter than a minute are faded and the single qualities of the same video are not listed separately. If the video has subtitles (in the playlist or in a / file loaded by the page) the frame shows with the languages: the phone hands them to Kodi at start together with the video, and the notice says "with Italian subtitles".
[!IMPORTANT]
Phone and Fire TV must be on the same Wi-Fi network.
🧩 Site add-ons
Extra features that only apply to some sites or players. The rest of the app works on any site that serves .m3u8 or .mp4.
⏭️ Anime sites with the VixCloud player
If you turn it on, after sending the app queues the following episodes by itself (up to 3, set in ⋮ → Settings or per series in its panel; 0 = off, which is the default). Only on the episode pages of the anime site the app knows.
It reads the episode list from the page and the link of each one from the VixCloud player: if the site changes its structure the app warns you and you're left with the manual + (queue).
In Keep watching the series is recognised from the address (/anime/1234-jojo, the same on every domain) and Resume on Kodi sends the episode without opening the page, from the minute you stopped at.
⏭️ Anime sites with /<series>-ep-<number>/ pages
In Keep watching the series and the episode number are recognised from the address (/<series>-ep-<number>/, or /ep/<series>-ep-<number> with the player on a separate /watch?file=… page, which the app ties to the episode page you came from).
⏭ when the queue is over, Resume on Kodi and the widget send the episode without opening the page: the app opens the next episode (-ep-<number+1>) in a hidden WebView and takes the video link from the player, even when the player sits in a frame from another site. If the next episode isn't out yet it says so.
🎞️ VixCloud player (on any site that uses it)
Recognises the playlist even without .m3u8 (/playlist/<id>) and drops its pieces (audio, video, single qualities), so only the main playlist remains.
The link has a token that expires (expires=): + (queue) and automatic queueing don't queue an episode that would start after it expires.
🔍 Google
From Google results you can open any site: blocking jumps to other domains is off there.
⏩ AniSkip (anime)
Skip intro uses the times from AniSkip, a free database where users mark where the intro, recap and credits of each episode start and end. In Automatic mode the button lights up only from 5 seconds before a part until its end and goes to the end of that part: Skip recap, Skip intro or Skip credits, which goes to the end of the episode (and Kodi moves on to the next video in the queue). That way a tap before the intro doesn't make you miss the minutes before it. Outside the parts the button is off: a long-press shows where it works in that episode and lets you skip by hand. In Manual mode the button jumps the chosen seconds, as before. Pick the mode in ⋮ → Settings → Skip intro and, for each series, in its panel.
The series is recognised from the MyAnimeList id on the page (each season and part has its own) or, if it's missing, by searching its name on AniList; if the match isn't certain, you pick it in the series panel (Times from AniSkip), where you can also choose None. If the site splits a season into part 1 and part 2 that is a single entry on MyAnimeList, the panel has Episodes on MyAnimeList ("episode 1 on the site is 13"): the app suggests it by itself when the title says part 2.
The times only count if the video on Kodi is as long as the episode they were marked on (±10 seconds); otherwise, or if the episode isn't there, the fixed jump stays.
The app only sends AniSkip and AniList the series id (or its name) and the episode number. In Manual it asks nothing.
🧪 Tests
The app's rules that don't depend on Android (address bar, jump blocking, recognising videos and ads) live in Rules.kt, the per-site ones (the add-ons above) in sites/, and they are tested in app/src/test. Sending, queue and the phone relay (Kodi.kt, Streams.kt) are tested against a fake Kodi (FakeKodi, answers JSON-RPC and keeps its own playlist) and a fake streaming site (FakeSite: playlist with two qualities, AES key, single-use link), with no Fire TV; the remote in RemoteTest, the phone relay in RelayTest and the power button against a fake adbd (AdbTest). On every PR to develop the Test workflow runs ./gradlew testDebugUnitTest; to main also assembleDebug, and the heavier checks will go there; with Android Studio you run them with the ▶️ next to the test class.
🌿 Branches
develop is where work happens: every change starts here and comes back with a PR.
main is for releases only: a PR from develop to main publishes a new version (the APK workflow only runs on pushes to main).
Before that PR, a ## X.Y.Z section with the changes is added at the top of CHANGELOG.md: the first number for big changes, the second for new features, the third for fixes. If it's missing, the PR's test check says so.
The README exists in two languages: this one and README.it.md. A change to one goes into the other too.
Settings → General → Default branch: choose develop, so new PRs target it by default.
Settings → Rules → Rulesets → New branch ruleset, targeting develop and main: turn on Restrict deletions, Require a pull request before merging and Require status checks to pass with the test check. This way a PR with red tests can't be merged and nobody pushes directly to the two branches.
Couch Cast is not affiliated with or endorsed by Kodi or the XBMC Foundation. Kodi® is a registered trademark of the XBMC Foundation. Fire TV is a trademark of Amazon.
📋 Queue: everything goes through Kodi's video playlist, which is never cleared. Send to Kodi inserts the video right after the one playing and starts it; + (queue) puts it at the end. If the episode could not play (the current video was not started from the app, or the link expires before its turn) the app does not queue it and explains why. You see it in the remote's Queue tab (or by long-pressing +): the video playing (▶) and when it ends, the ones already watched, the time each one starts and, in red, links that expire before their turn; the ⋮ next to a video plays it or removes it, Clear the queue removes everything except the one playing. If Kodi is playing a video started outside the queue, it shows at the top with the reason the queue won't follow it.
🎮 Remote: the Kodi bar is always at the bottom (what is playing with the time, play/pause and a line that moves forward; a dot that is lit if Kodi answers; "Nothing playing" or, if Kodi is off, the button to turn it on); tap it, or tap the remote button on its right, and the remote opens full screen, with the Remote and Queue tabs. Close it with ⌄, Back or by dragging down. At the top the video with a bar to jump to the exact point and the time it ends, then previous, −10 s, a big play/pause, +10 s and next (when the queue is over, on the anime sites the app knows, the next episode), Skip intro (in Automatic, with an anime AniSkip knows, it lights up only inside the recap, intro and credits, marked in colour on the time bar, and goes to their end; outside it's off and a long-press shows where it works and skips by hand. In Manual it jumps forward by as much as you pick on the first tap, remembered for each series; long-press to change it), the round D-pad with OK, Back, Home and volume; below, in a row that scrolls: sleep Timer (end of the episode, end of the queue, in 30 minutes, 1 hour or as long as you like; then pause, stop or TV off; the Fire TV keeps it, so the phone can be switched off), power on, ±30 s, go to a minute, audio, subtitles, speed, mute, menu, text from the phone keyboard and stop. It also opens from ⋮ → Remote. Without opening the app: while Kodi plays, the notification shade and the lock screen show Android's media player with Skip intro, −10 s, pause, +10 s and Next (with the screen off it doesn't talk to Kodi, so it doesn't drain the battery), and the Couch Cast quick settings tile pauses with one tap (⋮ → Settings → Add the tile). On the home screen there is also the Couch Cast widget (long-press an empty spot → Widgets): it has the remote buttons (⏮ −10 ⏯ +10 ⏭ ⏹ and Skip intro): with a video playing they control Kodi, with Kodi stopped the big button resumes the series you got to on Kodi and ⏭ sends the next episode. Long-pressing the app icon gives the shortcuts Turn on the TV, Remote, Resume the latest series and Kodi queue.
🪵 If Kodi says Playback failed: ⋮ → Settings → Kodi log. The app reads the last lines of the log from the Fire TV via ADB (like the power button, no add-ons) and with Share you send them wherever you need.
💾 Backup: ⋮ → Settings → Save a backup puts favourites, the Keep watching series (with their pictures) and settings in a .zip file, wherever you want (Drive, Downloads…), and if you like it rewrites it by itself every week. On another phone or after reinstalling the app: Restore from a backup, pick the file, then Merge (adds what is missing) or Replace everything. Kodi's password and the Fire TV key are not in the file: after restoring they are asked once more.
