#mirror #convert #sync

app mirrorman

Media conversion and mirror tool

8 releases

new 0.2.6 Apr 23, 2024
0.2.5 Apr 18, 2024
0.1.0 Apr 12, 2024

#15 in Multimedia

Download history 329/week @ 2024-04-08 262/week @ 2024-04-15 144/week @ 2024-04-22

735 downloads per month

Custom license

19KB
425 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)
  • 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–16MB
~202K SLoC