dtplay 🎬

A lightweight web-based video player for your local video collection

dtplay transforms any folder containing videos into a beautiful web-based media center. Simply point it at your video directory, and it creates a local web server with a clean interface to browse, search, and play your videos from any device on your network.

What it does

• Browse your video folders - Automatically organizes your local video files
• Web-based player - Play videos in your browser with custom controls
• Search & filter - Quickly find videos across nested folders
• Any device access - Watch on phone, tablet, or computer via web browser
• Remember progress - Resume videos where you left off
• Network streaming - Access your videos from any device on your local network

Perfect for organizing personal video collections, home media servers, or sharing videos across devices without cloud storage.

Quick Start

Installation

npm install -g dtplay

Usage

Navigate to any folder containing videos and run:

dtplay /path/to/your/videos

Or use current directory:

dtplay .

Custom Port: Use the -p flag to specify a different port:

dtplay /path/to/your/videos -p 3000

Then open your browser to http://localhost:8454 (or your custom port)

Features

• Zero Configuration: Just point to a folder and start watching
• Universal Video Support: Plays all common video formats (MP4, AVI, MKV, etc.)
• Responsive Design: Beautiful UI that works on desktop, tablet, and mobile
• Smart Search: Real-time search with auto-expanding folders
• Keyboard Shortcuts: Full keyboard control (Space, F, M, Arrow keys)
• Progress Tracking: Remembers where you left off in each video
• Recently Played: Quick access to your recently watched videos
• Custom Controls: Volume control, playback speed, fullscreen
• Nested Folder Support: Handles complex directory structures
• Click to Play: Click anywhere on video to play/pause

Controls

Keyboard Shortcuts

• Space: Play/Pause
• F: Toggle Fullscreen
• M: Mute/Unmute
• ←/→: Seek backward/forward (10s)
• ↑/↓: Volume up/down

Mouse Controls

• Click video: Play/Pause
• Click progress bar: Seek to position
• Scroll on volume: Adjust volume

Requirements

• Node.js 14.0.0 or higher
• Modern web browser (Chrome, Firefox, Safari, Edge)

Development

Clone the repository:

git clone https://github.com/dubey-prashant/dtplay.git
cd dtplay
npm install

Build CSS:

npm run build-css

Start the server:

npm start /path/to/videos

Project Structure

dtplay/
├── index.js          # Main CLI entry point
├── views/
│   └── index.ejs     # Web UI template
├── public/
│   ├── index.css     # Compiled styles
│   └── alpine.js     # Frontend framework
└── package.json

Configuration

dtplay works out of the box with no configuration needed. Simply point it to any folder containing videos.

Command Line Options

• Directory: First argument specifies the video directory path
• -p <port>: Set custom port (default: 8454)

Examples:

dtplay /path/to/videos              # Default port 8454
dtplay /path/to/videos -p 3000      # Custom port 3000
dtplay . -p 8080                    # Current directory, port 8080

Supported Video Formats

• MP4
• WebM
• OGV
• AVI (if browser supports)
• MKV (if browser supports)
• MOV (if browser supports)

License

MIT © Prashant Dubey

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Issues

Found a bug or have a feature request? Please open an issue on GitHub.

Show Your Support

Give a ⭐️ if this project helped you!