Skip to main content

CLI tools to organize files on your computer

Project description


mmf is a cli tool for organising files on your computer. Tell it the file name patterns, where to move and matching files from a source directory are moved to target directory. Run it as one-off command or in watch mode to continously observe a source directory.



  • Python >=3.5
  • pip package manager

Install mmf using:

# Install or upgrade mmf
pip install move-my-files -U


Move files using either one time command or watch mode:

# Supply source and destination directory explicitly
mmf move --source ~/Documents --dest-dir ~/Documents/images --pattern .png

# Uses predefined configuration(provided in using add command)
mmf move --source ~/Documents

# Watch ~/Documents directory for moving files
mmf move --source ~/Documents --dest-dir ~/Documents/images --pattern .png --watch
mmf move --source ~/Documents --watch

Define your favorite configurations using add command. This command keeps track of your configurations so they are not required to be typed in future. Use list command to list configurations you've previosly added.

# Add configuration
mmf add --dest-dir ~/Documents/images --pattern .png
mmf add --dest-dir ~/Documents/pyfiles --pattern .py

# List configurations (previously added)
mmf list

# move without --dest-dir will use configurations
mmf move --source ~/Documents --watch

Available shortcuts for options:

  • --source: -s
  • --dest-dir: -d
  • --pattern: -p
  • --watch: -w


Fork and clone this repository to develop on latest master branch. General steps to execute python code form this repo:

# Create development environment
cd /move-my-files
virtualenv .env && source .env/bin/activate
python3 install

# Execute CLI (from code)
python3 .
python3 . list

Local testing with unit tests and CLI:

# Run available unit tests
python3 -m pytest tests -v

# Install CLI locally to test (basically testing
pip install -e .

For Packaging and publishing see here:


If you have ideas to improve this tool, feel free to raise a new issue in the Issues section or open a PR :)

Project details

Download files

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

Source Distribution

move-my-files-0.2.4.tar.gz (6.3 kB view hashes)

Uploaded source

Built Distribution

move_my_files-0.2.4-py3-none-any.whl (6.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page