Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

kasper93/mpv360

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mpv360.lua

Interactive 360° Video Viewer for mpv

This script enables interactive viewing of 360° videos in the mpv media player. It supports multiple projection formats (equirectangular, dual fisheye, dual half-equirectangular, half-equirectangular, cylindrical, Equi-Angular Cubemap) with full camera control through mouse and keyboard inputs.

Features

  • Equirectangular, Dual Fisheye, Dual Half-Equirectangular, Half-Equirectangular, Cylindrical, Equi-Angular Cubemap
  • Six degrees of freedom movement with mouse look and keyboard navigation
  • Linear, Mitchell-Netravali and Lanczos filtering
  • Left/Right eye selection for dual eye (stereo) formats
  • SBS output (Both eyes) for dual eye (stereo) formats
  • GLSL shader for optimal performance

Installation

  1. Place the files in your mpv config directory:
    • Linux/macOS: ~/.config/mpv/
    • Windows: %APPDATA%/mpv/
  2. Optionally configure keybindings in mpv360.conf

Configuration

By default, the script doesn't bind any keys. Only script messages are bound.

To enable keybindings:

  • Use the default configuration (mpv360.conf) or create a custom one.

  • Alternatively you can use input.conf to bind keys, look at commands table in script for available commands.

    Example:

    Ctrl+r script-binding mpv360/reset-view
    

Usage

  • Press configured toggle key (default: Ctrl+e) to enable/disable 360° mode
  • Press show-help (default: Ctrl+t) to see all controls
  • Ctrl+Left Click to enable mouse look, ESC or Ctrl+Left Click to exit
  • Use configured keys for camera control (default: Ctrl+<arrows>)
  • For SBS output, select Both eye (Ctrl+E to switch eye).

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.