qmcgaw/tinier

By qmcgaw

•Updated about 1 year ago

Tinier is here to make your media files tinier, with a small quality loss.

Image

5.6K

Overview Tags

qmcgaw/tinier repository overview

⁠Tinier

⁠Features

Tinier is a safe, easy to use program to make your media files tinier, with a small quality loss.

Video files (using libsvtav1 by default)
Image files
Audio files (using libopus by default)

⁠Setup and usage

⁠Windows

Compatibility: amd64, 386, arm64

Download the pre-built program for your platform from the Github releases⁠.
Run with
```
tinier.exe
```
💁 If your CPU is 386 or arm64, you need to install ffmpeg⁠ manually.

⁠Mac OSX

Compatibility: amd64, arm64

Install ffmpeg⁠, usually brew install ffmpeg does it.
Download the pre-built program for your platform from the Github releases⁠.
Run with
```
chmod +x tinier
./tinier
```

⁠Linux

Compatibility: amd64, 386, armv5, armv6, armv7 and arm64

Download the pre-built program for your platform from the Github releases⁠.
Run with
```
chmod +x tinier
./tinier
```

⁠From source

Install go⁠

Install tinier from source:

go install github.com/qdm12/tinier/cmd/tinier

💁 Depending on your platform, you might have to install ffmpeg⁠ manually.

⁠Docker

Compatibility: x86_64, x86, aarch64, armhf, armv7, ppc64le and s390x

docker run -it --rm -v /your/path:/tmp/tinier qmcgaw/tinier -input-dir-path /tmp/tinier/input -output-dir-path /tmp/tinier/output

You can also use the following environment variables if you prefer:

Environment variable	Default value
`TINIER_INPUT_DIR_PATH`	`/input`
`TINIER_OUTPUT_DIR_PATH`	`/output`
`TINIER_FFMPEG_PATH`
`TINIER_FFMPEG_MIN_VERSION`	`5.0.1`
`TINIER_OVERRIDE_OUTPUT`	`off`
`TINIER_VIDEO_SCALE`	`1280:-1`
`TINIER_VIDEO_PRESET`	`8`
`TINIER_VIDEO_CODEC`	`libsvtav1`
`VIDEO_AUDIO_CODEC`	`libopus`
`TINIER_VIDEO_OUTPUT_EXTENSION`	`.mp4`
`TINIER_VIDEO_EXTENSIONS`	`.mp4,.mov,.avi`
`TINIER_VIDEO_SKIP`	`no`
`TINIER_VIDEO_CRF`	`23`
`TINIER_IMAGE_SCALE`	`5`
`TINIER_IMAGE_OUTPUT_EXTENSION`	`.jpg`
`TINIER_IMAGE_EXTENSIONS`	`.jpg,.jpeg,.png,.avif`
`TINIER_IMAGE_SKIP`	`no`
`TINIER_IMAGE_CODEC`	`mjpeg`
`TINIER_IMAGE_QSCALE`	`5`
`TINIER_IMAGE_CRF`	`35`
`TINIER_AUDIO_CODEC`	`libopus`
`TINIER_AUDIO_OUTPUT_EXTENSION`	`.opus`
`TINIER_AUDIO_EXTENSIONS`	`.mp3,.flac`
`TINIER_AUDIO_SKIP`	`no`
`TINIER_AUDIO_QSCALE`	`5`
`TINIER_AUDIO_BITRATE`	`32k`

⁠General usage

tinier -help
Usage of tinier:
  -audio-bitrate string
        Audio ffmpeg codec bitrate string value. (default "32k")
  -audio-codec string
        Audio ffmpeg codec. (default "libopus")
  -audio-extensions string
        CSV list of audio file extensions. (default ".mp3,.flac")
  -audio-output-extension string
        Audio output file extension to use. (default ".opus")
  -audio-qscale int
        Audio ffmpeg QScale value. (default 5)
  -audio-skip
        Skip audio files.
  -ffmpeg-minversion string
        FFMPEG binary minimum version requirement. (default "5.0.1")
  -ffmpeg-path string
        FFMPEG binary path.
  -image-codec string
        Image ffmpeg codec. (default "mjpeg")
  -image-crf int
        Image ffmpeg crf value, only used by the libaom-av1 codec. (default 35)
  -image-extensions string
        CSV list of image file extensions. (default ".jpg,.jpeg,.png,.avif")
  -image-output-extension string
        Image output file extension to use. (default ".jpg")
  -image-qscale int
        Image ffmpeg qscale:v value, only used by the mjpeg codec. (default 5)
  -image-scale string
        Image ffmpeg scale value. (default "1280:-1")
  -image-skip
        Skip image files.
  -input-dir-path string
        Input directory path. (default "input")
  -output-dir-path string
        Output directory path. (default "output")
  -override
        Override files in the output directory.
  -video-codec string
        Video ffmpeg codec. (default "libsvtav1")
  -video-audio-codec string
        Video audio ffmpeg codec. (default "libopus")
  -video-crf int
        Video ffmpeg CRF value. (default 23)
  -video-extensions string
        CSV list of video file extensions. (default ".mp4,.mov,.avi")
  -video-output-extension string
        Video output file extension to use. (default ".mp4")
  -video-preset string
        Video ffmpeg preset. (default "8")
  -video-scale string
        Video ffmpeg scale value. (default "1280:-1")
  -video-skip
        Skip video files.

⁠Implementation details

⁠Ffmpeg detection

tinier manages its own dependency ffmpeg by:

looking at the user given ffmpeg path
looking at any ffmpeg in the system path
falling back to downloading a static ffmpeg build for your platform

In all cases it skips a certain ffmpeg if it doesn't match the default minimum version 5.0.1, which can be changed with -ffmpeg-minversion.

⁠Safety

tinier can be stopped at anytime and pick up again safely
tinier copies over all files from the input directory to the output directory, even if untouched.
tinier encodes videos to a temporary directory and only moves them to the output directory when completed.
tinier does not delete any file from the input directory

⁠Limitations

EXIF data is not preserved
file creation time (OS dependent) is not preserved

Tag summary

Recent tags

Content type

Image

Digest

sha256:1637f2f3b…

Size

49 MB

Last updated

about 1 year ago

docker pull qmcgaw/tinier