ffmes - ffmpeg media encode script

Bash tool handling media files, DVD, audio CD, and VGM. Mainly with ffmpeg. In batch or single file.

Source media files, supported extension:

Video in *.mkv *.m4v *.m2ts *.avi *.ts *.mts *.mpg *.flv *.mp4 *.mov *.wmv *.3gp *.vob *.mpeg *.vp9 *.webm *.ogv *.bik
Audio in *.ac3 *.ape *.wma *.m4a *.mp3 *.flac *.ogg *.mpc *.ac3 *.aac *.spx *.wav *.dsf *.aud *.tta *.opus *.mod *.mpg *.wv
Subtitle in *.srt *.ssa *.sub *.sup
VGM files (see documentation)

Dependencies

ffmpeg mkvtoolnix mediainfo abcde sox ogmtools ogmrip lsdvd dvdbackup shntool cuetools uchardet coreutils findutils bc libao bchunk setcd tesseract-ocr tesseract-ocr-all wget

Install

cd && wget https://github.com/Jocker666z/ffmes/archive/master.zip
unzip master.zip && mv ffmes-master ffmes && rm master.zip
cd ffmes && chmod a+x ffmes.sh
echo "alias ffmes=\"bash ~/ffmes/ffmes.sh\"" >> ~/.bash_aliases && source ~/.bash_aliases (alias optional but recommended & handy)
Nemo action: nano ~/.local/share/nemo/actions/ffmes.nemo_action

[Nemo Action]
Active=true
Name=ffmes %N
Comment=ffmes %N
Exec=gnome-terminal -- bash -c "~/ffmes/ffmes.sh -i '%F'; bash"
Selection=any
Extensions=any;

Use

Options:

without option treat current directory
-i|--input : treat one file
-i|--input : treat in batch a specific directory
-h|--help : display help
-j|--videojobs Number of video encoding in same time (Default: 2)
-s|--select : preselect option
-v|--verbose : display ffmpeg log level as info
-vv|--fullverbose : display ffmpeg log level as debug Exemples:

if no alias:
- bash ~/ffmes/ffmes.sh with audio/video in same directory of script
- bash ~/ffmes/ffmes.sh -i DIRECTORY-TO.EDIT for directory
- bash ~/ffmes/ffmes.sh -i FILE-TO.EDIT for single video or audio
elif with alias (recommended):
- ffmes with audio/video in directory
- ffmes -i DIRECTORY-TO.EDIT for directory
- ffmes -i FILE-TO.EDIT for single video or audio
- ffmes -vv -i FILE-TO.EDIT for single video or audio, with ffmpeg in log level as debug
- ffmes -s 1 -i FILE-TO.EDIT for single video, select option 1 by-passing the main menu

Test

ffmes is tested, under Debian stable and unstable almost every day. If you encounter problems or have proposals, I am open to discussion.

Embeds binaries & scripts

All come from open source programs.

binmerge - https://github.com/putnam/binmerge
espctag - https://sourceforge.net/projects/espctag/
gbsinfo - https://github.com/mmitch/gbsplay
gbsplay - https://github.com/mmitch/gbsplay
info68 - https://sourceforge.net/projects/sc68/
opustags - https://github.com/fmang/opustags
sc68 - https://sourceforge.net/projects/sc68/
vgm2wav - https://github.com/ValleyBell/libvgm
vgmstream_cli - https://github.com/losnoco/vgmstream
vgmtag - https://github.com/vgmrips/vgmtools
zxtune - https://zxtune.bitbucket.io/

Documentations

Main menu options

Video:
- 0, DVD rip (vob, ISO, or disc)
- 1, video encoding, full custom options
- 2, copy stream to mkv with map option
Video tools:
- 10, view detailed video file informations
- 11, add audio stream or subtitle in video file
- 12, concatenate video files
- 13, extract stream(s) of video file
- 14, cut video file
- 15, add audio stream with night normalization
- 16, split mkv by chapter
- 17, change color of DVD subtitle (idx/sub)
- 18, convert DVD subtitle (idx/sub) to srt
Audio :
- 20, CD rip
- 21, VGM Rip to flac (Linux x86_64 only)
- 22, CUE Splitter to flac
- 23, audio to wav
- 24, audio to flac
- 25, audio to mp3
- 26, audio to ogg
- 27, audio to opus
Audio tools :
- 30, tag editor
- 31, view detailed audio file informations
- 32, generate png image of audio spectrum
- 33, concatenate audio files
- 34, cut audio file

Option 0 details - DVD rip (vob, ISO, or disc)

Rip DVD, include ISO and VIDEO_TS VOB
Chapters integration
Fix timestamp and display ratio to mkv file (stream copy)
launch option 1 (optional)

Option 1 details - video encoding, full custom options

Video:
- Stream copy or encoding
- Encoding options:
  - crop video
  - rotate video
  - HDR to SDR
  - change resolution
  - deinterlace
  - fix frame rate to 24fps
  - codecs:
    - x264: profile, tune, preset & bitrate (crf & cbr)
    - x265: profile, tune, HDR, preset & bitrate (crf & cbr)
    - mpeg4 (xvid): bitrate (qscale & cbr)
