Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Typo fix. Improved usage documentation.

Project Description

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.
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
phosort-1.0.8.linux-i686.tar.gz (2.5 kB) Copy SHA256 Checksum SHA256 any Dumb Binary Aug 30, 2010
phosort-1.0.8.tar.gz (3.3 kB) Copy SHA256 Checksum SHA256 Source Aug 30, 2010

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting