https://github.com/animmouse/setup-ffmpeg

Setup/Install FFmpeg for GitHub Actions
https://github.com/animmouse/setup-ffmpeg

action actions ffmpeg github-actions

Last synced: 25 days ago
JSON representation

Setup/Install FFmpeg for GitHub Actions

• Host: GitHub
• URL: https://github.com/animmouse/setup-ffmpeg
• Owner: AnimMouse
• License: mpl-2.0
• Created: 2023-02-04T12:35:16.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-08T16:46:36.000Z (about 1 month ago)
• Last Synced: 2024-10-15T09:14:52.447Z (about 1 month ago)
• Topics: action, actions, ffmpeg, github-actions
• Language: Shell
• Homepage: https://github.com/marketplace/actions/setup-ffmpeg-action
• Size: 23.4 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Setup FFmpeg for GitHub Actions

Setup [FFmpeg](https://ffmpeg.org) on GitHub Actions to use `ffmpeg` and `ffprobe`.

This action installs [FFmpeg](https://ffmpeg.org) for use in actions by installing it on tool cache using [AnimMouse/tool-cache](https://github.com/AnimMouse/tool-cache).

Ubuntu and Windows builds are provided by [BtbN/FFmpeg-Builds](https://github.com/BtbN/FFmpeg-Builds).\

macOS builds are provided by [evermeet.cx](https://evermeet.cx/ffmpeg/).

This action is implemented as a [composite](https://docs.github.com/en/actions/creating-actions/creating-a-composite-action) action.

## Usage

### FFmpeg

To use `ffmpeg`, run this action before `ffmpeg`.

```yaml

steps:

  - name: Setup FFmpeg

    uses: AnimMouse/setup-ffmpeg@v1

    

  - run: ffmpeg -i in.mkv out.mkv

```

### FFprobe

To use `ffprobe`, run this action before `ffprobe`.

```yaml

steps:

  - name: Setup FFmpeg

    uses: AnimMouse/setup-ffmpeg@v1

    

  - run: ffprobe in.mkv

```

### Specific version

You can specify the version you want. By default, this action downloads the latest release version if version is not specified.

#### Latest master

```yaml

steps:

  - name: Setup FFmpeg

    uses: AnimMouse/setup-ffmpeg@v1

    with:

      version: master

```

#### Specific release

For Ubuntu and Windows, specify the major and minor version only. Visit [BtbN/FFmpeg-Builds](https://github.com/BtbN/FFmpeg-Builds/releases/tag/latest) for the list of release tags.

```yaml

steps:

  - name: Setup FFmpeg

    uses: AnimMouse/setup-ffmpeg@v1

    with:

      version: 5.1

```

For macOS, specify the major, minor, and patch version. Visit [evermeet.cx](https://evermeet.cx/pub/ffmpeg/) for the list of release tags.

```yaml

steps:

  - name: Setup FFmpeg

    uses: AnimMouse/setup-ffmpeg@v1

    with:

      version: 5.1.2

```

### GitHub token

This action automatically uses a GitHub token in order to authenticate with GitHub API and avoid rate limiting. You can also specify your own read-only fine-grained personal access token.

```yaml

steps:

  - name: Setup FFmpeg

    uses: AnimMouse/setup-ffmpeg@v1

    with:

      token: ${{ secrets.GH_PAT }}

```

#### Similar actions

1. [FedericoCarboni/setup-ffmpeg](https://github.com/FedericoCarboni/setup-ffmpeg)