Sorter makes file organisation and management easier.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
assets Add Loader Jun 20, 2017
data Perform cleanup on report close Jul 27, 2017
screenshots Prep for release: v2.0.0 May 23, 2017
slib Bulk create Path objects Jul 24, 2017
.gitignore Revamp sdir Jun 24, 2017
.travis.yml Fix link Jun 19, 2017
LICENSE Add license Apr 5, 2017 Update release badge Jul 17, 2017
_config.yml Set theme jekyll-theme-midnight May 31, 2017 Create package slib Jun 21, 2017 Add hidden import Jun 22, 2017


Latest Release Issues Travis-CI Codacy Badge

Sorter makes file organisation easier. It simply helps you organise several files that contain similar characteristics into a single folder. You can put all letters documents into one folder, all images with the word home into another, all music by one artist in yet another folder, etc.

Sorter organises these files into folders which are grouped according to one or more of the following patterns:

  • A common name in multiple files' names. For example, multiple files may have a common word(s) season one. Every file bearing these word(s) will be moved to (by default) a folder named season one.
  • A custom name (of your choosing). For example, after searching using the above criteria, you might choose the destination folder to be named My Series.
  • By file type/format. For instance, pdf files will be put in a folder named PDF, docx files in a DOCX folder, jpeg files in a JPEG folder, etc.
  • By categories of the file formats. For instance, pdf, docx and txt files are all documents, hence will be put in a folder named document. These categories are defined in filegroups

Sorter majorly focuses on file management but most of these operations should generally apply to folders too.

Note: If you want a folder and its contents to be left as is (i.e. not to be sorted or affected in any way), just add a file named .signore (no extension) into the folder.


Visit Sorter for features, download and usage tutorials.

Recommended: See the full list of supported OSes at Sorter - Official Releases



NB: View requirements.txt for detailed requirements

Open terminal


git clone`

cd sorter


Compile executable DIY

Install Prerequisites

How to compile

  • Create and activate a Virtual Environment (optional but recommended)
  • Ensure prerequisites are available
  • Clone this repository
  • In terminal/cmd, run the command in
  • Check into the dist/ and copy the sorter folder to any location for use.



Thank you for your interest in contributing to the Sorter project. To get you started, have a look at the contribution guidelines



  • This project is licensed under the BSD 3-clause "New" or "Revised" License - see the LICENSE file for details


Suggest new Feature

  • Add search for files in history


The coverage results exclude the GUI code. I will not write test for the GUI classes as most of the operations are separate.