https://github.com/guidocella/mpv-image-config

Example configuration for using mpv as an image viewer
https://github.com/guidocella/mpv-image-config

image-viewer mpv

Last synced: 3 months ago
JSON representation

Example configuration for using mpv as an image viewer

• Host: GitHub
• URL: https://github.com/guidocella/mpv-image-config
• Owner: guidocella
• License: unlicense
• Created: 2023-12-08T19:40:01.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-07-31T20:19:09.000Z (4 months ago)
• Last Synced: 2024-08-01T00:18:51.116Z (4 months ago)
• Topics: image-viewer, mpv
• Language: Lua
• Homepage:
• Size: 96.7 KB
• Stars: 4
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mpv - image-config - A configuration to use mpv as an image viewer. (Image)

README

        
This is an example configuration for using mpv as an image viewer.

## Why?

* mpv is feature rich and far more extensible than any image viewer. You can easily add original key bindings, set up conditional profiles and do pretty much anything with Lua scripts

* Zoomed images look better than in image viewers (or at least the ones I previously used), and you can even improve image quality further with GLSL shaders like [FSR](https://gist.github.com/agyild/82219c545228d70c5604f865ce0b0ce5) and [Anime4k](https://github.com/bloc97/Anime4K)

* You can use quit-watch-later with directories of images

* You can browse directories with both videos and images in one application

* Background transparency

* It supports Wayland unlike sxiv or feh

## Usage

Copy what you want to use from `mpv.conf` and `input.conf` into your versions of these files, and copy or symlink into `~~/scripts` `scripts/align-images.lua` to automatically align the OSD to the top-right corner of images bigger than the OSD and to center images smaller than the OSD, and `scripts/image-bindings.lua` for the script messages used by `input.conf`.

## How can I display thumbnails of images?

Use [mpv-gallery-view](https://github.com/occivink/mpv-gallery-view)