https://github.com/hexagon6/s3-media-browser

play your media files from s3 storage
https://github.com/hexagon6/s3-media-browser

Last synced: about 1 month ago
JSON representation

play your media files from s3 storage

• Host: GitHub
• URL: https://github.com/hexagon6/s3-media-browser
• Owner: hexagon6
• Created: 2023-12-25T22:12:13.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-12-25T22:13:09.000Z (about 1 year ago)
• Last Synced: 2024-05-20T00:14:40.116Z (8 months ago)
• Language: JavaScript
• Size: 12.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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](https://www.rfc-editor.org/rfc/rfc7617)

- 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`