hexagon6 / s3-media-browser

play your media files from s3 storage

README s3-media-browser

Description

s3-media-browser lets you watch media stored on s3.

This is a node.js-based commandline tool to select movies from a big list of files stored on s3 object storage. It can select subtitle files and access Base Auth protected endpoints.

Features

• Access media files stored on s3
• Access media files protected with HTTP Base Auth
• Select subtitle files automatically (based on media file path, .srt file extension required)
• Select from subfolders if there are more than 10 in the first hierarchy level
• Fuzzy Search inside terminal for path & file names
• Starts mpv in fullscreen (--fs) and with subtitle parameter (--subtitle=...)

Requirements

• UNIX filesystem (linux or macosx)
• mpv
• nodejs (21.5+)

Installation

• clone this repo
• Install dependencies: npm install

Setup

Configuration happens with environment-variables.

Environment variables

Required:

• URL: e.g. https://mybucketserver.example.com

Optional:

• USERNAME: e.g. mickey
• PASSWORD: just a string which only you know

Run

node index.mjs

or if you use a .env file:

node -r dotenv-safe/config index.mjs