auto-file-sorter

auto-file-sorter is a Python automation tool that tracks a directory and sorts files into their respective folders based on their file extensions.

Installation

Make sure you have Python 3.9 or later installed. You can install the package using pip:

pip install auto-file-sorter

Alternatively, you can install the package from GitHub to get the latest changes:

pip install git+https://github.com/realshouzy/auto-file-sorter.git

The project uses the following packages and libraries:

# standard library
import argparse
import concurrent.futures
import datetime
import json
import logging
import os.path
import pathlib
import platform
import re
import shutil
import sys
import time
import typing

# third party
import typing_extensions
# import watchdog
import watchdog.events
import watchdog.observers

# only for type annotations; not used at runtime
import collections.abc
import watchdog.observers.api

# for testing
import pytest

Documentation

Consult auto-file-sorter --help / auto-file-sorter -h for the full set of options. This also applies to all subcommands:

• auto-file-sorter track
• auto-file-sorter read
• auto-file-sorter write
• auto-file-sorter locations

Arguments and flags of auto-file-sorter

Arguments and flags of auto-file-sorter track

Arguments of auto-file-sorter read

Arguments of auto-file-sorter write

The json files should be structured similarly to the configs.json file. An example (with Windows paths) can be found in example_configs.json. Ultimately you can directly modify the configs.json file yourself.

Flags of auto-file-sorter locations

Run on startup

Windows setup

To run the tool on startup, add the --autostart flag after the track subcommand. This will add the command to the Startup folder as a .vbs file, ensuring it runs in the background.

To avoid the overhead of creating a StreamHandler and prevent overwriting the .vbs file on every startup, it removes all occurrences of --verbose / -v as well as --autostart.

An example of this transformation:

- auto-file-sorter -d -vvv track C:\path\to\be\tracked
+ C:\path\to\auto-file-sorter.exe -d track C:\path\to\be\tracked

This will then be run by the .vbs file on startup:

Set objShell = WScript.CreateObject("WScript.Shell")
objShell.Run "C:\path\to\auto-file-sorter.exe -d track C:\path\to\be\tracked", 0, True

macOS setup

Add the desired command to the Automator app. You can find a tutorial here.

Linux setup

Due to the wide variety of Linux distributions and their differences, it is up to the user to configure auto-file-sorter to run on startup.

Usage

Simply place files into the tracked folder, and the tool will automatically sort them for you.

Excpetion handling

Most exceptions will be logged in a log file. If an exception should occur, the program will handle it gracefuly by exiting with exit code 1, except in cases where an exception is encountered while moving a file. This behavior is specifically implemented to address threading concerns and ensure proper garbage collection. In such cases, the respective thread will exit, while the main program continues its execution. Ultimately, the user has the option to stop the program manually. This approach allows for proper cleanup and termination of resources.

Contributing

If you are interested in contributing to this project, please refer here for more information.

License

auto-file-sorter is available under the MIT license

Credit

This project was originally inspired by Kalle Hallden's desktop_cleaner project.