Download the PHP package aensley/media-organizer without Composer
On this page you can find all versions of the php package aensley/media-organizer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package media-organizer
aensley/media-organizer
Organize image, video, and audio files (or any files) into date-based folders.
What it does
TL;DR: This library moves files from one place to another.
media-organizer helps organize files into date-based folders. The date is retrieved from each file in a number of configurable ways. The structure of the date-based folders can be designed any way you want.
Although primarily written to organize JPG images, this library will work for files of any type.
Date Retrieval Methods
Enabled date-retrieval methods run in the following order. When the file date is found by one method, the remaining methods are skipped for that file.
| Method | Description | Supported File Types |
|---|---|---|
| EXIF | Retrieve the date from the file's EXIF data. | jpeg, jpg, heic, heif, webp, tiff, dng, raw, avif, png |
| XMP | Retrieve the date from the file's XMP data. | jpeg, jpg, png, gif, svg, heic, heif, webp, tiff, dng, raw, pdf, ai, eps, avif, psd, psb, mp4, mov |
| ID3 | Use getid3 for advanced file metadata retrieval methods. |
mp4, m4a, mov, mkv, webm, mp3, riff, avi, vorbis, flac, ogg, oga, mka |
| File Name Masks | Match date/time patterns in the name of the file. | all files |
| Modified Time | Use the file's "last modified" time. This property is set by the operating system and is not as reliable as the other methods. |
all files |
Installation
Install the latest version
Configuration
Profiles
Profiles are defined in associative arrays.
You can specify any number of profiles. each is processed in order with its own options.
Profile Options
| Option | Description | Default |
|---|---|---|
| source_directory | REQUIRED: Directory to search for files. Ending slash required. |
"" |
| search_recursive | Set to true to look in all subdirectories of source_directory for files. | false |
| valid_extensions | Array of file extensions to search for. Set to an empty array ( []) to include all files. |
['jpg', 'jpeg'] |
| target_directory | REQUIRED: Destination directory for organized files. Ending slash required. |
"" |
| target_mask | Directory structure to use for target. Y = 4-digit year, y = 2-digit year, m = 2-digit month, d = 2-digit day. Anything supported by date() will work, except time-based options as they will not be consistent. |
"Y/Y-m-d" |
| overwrite | Whether to overwrite destination files. true = overwrite same files that already exist in target. false = add incrementing counter to identical file names to avoid collisions. |
false |
| scan_exif | Date Retrieval Method: Scan EXIF data for file date. Supports image files (JPG, TIFF, HEIC, WEBP, etc.). |
true |
| scan_xmp | Date Retrieval Method: Scan XMP data for file date. Supports mostly image files (JPG, PNG, GIF, SVG, etc.) and some video files (MP4, MOV, etc.). |
false |
| scan_id3 | Date Retrieval Method: Scan metadata via getid3 for file date. Supports video files (MP4, MOV, MKV, AVI, etc.) and audio files (MP3, FLAC, OGG, etc.). |
false |
| file_name_masks | Date Retrieval Method: Patterns to search for in file names for date. Set to false to disable filename logic.Y = year digit, M = month digit, D = day digit. All are replaced with digits for regex search. |
['YYYY-MM-DD', 'YYYYMMDD'] |
| modified_time | Date Retrieval Method: Whether or not to use the file's modified time. | false |
GetID3
[!IMPORTANT]
Installing james-heinrich/getid3 is strongly recommended to enable advanced metadata processing for video and audio files.
This library is excluded by default due to its substantial size, providing the option to omit it if it does not apply to your use case.
Enable advanced video and audio file processing with 'scan_id3' => true in your profile after installing the dependency.
With this library installed, the following additional date-retrieval methods are enabled via scan_id3.
| File Format | Metadata |
|---|---|
| MP4 / MOV | quicktime.timestamps_unix.create['moov.mvhd'] |
| MKV / WebM | matroska.info[n].DateUTC_unix |
| ID3v2 (MP3) | comments.recording_time or comments.date |
| RIFF/AVI | comments.creationdate or comments.digitizationdate |
| Vorbis/FLAC/OGG | comments.date |
| ID3v1 year-only | comments.year (returns YYYY-01-01) |
Logger
You can specify a logger object implementing the PRS-3 Logger Interface for handling of log messages.
[!TIP]
monolog is recommended for comprehensive logging options.
monolog-colored-line-formatter can be added for colored output in bash.
If no logger is provided, the package will simply echo all log messages directly.
Requirements
- PHP >= 7.1
