Have you ever opened up your media library after a long day, spent twenty minutes scrolling through endless movie posters and episode lists, and ended up watching. . .absolutely nothing?
I know I have. We’ve all been trapped by choice paralysis. Back in the early 2000s, turning on the TV was a completely different experience. You’d sit on the couch, grab the remote, and start flipping channels. You’d drop in mid-broadcast, right into the middle of a favorite cartoon, a comfort sitcom, or a classic movie, with zero friction and no endless menus.
So, that made me start tinkering after work.
I wanted to bring back that exact channel-surfing nostalgia to our modern Android phones, tablets, and Android TV boxes. Today, I’m excited to share a tool I’ve been working on and building for our community: FolderTV.
Let’s dive into how it works, what’s under the hood, and how you can turn your local video collection or home network share into your own personal broadcast network.
📺 1. Bringing Back the Magic
At its core, FolderTV takes away the mental effort of picking what to watch. See, the app works on a super simple concept:
Automatic Channel Creation. All you have to do is point FolderTV to any directory on your device or network storage. Every subfolder inside instantly becomes its own distinct TV Channel. If you have a folder for classic 90s sitcoms, one for sci-fi movies, and another for anime, boom you’ve got three dedicated TV channels ready to go.
And to make sure it feels like real television, I built in 3 distinct playout strategies:
• Pure Random Drop-In: This is where the true nostalgia lies. The app picks a random video file inside the channel and automatically seeks to a random timestamp. You drop in right in the middle of the action—just like switching on channel 42 on a Tuesday afternoon back in 2004.
• Resume Progress: If you’re watching a serialized show where sequence matters, don’t worry. FolderTV remembers your exact timestamp per channel, so when you flip back, it picks up right where you left off.
• Start Fresh: Prefer traditional playback? This mode launches your channel’s files right from 0:00.
Now, you might wonder: “What if I just want to turn on my TV and immediately see a broadcast?” I added an Auto-Play feature that triggers on Startup. It completely bypasses the main menu and jumps straight into live playout the second you open the app.
📁 2. Media Ingestion & Network Storage (NAS Support)
Where are all these files coming from? Whether you keep your media stored locally on your device or sitting on a home server, FolderTV handles it without a hiccup.
First, we have full Local Storage Integration via Android’s Storage Access Framework (SAF). This means whether your videos live on internal storage, an external MicroSD card, or a USB OTG drive plugged directly into your phone or TV box, the system safely indexes your files while respecting modern Android security permissions.
But I know a lot of you folks in the community store your media on a NAS (Network Attached Storage) or a Windows shared folder (SMB). That’s why FolderTV features Native SMB Network Share integration (supporting SMB/CIFS). You can plug in your credentials, including your username, password, and domain to allow the app to stream your files directly over your Wi-Fi network.
TIP!!!
Under the Hood: Rather than downloading whole files before playing, I wrote a custom SmbDataSource that handles native byte-range streaming. It only requests the exact video chunks needed for smooth playback and instant channel flips!
And because nobody likes a frozen UI, background metadata indexing is handled asynchronously by Android’s WorkManager. It grabs video durations and attributes in the background without causing a single frame drop on your screen.
🖐️ 3. Spatial Gesture Controls & Android TV D-Pad Remote Support
A media player is only as good as its controls. If you’re on a touch screen, you shouldn’t have to hunt for tiny buttons. That’s why FolderTV uses an optional 60 / 20 / 20 Spatial Screen Layout
• Center 60% of Screen: Swiping vertically up or down instantly flips your channels with sub-second transitions. A single tap toggles your On-Screen Display (OSD), and a quick double tap kicks you straight into Picture-in-Picture mode. Swiping left or right pulls up your Channel Guide drawer.
• Left 20% Edge: Dragging vertically up or down smoothly adjusts your screen brightness.
• Right 20% Edge: Dragging up or down on the right side dynamically tweaks your media volume.
And of course, for those using Android TV, Nvidia Shield, or Fire TV devices, FolderTV includes full D-Pad remote control support. Up and Down change channels seamlessly, while Left, Right, and Select give you full navigation over overlays and menus.
📜 4. On-Screen Display (OSD) & Local Metadata Parsing
When you flip channels on old cable, a quick banner would pop up telling you what was playing. FolderTV does the exact same thing with a slick Lower-Third Info Banner.
It gives you the channel number, channel name, cleaned episode title, active playout mode, and an interactive progress bar. You also get quick-access touch buttons for Previous (⏮), Play/Pause (▶/⏸), and Next (⏭).
Now, if you download media, you know filenames can look like a total mess (Show.Title.S02E05.1080p.WEBRip.x264.AAC.mkv). FolderTV runs Regex Filename Sanitization automatically, stripping out raw release tags to present clean, readable episode titles.
Even better: if your media library includes local .nfo XML metadata files, FolderTV parses them offline to show original episode titles and full plot summaries right on your OSD banner.
🖼️ 5. Multitasking with Native Picture-in-Picture (PiP)
Sometimes you want to keep watching your channel while replying to a message or browsing the web.
FolderTV leverages Native Android PiP mode. The moment you tap home or switch to another app, your broadcast instantly shrinks down into a clean, floating Picture-in-Picture window. You can keep your ambient channel running in the corner of your phone or tablet screen while getting work done.
🔊 6. Audio & Video Hardening (Built for Power Users)
Mixed media collections can be wild. One video might have quiet dialogue with explosive action, while another file uses an obscure video codec your phone’s hardware decoder doesn’t natively support.
To handle these real-world media headaches, FolderTV includes two opt-in power user overrides:
Dynamic Range Compression (DRC) / Audio Normalization: Think of this like a smart audio night-mode. It balances soft dialogue and loud sound effects across different videos so you aren’t constantly reaching for the volume rocker.
FFmpeg Software Decoding Fallback: If you run into uncommon or legacy video codecs that confuse your device’s native hardware decoder, you can toggle FFmpeg software decoding. To protect your phone or TV box from overheating and battery drain, software decoding is capped strictly at 1080p.
🔒 7. Privacy & 100% Offline Architecture
And most importantly. . .let’s talk about your privacy. FolderTV is 100% Offline and Serverless. It doesn’t send telemetry to remote servers, doesn’t require cloud accounts, doesn’t track your viewing habits, and doesn’t rely on third-party M3U playlists.
Your network share credentials and channel metadata stay locked down on your physical device using Android’s EncryptedSharedPreferences and an offline local SQLite (Room) database. What you watch on your phone or NAS is strictly your business.
⚙️ A Quick Note on Permissions & Android Setup Because Android permissions vary across brand launchers (like Samsung’s One UI, Google Pixel, or Xiaomi’s HyperOS), here are a couple of quick things to keep in mind when setting up FolderTV for the first time:
• Storage Access: When selecting local directories or MicroSD cards, Android will prompt you through the native SAF file picker. Just grant access to the top-level folder you want to use as your broadcast root.
• Android TV Boxes: If you’re on a standalone TV box, make sure your NAS shares are reachable on your local Wi-Fi subnet. If you ever experience a slight hiccup connecting to an SMB share, just verify your local network permissions in Android Settings.
💬 Building FolderTV has been a blast, bringing back that effortless, ambient television vibe while keeping everything private, offline, and local. I’d love to hear what you folks think! Are you planning to run FolderTV on your Android phone, or are you setting it up on an Android TV living room box with a home NAS?
Leave a Reply