https://github.com/amaliaskilton/auto-ffmpeg
Scripts to automate common ffmpeg commands for processing video in language documentation.
Science Score: 23.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
○DOI references
-
○Academic publication links
-
✓Committers with academic emails
1 of 1 committers (100.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (11.3%) to scientific vocabulary
Keywords
Repository
Scripts to automate common ffmpeg commands for processing video in language documentation.
Basic Info
Statistics
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
System requirements
You must have access to a Unix shell. This means Terminal on Mac or a Unix emulator, such as Cygwin, for Windows.
You must have FFmpeg installed and added to the path variable. Test this by typing
which ffmpeg(with no arguments) at the command line and hitting enter. If this prints a path, you have FFmpeg installed.
Purpose
Concatenate MTS video clips with shared filenames.
Transcode them to MP4 without any other changes for archiving.
Also, downsample the concatenated files to 720p resolution and MP4 format for annotation.
First time running a shell script?
Take a few minutes to check out a tutorial on Unix shell basics. My favorite is https://swcarpentry.github.io/shell-novice/. If you're running Windows, many tutorials will show you ow to download a Unix emulator.
How to run the script
As described in the input requirements, organize your video files into folders and create a text file listing the folders to transcode.
Open the command line, type
bash script_appendix.shand hit enter.
If you are not in the directory that contains the script, you will need to type bash followed by a path to the script, e.g. bash ~/Documents/Archiving_Files/script_appendix.sh..
Input requirements
You must create a text file named
folders_to_transcode.txtwith a list of the paths to the FOLDERS that need to be transcoded and downsampled.All files from the same camera at the same session (i.e., everything that should be concatenated together) must be in the SAME FOLDER.
All files from the same camera at the same session must have the SAME BASE FILENAME, and it must be followed by a unique clip ID of the format
clip{1-9}of{1-9}.If a clip should not be concatenated with anything else, its name must contain the string
clip1of1.
Examples of valid filenames:
session1_clip1of2.MTS, session1_clip2of2.MTS
session1_camera1_clip1of2.MTS, session1_camera1_clip2of2.MTS
session1_camera2_clip1of2.MTS, session1_camera2_clip2of2.MTS (will NOT concatenate with the camera1 files)
session1_clip1of1.MTS
Examples of invalid filenames:
session1.2_clip1.MTS, session1.2_clip2.MTS
session1.MTS
Output details
When you run the script, it will:
Create a single MP4 for each session for ARCHIVING. This file will have the same video and audio encoding as the inputs. Its name will be the same as the original session file name, but end in _archive.mp4.
Create a single MP4 for each session with AAC audio and 720p resolution. This file is DOWNSAMPLED so that it's suitable for annotating in ELAN. Its name will end in _720.mp4.
Additional details
Your input files must be in a format that can be concatenated to MTS. This probably means they're also MTS.
If you want to change the file name requirements, edit the lines in the script indicated with comments.# auto-ffmpeg
Owner
- Login: amaliaskilton
- Kind: user
- Repositories: 1
- Profile: https://github.com/amaliaskilton
GitHub Events
Total
- Push event: 2
- Create event: 2
Last Year
- Push event: 2
- Create event: 2
Committers
Last synced: 8 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Amalia Skilton | a****n@e****k | 3 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0