https://github.com/tsl0922/mpv-debug-plugin

A debug tool for mpv script developers
https://github.com/tsl0922/mpv-debug-plugin

cpp mpv mpv-script

Last synced: 19 days ago
JSON representation

A debug tool for mpv script developers

• Host: GitHub
• URL: https://github.com/tsl0922/mpv-debug-plugin
• Owner: tsl0922
• License: gpl-2.0
• Created: 2023-12-19T15:09:28.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-05-04T07:14:59.000Z (7 months ago)
• Last Synced: 2024-10-14T12:18:57.496Z (about 1 month ago)
• Topics: cpp, mpv, mpv-script
• Language: C++
• Homepage:
• Size: 1.24 MB
• Stars: 20
• Watchers: 5
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-mpv - debug-plugin - A debug tool for mpv script developers, with GUI support for properties and console. (Other)

README

        
# mpv-debug-plugin

a debug tool for [mpv](https://mpv.io), based on the [C PLUGINS](https://mpv.io/manual/master/#c-plugins) API.

![screenshot](screenshot/debug.jpg)

See also [mpv-menu-plugin](https://github.com/tsl0922/mpv-menu-plugin).

## Features

- Visual view of mpv's internal properties

- Console with completion, history support

- Colorful mpv logs view with filter support

## Installation

Download the plugin from Releases.

- **Windows:** mpv >= `0.37.0` is required, place `debug.dll` in your mpv `scripts` folder

- **Linux:** mpv >= `0.24.0` is required, place `debug.so` in your mpv `scripts` folder

Check if the `cplugins` feature is compiled into mpv if the plugin is not loaded.

## Configuration

> **NOTE:** If you changed the dll name, `script-message-to` target should apply too.

Add a keybinding to show debug window (required):

**input.conf**

```

` script-message-to debug show

```

**~~/script-opts/debug.conf**

- `font-path=`: use a custom TTF font

- `font-size=`: custom font size, default: `13`

- `log-lines=`: set the log buffer size, default: `5000`

To change the log level to verbose on start, add `msg-level=all=v` to `mpv.conf`.

# Credits

- [fmt](https://fmt.dev): A modern formatting library

- [imgui](https://github.com/ocornut/imgui): Bloat-free Graphical User interface for C++ with minimal dependencies

- [ImPlay](https://github.com/tsl0922/ImPlay): This debug tool was extracted from ImPlay

# License

[GPLv2](LICENSE.txt).