Skip to main content

Arrange your files in distinct folder

Project description

ArrangePy

Organizes files in folders and helps you to clean your PC

  • Join our Telegram group via the link given below
  • Read about it on my blog

What it does

Organizes the files based on their extensions in folders.

If you run the script in a directory containing hundreds of files of multiple filetypes, the script will arrange all of them in different directories based on the file type. For example, all PDFs are arranged in a directory for PDFs, all document based files (docx, doc, xlsx, pptx etc) are moved to the docs directory.

All these files are moved to a directory named CleanedPy in the directory on which the script was executed. So if you ran the script on your Downloads directory, a directory named CleanedPy will be created in Downloads.

You can specify which files to move to which directory using the config.ini file.

Features

Currently it has 2 modes

  • Easy mode: Organzises files in the current directory
  • Hard mode: Organizes files in the current directory and its subdirectories

How to use

  • git clone https://github.com/prashantsengar/ArrangePy.git
  • cd ArrangePy

Using the CLI (command-line interface)

usage: cli.py [-h] [-w | -s | -b] [-nw] [directory]

positional arguments:
  directory          The directory to arrange, default is current working
                     directory

optional arguments:
  -h, --help         show this help message and exit
  -w, --weak         Weak arrange
  -s, --strong       Strong arrange
  -b, --web          Run web GUI
  -nw, --no-warning  Don't show any warnings when running strong arrange

Examples

  • python cli.py (Arranges current directory, asks for type of arrange [WEAK/STRONG] )
  • python cli.py -w (Weak arranges current directory)
  • python cli.py -w PATH/TO/DIRECTORY (Weak arranges given directory)

Directly running the script

  • python main.py

Running the Web GUI

  • python -m webapp # for the web interface
    • requires to install Flask for web interface. use pip install flask for the first time

Editing the CONFIG file

Say the initial configuration is this:

[ext]
PDF=['pdf'],
Images=['png','jpeg','jpg','gif', 'tiff', 'psd', 'ico'],

This will move all PDF files to a directory named PDF and all images of mentioned extensions to a directory named Images.

To add a new file type

(say .eps) to the Images directory, add the new extension to the Images list. So it will change to:

[ext]
PDF=['pdf'],
Images=['png','jpeg','jpg','gif', 'tiff', 'psd', 'ico', 'eps'],

To add a new type of file (new directory)

Say you want to move all the video files along with PDFs and images. You can do that in this way:

[ext]
PDF=['pdf'],
Images=['png','jpeg','jpg','gif', 'tiff', 'psd', 'ico', 'eps'],
Videos=['mp4','mkv','avi','3gp'],

Now it will arrange all mp4, mkv, avi, 3gp files to the Videos directory.

Contributing

You can contribue to this project using multiple ways. Here are a few things that you can work on

  • Improve this README to explain the idea better. GIFs can be added, for example.
  • Adding extensions to the config.ini file will improve the experience for everyone.
  • Improve the code, add new features or fix issues.

Please read the contribution guide

Community

Read the contributing guide

Join the Telegram group for support and contributing. If you want to contribute, joining the group helps us all a lot because you can get instant feedback.

mTracker Telegram Group

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

arrangepy-1.1.1.tar.gz (46.3 kB view hashes)

Uploaded Source

Built Distribution

arrangepy-1.1.1-py3-none-any.whl (87.6 kB view hashes)

Uploaded Python 3

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