{"id":13578387,"url":"https://github.com/hoyon/mpv-mpris","last_synced_at":"2026-02-24T04:02:51.257Z","repository":{"id":38805344,"uuid":"93654658","full_name":"hoyon/mpv-mpris","owner":"hoyon","description":"MPRIS plugin for mpv","archived":false,"fork":false,"pushed_at":"2026-01-06T20:30:44.000Z","size":106,"stargazers_count":686,"open_issues_count":1,"forks_count":41,"subscribers_count":8,"default_branch":"master","last_synced_at":"2026-01-08T21:55:56.092Z","etag":null,"topics":["linux","mpris","mpv"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hoyon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-06-07T16:08:29.000Z","updated_at":"2026-01-08T13:31:19.000Z","dependencies_parsed_at":"2023-01-31T05:15:25.582Z","dependency_job_id":"baaa8db9-8f33-472d-9777-a8215bf78b39","html_url":"https://github.com/hoyon/mpv-mpris","commit_stats":{"total_commits":78,"total_committers":20,"mean_commits":3.9,"dds":0.5128205128205128,"last_synced_commit":"f759c86688288c5ec7034a3812c52d62d7994053"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/hoyon/mpv-mpris","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoyon%2Fmpv-mpris","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoyon%2Fmpv-mpris/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoyon%2Fmpv-mpris/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoyon%2Fmpv-mpris/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hoyon","download_url":"https://codeload.github.com/hoyon/mpv-mpris/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoyon%2Fmpv-mpris/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29771049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:01:02.180Z","status":"ssl_error","status_checked_at":"2026-02-24T03:59:49.901Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","mpris","mpv"],"created_at":"2024-08-01T15:01:30.132Z","updated_at":"2026-02-24T04:02:51.219Z","avatar_url":"https://github.com/hoyon.png","language":"C","funding_links":[],"categories":["C","Other"],"sub_categories":[],"readme":"# mpv-mpris\n\n`mpv-mpris` is a plugin for mpv which allows control of the player using\nstandard media keys. \n\nThis plugin implements the MPRIS D-Bus interface and can be controlled using\ntools such as [playerctl](https://github.com/acrisci/playerctl) or through many\nopen source desktop environments, such as GNOME and KDE.\n\n## Compatibility\n\nThis plugin requires mpv to be built with `--enable-cplugins` (default as of mpv 0.26)\nand to be built with Lua support (to enable loading scripts).\n\n## Loading\n\nmpv will automatically load the plugin from the following directories:\n\n- `/etc/mpv/scripts`: for all users\n- `~/.config/mpv/scripts`: for current user\n\nmpv can also manually load the plugin from other directories:\n\n```\nmpv --script=/path/to/mpris.so video.mp4\n```\n\n## Install\n\nPackages are available for many [distributions](https://repology.org/project/mpv-mpris/versions).\n\nFor 64-bit x86 Linux a pre-built version is [available here](https://github.com/hoyon/mpv-mpris/releases)\nand can be copied into one of the mpv scripts directories documented above.\n\nA self-built `mpris.so` file can be installed with `make install` and will\nbe installed to the appropriate mpv scripts directory for your current user\nor to the mpv system wide scripts directory for all users when you install as root.\n\n## Build\n\nBuild requirements:\n - C99 compiler (gcc or clang)\n - pkg-config\n - mpv development files\n - glib development files\n - gio development files\n - libavformat development files\n\nBuilding should be as simple as running `make` in the source code directory.\n\n## Test\n\nTest requirements:\n - mpv (for loading the mpv mpris plugin)\n - mpv-mpris plugin (installed or self-built)\n - playerctl (for sending MPRIS commands via D-Bus)\n - dbus-send (from dbus, for sending MPRIS commands via D-Bus)\n - sound-theme-freedesktop (for a file to play in mpv)\n - bash (for running the test scripts)\n - dbus-run-session (from dbus, for simulating a D-Bus session)\n - xvfb and xauth (for simulating an X11 session)\n - jq (for mpv IPC JSON generation and parsing)\n - socat (for passing JSON to/from mpv IPC sockets)\n - awk (for redirecting parts of mpv stderr logs)\n\nTesting should be as simple as running `make test` in the source code directory.\n\nThe stderr of the tests will be empty unless there are mpv/etc issues.\n\nThe tests accept these environment variables as parameters:\n - `MPV_MPRIS_TEST_PLUGIN`: the mpv mpris plugin file to test, must be\n   readable and executable, defaults to the self-built one. Set it to an\n   empty string to only load and test an already installed mpv mpris plugin.\n - `MPV_MPRIS_TEST_PLAY`: the file to play during tests, defaults to\n   `/usr/share/sounds/freedesktop/stereo/alarm-clock-elapsed.oga`.\n   Use a file at most 10 seconds long or the tests will take a long time.\n - `MPV_MPRIS_TEST_MPV_IPC`: dir for mpv IPC, default is test dir.\n - `MPV_MPRIS_TEST_DBUS`: dir for D-Bus sockets, default is test dir.\n   Sets the `XDG_RUNTIME_DIR` env var so D-Bus uses the dir.\n - `MPV_MPRIS_TEST_XAUTH`: dir for Xauthority files, default is test dir.\n - `MPV_MPRIS_TEST_LOG`: dir for mpv/socat logs, default is test dir.\n - `MPV_MPRIS_TEST_TMP`: dir for temp files, default is test dir.\n   Sets the `TEMPDIR`, `TMPDIR`, `TEMP` and `TMP` env vars.\n - `MPV_MPRIS_TEST_NO_STDERR`: disable extra printing of the errors printed\n   to stderr. This is for when the test scenario already does this.\n\nThese parameters are useful for running the tests in alternate test scenarios.\n\n## D-Bus interfaces\n\nImplemented:\n- `org.mpris.MediaPlayer2` \n- `org.mpris.MediaPlayer2.Player` \n\nNot implemented:\n- `org.mpris.MediaPlayer2.TrackList`\n- `org.mpris.MediaPlayer2.Playlists`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoyon%2Fmpv-mpris","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhoyon%2Fmpv-mpris","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoyon%2Fmpv-mpris/lists"}