ffmprovisr

Repository of useful FFmpeg command lines for archivists!

What is this?

Project Objective

To facilitate better understanding of FFmpeg through collaborative sharing of useful scripts and detailed flag-level description of how each script works, so archivists can copy-paste and produce their own scripts, but also understand how and why they work.

How do I see it?

The code is found in the gh-pages branch (the default primary branch). Readme is right here. You can see the site live on GitHub pages.

You can also install the latest release on your computer with the two commands:

brew tap amiaopensource/amiaos
brew install ffmprovisr

and then call it locally with the command:

ffmprovisr

This works currently under macOS, Linux and the Linux apps on Windows (Ubuntu and Debian tested). On classic Windows you can install the last release manually and the open index.html in a browser.

Parseable list of the commands

A list of all recipes in an easily parseable ASCII text format is provided as well. It contains for each recipe its title and command in the following format:

# title of recipe 1
ffmpeg command 1
# title of recipe 2
ffmpeg command 2

...

# title of recipe n-1
ffmpeg command n-1
# title of recipe n
ffmpeg command n

The used one-liner is in the scripts folder.

How do I contribute?

You are welcome to edit the codebase yourself, or just supply the information and ask it to be added to the site.

Edit codebase

To contribute to this project directly (and more quickly), clone this repository and create a new branch (git checkout -b your-branch-name) and add or modify a new block in index.html. Then submit a pull request and the maintainers will review and integrate your code. There is a commented-out sample block available at the bottom of index.html that can be as a guideline for your command.

Make a request

If you are having trouble with coding it yourself or with GitHub, feel free to submit an issue with the kind of command you would like to see added to the site.

General help

If you want to help but don't have a new script to add, you can help us by testing out the scripts available, by refining or clarifying the documentation, or creating an issue for anything that sounds confusing and requires clarification.

Code of Conduct

You can read our contributor code of conduct here.

Maintainers

Ashley Blewer, Katherine Frances Nagels, Kieran O'Leary and Andrew Weaver

Contributors

• Gathered using octohatrack

Code Contributors: ablwr (Ashley)
bastibeckr (Basti Becker)
b00giehead (Joanna White)
bturkus
dericed (Dave Rice)
edsu (Ed Summers)
jamessam (Jim Sam)
jfarbowitz (Jonathan Farbowitz)
kfrn (Katherine Frances Nagels)
kgrons (Kathryn Gronsbell)
kieranjol (Kieran O'Leary)
llogan (Lou)
mgiraldo (Mauricio Giraldo)
pjotrek-b (Peter B.)
privatezero (Andrew Weaver)
retokromer (Reto Kromer)
rfraimow

All Contributors: ablwr (Ashley)
audiovisualopen
bastibeckr (Basti Becker)
b00giehead (Joanna White)
brainwane (Sumana Harihareswara)
bturkus
dericed (Dave Rice)
drodz11 (Dave Rodriguez)
edsu (Ed Summers)
EG-tech (Ethan Gates)
federicomenaquintero (Federico Mena Quintero)
Fizz24
GregH18
jamessam (Jim Sam)
jfarbowitz (Jonathan Farbowitz)
JonnyTech
jronallo (Jason Ronallo)
kellyhaydon (metacynic)
kfrn (Katherine Frances Nagels)
kgrons (Kathryn Gronsbell)
kieranjol (Kieran O'Leary)
llogan (Lou)
mgiraldo (Mauricio Giraldo)
mulvya
nkrabben (Nick Krabbenhoeft)
pjotrek-b (Peter B.)
privatezero (Andrew Weaver)
retokromer (Reto Kromer)
rfraimow
richardpl (Paul B Mahol)
ross-spencer (Ross Spencer)
todrobbins (Tod Robbins)

Repo: amiaopensource/ffmprovisr
Code Contributors: 17
All Contributors: 32
Last updated: 2019-02-11

AVHack Team

Association of Moving Image Archivists & Digital Library Federation Hack Day 2015

Ashley Blewer, Eddy Colloton, Rebecca Dillmeier, Jonathan Farbowitz, Rebecca Fraimow, Samuel Gutterman, Kelly Haydon, Reto Kromer, Nicole Martin, Katherine Frances Nagels, Kieran O'Leary, Catriona Schlosser, Ben Turkus

Sister projects

The Cable Bible: A Guide to Cables and Connectors Used for Audiovisual Tech
Script Ahoy: Community Resource for Archivists and Librarians Scripting
sourcecaster: helps you use the command line to work through common challenges that come up when working with digital primary sources.

License

This work by ffmprovisr is licensed under a Creative Commons Attribution 4.0 International License.
Based on a work at https://github.com/amiaopensource/ffmprovisr.