{"id":23640990,"url":"https://github.com/pedromsilvapt/unicast-mpv","last_synced_at":"2025-11-10T08:30:15.228Z","repository":{"id":46326574,"uuid":"181734584","full_name":"pedromsilvapt/unicast-mpv","owner":"pedromsilvapt","description":"A simple module that exposes MPV to be controlled through a RPC WebSockets API, that can be used with the unicast server","archived":false,"fork":false,"pushed_at":"2022-07-18T19:30:52.000Z","size":50,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-28T09:53:38.555Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pedromsilvapt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-16T17:18:11.000Z","updated_at":"2020-10-15T12:16:59.000Z","dependencies_parsed_at":"2022-09-05T14:11:39.339Z","dependency_job_id":null,"html_url":"https://github.com/pedromsilvapt/unicast-mpv","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedromsilvapt%2Funicast-mpv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedromsilvapt%2Funicast-mpv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedromsilvapt%2Funicast-mpv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedromsilvapt%2Funicast-mpv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pedromsilvapt","download_url":"https://codeload.github.com/pedromsilvapt/unicast-mpv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239579348,"owners_count":19662612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-12-28T09:53:51.375Z","updated_at":"2025-11-10T08:30:15.168Z","avatar_url":"https://github.com/pedromsilvapt.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# unicast-mpv\n\u003e A simple module that exposes [MPV](http://mpv.io/) to be controlled through a [RPC WebSockets](https://github.com/elpheria/rpc-websockets) API, that can be used with the [unicast](https://github.com/pedromsilvapt/unicast) server\n\n## Installation\nThis module can be used as a terminal application by simply installing it globally:\n\n```shell\nnpm install -g unicast-mpv\n```\n## Usage\nSimply execute the application. The path to an YAML config file can optionally be passed as an argument. By default, the server listens on the port `2019`.\n```shell\n# With only default configuration\nunicast-mpv\n# Or with custom configuration\nunicast-mpv path/to/configuration.yaml\n```\n\n## Configuration\nBelow is the default configuration.\n```yaml\nplayer:\n    # Launch the player window in full screen\n    fullscreen: true\n\n    # Index of the monitor (0-32) where to open the player window\n    monitor: null\n\n    # Force the player window to always be on top\n    onTop: false\n\n    # If false, when stopping a video, the player window is kept open. If true, it is automatically closed\n    quitOnStop: true\n\n    # Determines if the player restarts everytime the user plays a new media when something was already playing\n    restartOnPlay: false\n\nserver:\n    # The network port where the socket server will listen for incoming connections\n    port: 2019\n\n    # The network interface the server will bind to\n    address: 0.0.0.0\n\n    # Specify a password to authenticate clients. Null means no password\n    authenticate: null\n\n    # MPV provides a command that allows to run arbitrary system commands. In unprotected environments, \n    # this can present a security risk. Setting this value to true disables the command from socket requests\n    disableRunCommand: false\n```\n\nOn Windows, the following configuration file is also loaded. If the MPV binary is in a different folder, then it should be changed to reflect that.\n```yaml\nplayer:\n    binary: C:\\Program Files\\mpv\\mpv.exe\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedromsilvapt%2Funicast-mpv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpedromsilvapt%2Funicast-mpv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedromsilvapt%2Funicast-mpv/lists"}