Sorter
Sorter makes file organisation easier. It simply helps you organise several files that contain similar characteristics into a single folder. You can put all letter 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 namedseason 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.
Download
Visit Sorter for features, download and usage tutorials.
Recommended: See the full list of supported OSes at Sorter - Official Releases
Clone
Prerequisites
- Python 3.4
- sqlite3
- TestFixtures (for tests)
NB: View the requirements for detailed requirements
Open terminal
Do
git clone https://github.com/giantas/sorter.git`
cd sorter
python sorter.py
Compile executable DIY
Install Prerequisites
- Python 3.4
- Pyinstaller (tested with v3.2.1)
- sqlite3
- Django v1.8.x
NB: View the requirements for detailed requirements
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 pybuild.sh
- Check into the
dist/and copy thesorterfolder to any location for use.
In terminal:
pip install --user pipenv
git clone https://github.com/giantas/sorter.git
cd sorter
pipenv sync
bash pybuild.sh
mkdir ~/apps/
cp -R dist/sorter ~/apps
cd ~/apps/sorter
./sorter
Website
Contributing
Thank you for your interest in contributing to the Sorter project. To get you started, have a look at the contribution guidelines
Authors
License
- This project is licensed under the BSD 3-clause "New" or "Revised" License - see the LICENSE file for details
TODO
- Add support for customised file grouping
Warning
The coverage results exclude the GUI code. I will not write test for the GUI classes as most of the operations are separate.
2 Dec 15, 2021
1 Jan 18, 2022
8 Mar 6, 2022
1 Jan 13, 2022
2 Dec 2, 2022
3 Feb 2, 2022
0 Feb 23, 2022
1 Jan 22, 2022
2 Jul 16, 2022
1 Aug 09, 2022
1 Jan 04, 2022
22 Nov 15, 2022
8 Jun 17, 2022
1 Dec 30, 2021
14 Sep 11, 2022
1.3k Jan 07, 2023
3 Apr 04, 2022
0 Nov 27, 2021
1 Jan 10, 2022
1 Nov 22, 2022
90 Jan 01, 2023
10 Sep 28, 2021
3.8k Dec 31, 2022
1.7k Jan 07, 2023
31 Nov 10, 2022
16 Jul 11, 2022
180 Oct 08, 2022
4 Dec 05, 2021
1 Jan 10, 2022