{"id":13905612,"url":"https://github.com/alfg/ffmpegd","last_synced_at":"2025-07-20T07:36:35.127Z","repository":{"id":49830499,"uuid":"341477241","full_name":"alfg/ffmpegd","owner":"alfg","description":"FFmpeg websocket server for ffmpeg-commander.","archived":false,"fork":false,"pushed_at":"2022-07-27T04:50:21.000Z","size":2154,"stargazers_count":74,"open_issues_count":1,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-22T17:01:45.859Z","etag":null,"topics":["encoding","ffmpeg","multimedia","video","websocket"],"latest_commit_sha":null,"homepage":"https://github.com/alfg/ffmpegd","language":"Go","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/alfg.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}},"created_at":"2021-02-23T08:10:38.000Z","updated_at":"2024-11-19T03:53:52.000Z","dependencies_parsed_at":"2022-09-10T18:30:08.629Z","dependency_job_id":null,"html_url":"https://github.com/alfg/ffmpegd","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfg%2Fffmpegd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfg%2Fffmpegd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfg%2Fffmpegd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alfg%2Fffmpegd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alfg","download_url":"https://codeload.github.com/alfg/ffmpegd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247644080,"owners_count":20972221,"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":["encoding","ffmpeg","multimedia","video","websocket"],"created_at":"2024-08-06T23:01:19.783Z","updated_at":"2025-04-07T11:31:39.145Z","avatar_url":"https://github.com/alfg.png","language":"Go","funding_links":[],"categories":["Go","HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"# `ffmpegd`\n[FFmpeg](https://www.ffmpeg.org/) websocket server and API for [FFmpeg Commander](https://alfg.github.io/ffmpeg-commander).\n\n**Currently a work-in-progress! Bugs and breaking changes are expected.*\n\n[![GoDoc](https://godoc.org/github.com/alfg/ffmpegd?status.svg)](https://godoc.org/github.com/alfg/ffmpegd)\n[![Go Report Card](https://goreportcard.com/badge/github.com/alfg/ffmpegd)](https://goreportcard.com/report/github.com/alfg/ffmpegd)\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/alfg/ffmpegd.svg)](https://hub.docker.com/r/alfg/ffmpegd/)\n[![Docker Automated build](https://img.shields.io/docker/automated/alfg/ffmpegd.svg)](https://hub.docker.com/r/alfg/ffmpegd/builds/)\n\n[![Go](https://github.com/alfg/ffmpegd/actions/workflows/go.yml/badge.svg)](https://github.com/alfg/ffmpegd/actions/workflows/go.yml)\n[![Docker Image Push](https://github.com/alfg/ffmpegd/actions/workflows/docker.yml/badge.svg)](https://github.com/alfg/ffmpegd/actions/workflows/docker.yml)\n[![goreleaser](https://github.com/alfg/ffmpegd/actions/workflows/release.yml/badge.svg)](https://github.com/alfg/ffmpegd/actions/workflows/release.yml)\n\n## How It Works\n`ffmpegd` connects [FFmpeg Commander](https://alfg.github.io/ffmpeg-commander) to [ffmpeg](https://www.ffmpeg.org/) by providing a websocket server to send encode tasks and receive realtime progress updates back to the browser. This allows using `ffmpeg-commander` as a GUI for `ffmpeg`.\n\nThe goal is to provide a simple interface for sending FFmpeg tasks from the browser (and other supported clients in the future) to your local machine.\n\nSee [Usage](#Usage) for more details.\n\n```\n          process              websocket\n[ffmpeg] \u003c-------\u003e [ffmpegd] \u003c-----------\u003e [ffmpeg-commander]\n```\n\n## Install\n### Go\n```\n$ go install github.com/alfg/ffmpegd@latest\n```\n\n### Download\nRelease binaries for your platform at:\nhttps://github.com/alfg/ffmpegd/releases\n\n### Docker\nA Docker image is available with [alfg/ffmpeg](https://github.com/alfg/docker-ffmpeg) build installed:\n\n```\n$ docker run -it -p 8080:8080 -v /tmp/:/home alfg/ffmpegd\n```\n\nOr via GitHub Container Registry:\n```\n$ docker run -it -p 8080:8080 -v /tmp/:/home ghcr.io/alfg/ffmpegd\n```\n\nOr using the `docker-compose` example:\n```\n$ docker-compose up ffmpegd\n```\n\n### Homebrew\nTBD\n\n## Usage\n* [ffmpeg](https://www.ffmpeg.org/download.html) must be installed and available on your `$PATH`.\n* Run `ffmpegd`:\n```\n$ ffmpegd\n```\n\nThis wil start the websocket server in your current working directory and wait for a connection.\n\n* Go to https://alfg.github.io/ffmpeg-commander/ in the browser\n* Enable `ffmpegd` in Options.\n* Once connected, you can start sending encode jobs to ffmpegd!\n\n## Example\n### `ffmpegd` with a job in progress from `ffmpeg-commander`\n```\n$ ffmpegd\n\n███████╗███████╗███╗   ███╗██████╗ ███████╗ ██████╗ ██████╗\n██╔════╝██╔════╝████╗ ████║██╔══██╗██╔════╝██╔════╝ ██╔══██╗\n█████╗  █████╗  ██╔████╔██║██████╔╝█████╗  ██║  ███╗██║  ██║\n██╔══╝  ██╔══╝  ██║╚██╔╝██║██╔═══╝ ██╔══╝  ██║   ██║██║  ██║\n██║     ██║     ██║ ╚═╝ ██║██║     ███████╗╚██████╔╝██████╔╝\n╚═╝     ╚═╝     ╚═╝     ╚═╝╚═╝     ╚══════╝ ╚═════╝ ╚═════╝\n                                                      v0.0.8\n\n[ffmpegd] - websocket server for ffmpeg-commander.\n\n  Checking FFmpeg version....4.3.1\n  Checking FFprobe version...4.3.1\n\n  Server started on port :8080.\n  - Go to https://alfg.github.io/ffmpeg-commander to connect!\n  - ffmpegd must be enabled in ffmpeg-commander options!\n\nEncoding... 6111 / 17620 (34.68%) 3.37x @ 80.77\n```\n![ffmpeg-commander](screenshot.png)\n\n## WebSocket Demo\nSee [demo](demo/) for a websocket client example.\n\n## Develop\n```\ngo build -v\n./ffmpegd\n```\n\n#### Tests\n```\ngo test ./...\n```\n\n## TODO\n* Logging levels and output\n\n## License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falfg%2Fffmpegd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falfg%2Fffmpegd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falfg%2Fffmpegd/lists"}