Audio:
- Stream copy or encoding
- Encoding options (apply to all streams):
  - codecs:
    - ac3 (ac3): bitrate (vbr & cbr)
    - opus (libopus): bitrate (vbr)
    - vorbis (libvorbis): bitrate (vbr & cbr)
    - flac (libflac): compression
  - Channels layout for ac3, flac, vorbis: 1.0, 2.0, 2.1, 3.0, 3.1, 4.0, 4.1, 5.1
  - Channels layout for opus: 1.0, 2.0, 3.0, 5.1
Container selection
- mkv & mp4 support
Map streams selection

Option 2 details - copy stream to mkv with map option

Copy stream in mkv file, with streams selection if source have more than 2 streams.

Option 15 details - add audio stream with night normalization

From inplace matroska video (with audio), add stream with night mode normalization (the amplitude of sound between heavy and weak sounds will decrease). The new stream is in opus, stereo, 320kb.

Option 16 details - split mkv by chapter

Cut one matroska video per chapter, mkvtoolnix package must be installed.

Option 17 details - change color of DVD subtitle (idx/sub)

You must run the option in a directory containing one or more pairs of idx/sub files with the same filename.

Colors palette available:

white font / black border
black font / white border
yellow font / black border
yellow font / white border

Option 18 details - convert DVD subtitle (idx/sub) to srt

You must have installed tesseract-ocr with your language support, but also ogmrip package (includes subp2tiff and subptools binaries).

Language supported: english, french, deutsch, spanish, portuguese, italian, japanese, chinese simplified, arabic, korean, russian.

Tesseract engine available:

By recognizing character patterns, fast but not reliable
By neural net (LSTM), slow but reliable (default)

Option 21 details - VGM Rip to flac

This function limited to Linux x86_64, it embeds binaries compiled for this platform, so it remains (and will) unstable as a whole. Encoding automated apply 0db peak normalization, remove silence, and false stereo files detection.

Files supported :

3DO : aif
Amiga/Atari: mod, snd, sndh
Fujitsu FM-7, FM Towns: s98
Microsoft Xbox: aix, mus, sfd, xwav
Microsoft Xbox 360: wem
NEC PC-6001, PC-6601, PC-8801, PC-9801: s98
NEC PC-Engine/TurboGrafx-16: hes
Nintendo 3DS: mus, bcstm, wem, bcwav, fsb
Nintendo DS: adx, mini2sf
Nintendo GB & GBC: gbs
Nintendo GBA: minigsf
Nintendo GameCube: adx, cfn, dsp, hps, adp, thp, mus
Nintendo N64: miniusf
Nintendo NES: nsf
Nintendo SNES: spc
Nintendo Switch: bfstm, bfwav, ktss
Nintendo Wii: mus
Sega Mark III/Master System: vgm, vgz
Sega Mega Drive/Genesis: vgm, vgz
Sega Saturn: minissf, ssf
Sega Dreamcast: dsf, spsd
Sharp X1 : s98
Sony Playstation: psf, minipsf, xa, vag
Sony Playstation 2: ads, adpcm, genh, psf2, int, minipsf2, ss2, vag, vpk, sng, vgs
Sony Playstation 3: aa3, adx, at3, genh, msf, mtaf, sgd, ss2, vag, xvag, wem
Sony Playstation 4: wem
Sony PSP: at3
Panasonic 3DO: aifc, str
PC: mod, voc, fsb
Various machines: vgm, vgz, adx, rak, tak, dat, eam, at3, raw, wem
Various machines CD-DA: bin, bin/cue, iso/cue

Option 23 details - PCM encoding

Encoding options:
- Quality :
  - signed 16-bit little-endian
  - signed 24-bit little-endian
  - signed 32-bit little-endian
  - signed 8-bit
  - unsigned 8-bit
- Channels layout 1.0 to 5.1
- False stereo files detection
- 0db peak normalization
- Silence detect & remove, at start & end (only wav & flac source)
- After encoding, option for remove all source files, if not for remove created files

Option 24 details - FLAC encoding

Encoding options:
- Quality :
  - full custom option
  - 24 bit support
- Channels layout 1.0 to 5.1
- False stereo files detection
- 0db peak normalization
- Silence detect & remove, at start & end (only wav & flac source)
- After encoding, option for remove all source files, if not for remove created files

Option 27 details - opus encoding

Encoding options:
- Bitrate
  - vbr, 64kb to 510kb (selectable options).
  - OR mode "accurate auto adapted bitrate from source", particularly useful for processing very large batches of files.
- Channels layout 1.0, 2.0, 3.0, 5.1
- False stereo files detection
- 0db peak normalization
- Silence detect & remove, at start & end (only wav & flac source)
- After encoding, option for remove all source files, if not for remove created files

Option 30 details - tag editor