Wes Ellis./ a personal notebook
Technology. Stories. Side projects.
A few things worth writing down.
← Back to Resources & Recommendations

Resources & Recommendations

Roku Developer Mode, and Playing Your Own Files Off a USB Drive

A hand pointing a remote control at a TV showing a streaming menu.
THE SHORT VERSION4 points
  • Developer mode is a secret remote sequence that turns on a web installer for your own channel.
  • Only one sideloaded channel lives on the device at a time. Uploading a new one replaces the old.
  • To watch your own videos, music and photos, you don't need developer mode at all. Roku Media Player does it.
  • Press Star on the USB drive to scan it, then search it, and browse music by artist or album.

My note on this is titled "Roku Developer Mode and Media Player," which tells you I'd filed two different things under one heading. They're related only in that both involve getting your own stuff onto a Roku. One is for people building a channel. The other is for people who have a folder of videos on a thumb drive. Most people want the second one.

Checked against Roku's docs in September 2026.

Developer mode: sideloading your own channel

Roku channels are written in BrightScript, Roku's own language, and packaged as a zip. Developer mode lets you install one straight from your computer, without going through the channel store. That's what "sideloading" means here.

To turn it on, press this on the remote:

Home three times, Up twice, then Right, Left, Right, Left, Right.

A developer settings screen appears. From there:

  1. Write down the URL it shows. That's your Roku's address on your network.
  2. Enable the developer installer.
  3. Accept the developer tools license agreement.
  4. Set a password for the installer. It's case-sensitive.
  5. Let it reboot.

After the reboot, open that URL in a browser on the same network. It asks for a username and password. The username is rokudev, and the password is the one you just set. You'll get a page where you can upload your channel's zip file.

A couple of things that caught me reading the docs:

  • Only one sideloaded channel at a time. Upload a different one and it replaces the first. It's a test slot, not a second channel store.
  • You can't reinstall the identical version without deleting it first. If an upload seems to do nothing, that's usually why.

Heads up

Developer mode puts a small web installer on your home network, guarded by that one password. Pick a real password, not 1234, and turn the mode off if you're not using it.

Roku Media Player: your own files, no tricks

If what you really want is to play a video file on the TV, skip all of the above. Roku Media Player is a free channel from Roku that plays video, music and photos from a USB drive plugged into the Roku, if your model has a USB port. It can also play from media servers on your network that speak DLNA.

The basics:

  1. Plug in the drive. If the channel isn't installed, the Roku should offer to add it.
  2. Open Roku Media Player and pick a media type: All, Video, Audio or Photo.
  3. Pick the USB drive, then browse the folders with the remote.
  4. Highlight a file and press OK or Play. Back stops playback.

Files your model can't play just don't show up in the list. Supported formats vary by Roku device, so if something's missing, check the format against your model before blaming the drive.

Scanning and searching the drive

Most of my note is about this part, because it isn't obvious. Roku Media Player can build a small database of what's on the drive, and once it has one you can search it.

Want to Do this
Build the database Highlight the USB drive, press Star, choose Scan
Search Highlight the drive, press Star, choose Search, start typing
Keep the database around Put a microSD card in the Roku, if it has a slot. Scan results are saved there too
Browse music by tag After a scan, choose Audio. <by Genre>, <by Artist> and <by Album> folders appear

It also builds the database quietly as you browse folders, so a drive you've clicked around in before may already be searchable. For a big drive, a full scan can take a while. Let it finish.

The music folders come from the tags inside your audio files, so a tidy tag job pays off here. A folder full of Track 01.mp3 files will all land under one mystery artist.

Which one you need

You want to Use
Watch or listen to your own files Roku Media Player
Build and test your own channel Developer mode
Make your library feel like cable Something heavier

That last row is a rabbit hole I've been down. The FieldStation42 cable box does it on a Raspberry PiA small, cheap single-board computer that runs Linux. Hobbyists put them inside just about everything.More: Building a FieldStation42 Cable Box and a CRTCathode-ray tube. The deep, heavy glass TV everybody had before flat screens.More: CRT 90s TV: Channel Surfing Like It's 1996, on a Raspberry Pi, and Kaybl is my attempt at a channel guide over a Plex or Jellyfin library. For a folder of home videos on a thumb drive, though, Roku Media Player is the whole answer.