Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shaka-project/static-ffmpeg-binaries
Static binaries of FFmpeg, for multiple OS & CPU combinations, built from source in a GitHub Actions workflow.
https://github.com/shaka-project/static-ffmpeg-binaries
ffmpeg ffprobe shaka shaka-packager shaka-streamer static-binaries static-binary
Last synced: about 1 month ago
JSON representation
Static binaries of FFmpeg, for multiple OS & CPU combinations, built from source in a GitHub Actions workflow.
- Host: GitHub
- URL: https://github.com/shaka-project/static-ffmpeg-binaries
- Owner: shaka-project
- License: apache-2.0
- Created: 2021-08-05T22:24:41.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-01T04:48:31.000Z (12 months ago)
- Last Synced: 2024-04-16T01:30:23.716Z (5 months ago)
- Topics: ffmpeg, ffprobe, shaka, shaka-packager, shaka-streamer, static-binaries, static-binary
- Language: Shell
- Homepage: https://github.com/joeyparrish/static-ffmpeg-binaries/releases
- Size: 135 KB
- Stars: 10
- Watchers: 5
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# static-ffmpeg-binaries
Static binaries of FFmpeg, for multiple OS & CPU combinations, built from
source in a GitHub Actions workflow.
To download binaries, visit the [releases page][releases].
# License
The GitHub Actions workflows and other scripts in this repo are covered by the
Apache license.
Please see the [workflow source][workflow], [API client source][api-client],
[version script source][version-script], and see [the Apache license][apache]
for license details.
The resulting FFmpeg binaries are built using GPL libraries, and are therefore
published under the GPL license.
Please see the [releases page][releases] for binaries, and see [FFmpeg's GPL
license][gpl] for license details.
# How are they built?
FFmpeg and its key dependencies are all built from source and linked statically.
Each run of the GitHub Actions workflow logs the MD5 sums of the binaries, and
it places the MD5 sums into the release notes. You can see how they were built,
and you can verify that they haven't been tampered with. The sums in the
workflow logs, release notes, and the binaries should all match.
You can read the details in the [workflow source][workflow].
No third-party GitHub Actions have been used in this workflow, to protect
against supply-chain attacks.
# Triggering a build
Update the version numbers as needed in the [version file][version-file], then
create a tag on the new commit. Full builds will be triggered, and binaries
will be attached to a release on the new tag.
# Tag names
Tag names should follow the form of `$FFMPEG_VERSION-$WORKFLOW_RELEASE_NUMBER`.
For example, the first time we release a build based on FFmpeg n4.4, the tag
should be "n4.4-1". If we need to update the dependencies, or change the
configuration, or make any other changes to the workflow that don't change the
FFmpeg version, the next release would be "n4.4-2". When FFmpeg n4.5 is
released upstream, we could update to that and then tag "n4.5-1".
# Local builds
You can do these steps on your actual device, or on a virtual device or
container to avoid polluting your system.
1. Set up a build environment (packages, tools, etc) similar to what is done in
the [workflow source][workflow] for your OS.
2. If you are using Linux or macOS, run `export SUDO=sudo`.
3. If you are using Linux, run `export RUNNER_OS=Linux`.
4. If you are using macOS, run `export RUNNER_OS=macOS`.
5. If you are using Linux, run `export RUNNER_OS=Windows`.
6. Create a build folder. For example, `mkdir -p build`. It does not need to
be in the git working directory.
7. Change into that build directory.
8. Create a symlink to the repo root called `repo-src` to emulate the structure
used by the workflow. For example, if `build` is inside the repo, use
`ln -s ../ repo-src`.
9. Run the build scripts in [`build-scripts`][] in numerical order.
[releases]: https://github.com/shaka-project/static-ffmpeg-binaries/releases
[workflow]: https://github.com/shaka-project/static-ffmpeg-binaries/blob/main/.github/workflows/release.yaml
[api-client]: https://github.com/shaka-project/static-ffmpeg-binaries/blob/main/api-client/main.js
[version-script]: https://github.com/shaka-project/static-ffmpeg-binaries/blob/main/get-version.sh
[version-file]: https://github.com/shaka-project/static-ffmpeg-binaries/blob/main/versions.txt
[apache]: https://github.com/shaka-project/static-ffmpeg-binaries/blob/main/LICENSE
[gpl]: https://github.com/FFmpeg/FFmpeg/blob/master/COPYING.GPLv3