Cast videos to your TV in Amethyst

A video lands in your feed, it's actually good, and you're squinting at it on a slab of glass the size of a playing card. #amethyst now lets you fling that video straight onto the big screen: tap Cast, pick your TV, lean back. The phone goes quiet, the telly takes over, and you look like someone who has their life together.

Here's the one fact that explains everything else: your phone is not the projector here. It isn't mirroring its screen and bouncing your display across the room. It just hands the TV the video's web link and says "you fetch it." The TV streams the video itself, directly. That's why this is smooth instead of a laggy, battery-melting screen-share — and it's also why a couple of things below behave the way they do. Hold that thought.

Before you start (the boring-but-load-bearing bits)

• You need the Google Play build of #amethyst. Casting rides on the Google Cast SDK, which only exists in the Play build.
• You need a Chromecast-y receiver on your network: a Chromecast dongle, a Google TV / Chromecast-built-in telly, or a compatible soundbar or speaker.
• Phone and TV on the same Wi-Fi. Different networks, guest VLANs, "I'm on data" — no handshake, no cast.
• The video has to live on the web (an https:// link). Casting a file that's only on your phone isn't a thing the TV can fetch, so the Cast button politely hides itself for local files.

How to actually fling it

1. Open a video in your feed and start it playing like normal.
2. Tap the Cast button — the little screen-with-waves icon, sitting top-right of the player by default.
3. #amethyst pops up "Cast to…" and "Searching for devices on your Wi-Fi…" while it sniffs around for receivers.
4. Tap your TV in the list.
5. The video springs to life on the TV, your phone's player pauses itself automatically (so you're not hearing it twice in a slightly cursed echo), and the Cast icon flips to a "connected" look.

That's it. The TV is now doing the heavy lifting and your phone is just the remote.

Stopping the show

Tap the Cast button again (it's wearing its connected icon now) and choose "Stop casting." The TV stops, the credits roll, you reclaim your evening.

Tidy up the button if it's in your way

Don't love a Cast button living in the top bar? Head to Settings → Video Player, and shove "Cast to Device" into the overflow (⋯) menu — or reorder the player buttons however suits you. It's your cockpit.

What plays beautifully — and what sulks

Time for the asterisk. Casting works great with mainstream formats and gets weirdly precious with the exotic ones, because the TV is the one decoding the video (remember — the TV fetches and plays it, not your phone). Some receivers, LG and Samsung especially, are fussy eaters and will sit on a loading spinner forever rather than admit they can't read a format.

Plays well

• Standard https:// MP4 videos — H.264 video with AAC-LC audio. The bread and butter.
• Live HLS streams that use H.264 + AAC-LC.

Often won't start

• HEVC / H.265 videos, and HLS streams that only offer HEVC variants. Lots of TVs just won't decode these when cast.
• HE-AAC audio. Some videos ship this flavour of audio; the TV loads the picture and then stalls forever, which is a deeply annoying way to fail.
• HLS streams whose links carry auth tokens in the URL — the TV drops the token when fetching the next chunk and 400s itself into a corner.
• Local files and any non-https link — as mentioned, the Cast button won't even appear for these.

If a video refuses to start on the TV, it's almost never you and almost always the format being something the receiver can't chew. Try a different upload and move on with your life.

Movie night

Get some popcorn and head to

You'll be the hero of the household!

Future enhancements

Support music casting to soud bar or music streamer

Video controls in amethyst

The whole thing, in one breath

Get the Play build, put your phone and TV on the same Wi-Fi, tap Cast, pick your TV. Your phone hands the TV the link and the TV streams it directly — so it's fast and light, but also format-fussy (H.264 + AAC-LC is the happy path; HEVC and HE-AAC sulk). Drive playback from the TV remote for now, tap Cast → Stop casting when you're done, and remember F-Droid folks sit this one out. Big screen, tiny effort. Go ruin someone's "the algorithm" by showing them an actually-good video at full size.