nsrosenqvist / mediadater Goto Github PK

Mediadater is a small BASH CLI utility used to rename media files created by recording devices. By default it renames the files to the date the file was created and the camera model. It's behaviour is very flexible and it can work with all picture, audio and video files that Exiftool supports.

License: GNU General Public License v3.0

Shell 92.04% Makefile 7.96%

mediadater's Introduction

Mediadater

Mediadater is a small BASH CLI utility for Linux, used to rename media files created by recording devices. By default it renames the files to the date the file was created, plus the camera model. It's behaviour is very flexible and it can work with all picture, audio and video files that Exiftool supports. It's licensed with the GNU GPLv3 License.

Installation

The easiest way to install is to clone the repository and then install with make:

git clone https://github.com/nsrosenqvist/mediadater.git && cd mediadater
make && sudo make install

The script requires exiftool which is in the Ubuntu repositories:

sudo apt-get install libimage-exiftool-perl

Usage

The argument you provide can either be a file or multiple files as separate arguments (and even a pattern through shell expansion). By default the file is named after the created date followed by the camera model if the tag is available (e.g. 20140101_122301_Nikon D60.jpg).

Example usage:

mediadater -vx -s "My friends camera" DSC_*.JPG

You can specify the files to rename in several different ways. You can specify them, pipe the input, use file input, or even run with nothing specified at all and the script will use find to locate every supported file in the current working directory, but first prompt you and ask if that is really what you want to do.

Note: Due to the nature of the getopts argument parsing you cannot specify the files before the parameters so make sure to set them in the right order. A warning might be implemented later, patches are welcome.

Parameters

Parameter	Explanation
-d	Set a date format for the file names using the `strftime` syntax.
-v	Print the changes being made.
-p	Prefix the file name (before the date).
-s	Suffix, by default it tries to use the camera model but it can be helpful to use a custom suffix, for example if you want to name files from different occasions, like "Vacation" and "Wedding".
-x	If a related Darktable XMP-file is found this will also edit it so that it's still connected to the new file name.
-l	Log the file changes to "mediadater_log.txt" which will be created in the current working directory. Good if you want to make sure that everything went alright.

mediadater's People

Contributors

Watchers

mediadater's Issues

Getopts argument parsing acts weirdly

Add "long" arguments and make sure that the order no longer matters

Support recursive search

Verify if the file renaming works as it is currently and also add a recursive option that is enabled when using find.

Option to organize files into folders according to date

Remember to also create a folder for files with unknown dates

Consider showing remaining files to process

This would probably be possible on all input methods except directory mode.

Support flags to be specified after arguments

Research how the option parsing can be improved

Add option -l to save all output to a log file

This would be helpful both when developing and just to make sure that everything went ok.

Pad log message string instead of using tabs

Use the max number of files being processed to calculate string width

When extra functionality has been implemented, consider renaming project to MediaCleaner

Relicense under MIT

Create an non-interactive and interactive switch

This could allow the user to manually enter the exifdata if it's missing from a file and at the same time write it into the file metadata.

Implement the possibility to do a dry run without committing changes

In that case show a disclaimer about files taken at the same second, eg. _1, _2, etc.

Use Date/Time Original instead of Create Date

Date/Time Original              : 2013:06:23 20:41:52
Create Date                     : 2002:12:08 12:00:00

Date/Time Original is the correct one according to the exif-specification. Create Date can be used as a backup if it's not defined.

Add copy option instead of renaming files

Add an option to simultaneously create a script that reverts the changes

Simply append every change to a file: mv "123128.jpg" "20121112_121212_Nikon D90.jpg"

Improperly declared variables, could cause issues with scope

Fixing this asap

Create a GUI

First rewrite the cli app and then create the GUI.

Handle files without exifdata better

Currently if we can't find the timestamp or camera model we name files like ".jpg" and "_01.jpg". To improve this we should check that we actually find the exifdata and in that case provide an option to skip files without proper metadata or prefix them with "unknown".

Offer to also clean up suspected duplicates

Since we find have to account for files with the same resulting name, ask if we should search for and clean up duplicates as well if we suspect there are duplicates

Test for dependencies

Might be helpful...