Skip to content

Module: Local Files

Ant edited this page Jun 5, 2026 · 7 revisions

Allows you to browse and view video content from a local or mounted directory.

Current Features

Browse

  • Folder browsing
  • M3U playlist directory creation

Playback (through MPV)

  • Supported file types: "mp4", "mkv", "avi", "mov", "m4v", "webm", "wmv", "flv", "f4v", "mpg", "mpeg", "vob"
  • Playlist support using m3u and m3u8 files
  • Loop playback support
  • Progress save and resume
  • Switch audio/subtitle tracks during playback
  • Custom MPV OSC/OSD designed for CRT usage

Settings

Option Values Info
Enabled On/Off Sets if the Local Files module should display in the main module list when you start 240-MP.
Media Directory Default or User Selected Allows you to choose where the Local Files module will look for content
Loop Playback On/Off Defines if playback should loop or not
Resume Playback Ask/Always/Never 'Ask' will present you with an option to restart playback or resume, 'Always' will resume without asking and 'Never' will restart playback from the beginning without asking

Adding content

Local Files will display and allow you to play any of the supported file types listed above as long as they exist in the local files media directory.

Media Directory

The default media directory is located at:

  • RaspberryPi: ~/.local/share/240-MP/media
  • MacOS: ~/Library/Application Support/240-MP/media

And you can change that to any directory you like (a different local folder, usb, remote share, etc...) through the Media Directory option in settings.

Folder browsing is supported as well so feel free to organize your files in the media directory however you prefer.

Playlists

Local Files also supports .m3u/.m3u8 playlists and you can use them to create playlists for things like a season of a given TV Show. Combined with the Resume Playback setting, playlists can allow you to keep track of where you are in a given list of videos.

Future Ideas

  • Music/Audio playback support

Clone this wiki locally