Static HTML video gallery generator.

vsite is a command-line tool written in Go that scans a directory containing video files and generates static HTML pages for browsing and playing videos in the browser.

• Recursive scanning of directories and subdirectories
• Generation of listing pages with folder navigation
• Integrated video player (Plyr) with advanced controls
• Automatic conversion of incompatible formats to MP4
• NVIDIA GPU acceleration support (NVENC)
• Responsive design with dark theme
• Video navigation (previous/next)
• Keyboard shortcuts in player
• Auto-play next video

git clone https://github.com/rdeavila/vsite.git
cd vsite
make build

make               # Build optimized binary (default)
make build         # Build optimized binary
make build-debug   # Build with debug symbols
make build-all     # Build for all platforms
make build-linux   # Build for Linux amd64
make build-darwin  # Build for macOS arm64
make build-windows # Build for Windows amd64
make clean         # Remove build artifacts
make test          # Run tests
make deps          # Download dependencies
make install       # Install to /usr/local/bin
make install-user  # Install to ~/.local/bin
make uninstall     # Uninstall
make info          # Show binary information
make compress      # Compress with UPX
make serve         # Start HTTP server with video seeking support
make help          # Show help

To use video conversion (--convert):

# Debian/Ubuntu
sudo apt install ffmpeg

# Fedora/RHEL
sudo dnf install ffmpeg

vsite [options] <directory>

Generate HTML gallery:

vsite /path/to/videos

Generate with custom title:

vsite --title "My Collection" /path/to/videos

Convert incompatible videos and generate HTML:

vsite --convert /path/to/videos

Convert using NVIDIA GPU:

vsite --convert --gpu /path/to/videos

Clean generated HTML files:

vsite --clean /path/to/videos

Remove converted MP4 files (keep originals):

vsite --clean-converted /path/to/videos

Remove original files that were converted (keep MP4):

vsite --clean-original /path/to/videos

To play videos with seeking support (clicking on the progress bar), you need an HTTP server that supports range requests.

cd /path/to/videos
make -C /path/to/vsite serve

This starts http-server on port 8000 with range request support.

# Node.js http-server
npx http-server -p 8000

# Python with range support
pip install rangehttpserver
python -m RangeHTTPServer 8000

Note: Python's built-in http.server does NOT support range requests, which means video seeking will not work properly.

• .mp4 (H.264)
• .webm (VP8/VP9)
• .ogv (Theora)

• .avi
• .mkv
• .mov
• .wmv
• .flv

Use the --convert option to automatically convert these formats to MP4.

HTML files are created directly in the video directory:

/your/directory/
├── video1.mp4
├── video2.mp4
├── subfolder/
│   └── video3.mp4
├── index.html              # Main page
├── style.css               # CSS styles
├── subfolder_index.html    # Subfolder index
├── player_video1.html      # video1 player
├── player_video2.html      # video2 player
└── player_subfolder_video3.html

The --gpu option uses NVIDIA's NVENC encoder to accelerate video conversion up to 10x compared to CPU.

1. NVENC-compatible NVIDIA GPU
2. NVIDIA driver installed (nvidia-smi must work)
3. ffmpeg compiled with NVENC support

# Debian/Ubuntu
sudo apt install nvidia-driver-535

# Fedora/RHEL
sudo dnf install akmod-nvidia

The player uses the Video.js library and offers:

• Playback controls (play, pause, volume, fullscreen)
• Progress bar with seeking
• Speed control (0.5x to 2x)
• Picture-in-Picture
• Navigation between videos in the same directory
• Chromecast support (when served over HTTPS on a public domain)

vsite/
├── main.go                 # CLI entry point
├── go.mod                  # Go module
├── Makefile                # Build automation
├── README.md               # Documentation
├── LICENSE                 # MIT License
└── generator/
    ├── generator.go        # HTML generation logic
    └── templates/
        ├── index.html      # Listing template
        └── player.html     # Player template

MIT License - see LICENSE file for details.