#media #organize #photos #videos

bin+lib media_organizer

Organize media into one folder with a date-centric folder structure

13 releases

0.5.4 Jan 28, 2023
0.5.0 Mar 15, 2022
0.4.1 Jan 11, 2022
0.3.6 Dec 23, 2021
0.1.1 Aug 5, 2021

#618 in Command line utilities

MIT license

342 lines

Media Organizer

Need an organizer for your media content on the computer? Run this!

CLI Usage

    media_organizer [OPTIONS] --target <TARGET_MEDIA> --destination <DESTINATION_PATH>

    -c, --copy                              Copy the files instead of moving them.
    -d, --destination <DESTINATION_PATH>    The destination path of sorted media.
    -f, --file-type <FILE_TYPE>             The file type to sort. [default: *]
    -h, --help                              Print help information
    -t, --target <TARGET_MEDIA>             The target media to sort.
    -V, --version                           Print version information

Example CLI usage

To quickly organize photos in the target folder, run the following command to output them into the default destination directory.

media_organizer --target test-media --destination sorted_media

While developing with cargo, forward the flags.

cargo run -- --target test-media --destination sorted_media


  • Organize photos and videos in a folder structure based off creation dates.

    • Organize a single media file, or a folder containing unorganized media files.

    • Photos organized based off of EXIF creation dates.

      • Whitelisted photo file types. ("jpeg", "jpg", "JPEG", "JPG", "HEIC", "heic", "PNG", "png")
    • Video organized based off of FFMPEG creation dates.

      • Whitelisted video file types. ("mp4", "MP4", "mov", "MOV")
    • User provides target folder of unorganized images. Will move photos to a default photos directory in the directory where the binary was ran. The outputed folders will be the respective creation dates on the media.

  • Allow configurable destination folder.

    • Use the --dest flag.
  • Organize specific file types. Default to any filetype.

  • Option to copy files or move files.

  • Exposed creation date reading functions.


For ffmpeg-next package, follow this guide

Future development

  • Export web assembly binary to use in JS/Node/Electron.

    • Watch out for DEST_FOLDER environment variable.
    • OR! Just use Tauri!?
  • Contribute to Kamadak-exif

  • Organize audio files?

  • Option to index photos.

  • Option to compress image sizes.


~95K SLoC