11 unstable releases (3 breaking)

0.4.0 Nov 7, 2024
0.3.1 Sep 8, 2024
0.3.0 May 31, 2024
0.2.6 Apr 23, 2024
0.1.0 Apr 12, 2024

#66 in Video

Download history 147/week @ 2024-09-07 25/week @ 2024-09-14 19/week @ 2024-09-21 9/week @ 2024-09-28 99/week @ 2024-11-02 23/week @ 2024-11-09 5/week @ 2024-11-16 2/week @ 2024-11-23

129 downloads per month

Custom license

21KB
467 lines

MirrorMan

MirrorMan aims to provide a seamless solution for mirroring and converting a large hierarchy of files.

You might use this for:

  • Converting your lossless audio library to smaller MP3s to be taken on the go (see example_filter.sh)
  • Upscaling footage from your super-duper old video camera and converting into a reasonable format
  • Turning your SD card full of raw images into the things normal people can view

Usage

To make a new mirror: mirrorman init {source} {mirror_path} [filters...]

To sync existing mirrors, from within a directory with .mmdb files: mirrorman sync

Filters

Filters are the core of the conversion side of things.

They tell mirrorman if a file should be converted and the new file extension after conversion.

(They also perform the actual important conversion part.)

A filter is just an executable program that has two operation modes:

  • {filter} ext {input_extension} -> output_extension: Prints the desired extension, or returns an error code if the filter doesn't care about the input file.
  • {filter} run {input} {ouput}: Converts the input file to the output file.

It's really that simple!

Refer to the example filter for specifics.

Todo

  • Use timestamp comparisons before hash comparisons on database
  • Better way of a filter ignoring a file, error codes should ideally be used for errors not passing info

Dependencies

~6–15MB
~190K SLoC