mpvipc-async/README.md
h7x4 2ed8025046
All checks were successful
Build and test / check (pull_request) Successful in 1m58s
Build and test / build (pull_request) Successful in 1m59s
Build and test / docs (pull_request) Successful in 2m44s
Build and test / test (pull_request) Successful in 3m19s
Build and test / build (push) Successful in 1m56s
Build and test / check (push) Successful in 1m50s
Build and test / docs (push) Successful in 2m45s
Build and test / test (push) Successful in 3m29s
fix examples and documentation
2024-05-04 00:23:02 +02:00

34 lines
1009 B
Markdown

[![Coverage](https://pvv.ntnu.no/~oysteikt/gitea/mpvipc/master/coverage/badges/for_the_badge.svg)](https://pvv.ntnu.no/~oysteikt/gitea/mpvipc/master/coverage/src/)
[![Docs](https://img.shields.io/badge/docs-blue?style=for-the-badge&logo=rust)](https://pvv.ntnu.no/~oysteikt/gitea/mpvipc/master/docs/mpvipc/)
# mpvipc
A small library which provides bindings to control existing mpv instances through sockets.
## Dependencies
- `mpv`
- `cargo` (make dependency)
- `cargo-nextest` (test depencency)
- `grcov` (test depencency)
## Example
Make sure mpv is started with the following option:
```bash
$ mpv --input-ipc-server=/tmp/mpv.sock --idle
```
Here is a small code example which connects to the socket `/tmp/mpv.sock` and toggles playback.
```rust
use mpvipc::*;
#[tokio::main]
async fn main() -> Result<(), MpvError> {
let mpv = Mpv::connect("/tmp/mpv.sock").await?;
let paused: bool = mpv.get_property("pause").await?;
mpv.set_property("pause", !paused).expect("Error pausing");
}
```