skip to navigation
skip to content

phosort 1.0.8

Typo fix. Improved usage documentation.

Copyright 2010 Anthony Campbell (

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Simple script to sort a directory of photos and videos. Designed to break down a directory into yearly creation date sub directories. Also rename files to provide a more consistent and readable listing.

Please look at the CHANGES file in each project to see what has changed since the last tag.


  • hachoir-core-1.3.3
  • hachoir-parser-1.3.4
  • hachoir-metadata-1.3.3

These packages are available from the ./dependencies directory. Simply unzip and run the “python install” command as root on all three libraries.

PIP install:

pip install phosort

Manual install:

Download the provided source and execute it using the following command:

python install


python [directory] [option]


If you wish to contribute to the project you can find the latest source code on GitHub:

Further information:

phosort is now also available on PyPi Package Index (PyPI) (aka, the “Cheeseshop”):

Special thanks:

To Alex Elder ( for his numerous fixes and improvements. Cheers dude!

Version 1.0.8

Release notes 1.0.8 (30th August, 2010)

  • Updated usage notes.
  • Add keywords to
  • Output typo fix.

Release notes 1.0.7 (28th August, 2010)

  • Added graceful handling of private (‘-r’) folders on Linux.

  • Added a clarity comment for case-insensitive filetype regex.

  • Shortened the date matching regex to include fewer greedy quantifiers while

    still matching the same date format.

  • Fixed a small bug in the regexes used to identify allowed file types.

  • Fixed recursive bug where previous sorted media is re-sorted.

Release notes 1.0.6 (27th August, 2010)

  • Keyboard interrupt handling.
  • Test script updates.
  • Improved output.

Release notes 1.0.5 (27th August, 2010)

  • Updated to change log text to support reStructured text.
  • Uploaded release notes to reflect phosort PyPi upload location.

Release notes 1.0.4 (27th August, 2010)

  • Egg descriptor file fix.
  • Upload to the cheese shop.

Release notes 1.0.3 (25th August, 2010)

  • Egg descriptor file introduction.

Release notes 1.0.2 (25th August, 2010)

  • Removal of EXIF package dependency
  • Introduction to the hachoir metadata library.
  • Provision of hachoir libraries.
  • Retrieve real creation date for videos and images from meta data.
  • Small bug fixes due to refactoring.

Release notes 1.0.1 (24th August, 2010)

  • Small improvements.
  • Introduction into copy only mode.

Release notes 1.0.0 (24th August, 2010)

  • Match correct files within current directory.
  • Initial sort implementation.
  • Introduction to simulate only mode.
  • Introduction to image only mode.
  • Introduction to replace spaces for file and directory.
  • Introduction to timestamp file mode.
  • Final release.

Release notes 0.0.1 (23rd August, 2010)

  • Initial release.
File Type Py Version Uploaded on Size
phosort-1.0.8.linux-i686.tar.gz (md5)
built for Linux-2.6.32-24-generic-i686-with-glibc2.4
"dumb" binary any 2010-08-30 2KB
phosort-1.0.8.tar.gz (md5) Source 2010-08-30 3KB