command-line-file-manager 1.1.7

CLI tool for managing local file system storage

---

command-line-file-manager

Python CLI tool for scanning and organizing local directories and files.

Requires Python 3.10+

Installation

Via pip:

$ pip install command-line-file-manager

From main branch:

$ git clone https://github.com/kaliv0/command-line-file-manager.git
$ cd command-line-file-manager 
$ pip install .

Example

To run the application type fm followed by a sub-command, target directory and options

$ fm scan-files ../test --sort=type --save --output=./

Add --help after the fm command or any of the subcommands to get more information

$ fm scan-files --help

Usage: fm scan-files [OPTIONS] DIR_PATH

  DIR_PATH: Path to directory to be scanned

Options:
  --sort [name|size|date|modified|type]   Sorting criteria.  [default: name]
  --desc                                  Display result in descending order.
  -s, --save                              Save log message to file.
  -o, --output TEXT                       Path to output directory for the saved log file.
  --help                                  Show this message and exit.

Main Features

• scan_files - list all files inside PATH
• scan_subdirs - list all nested directories
• build_catalog - list all contents (files, subdirs)
  (can be done recursively via build_catalog_recursively)
• build_tree - visualize directory structure
• build_pretty_tree - a fancy alternative with emojis etc.

---

• search_by_name
• search_by_name_recursively

---

• organize_files - group files by extension into corresponding 'type' directories (e.g. music, books)
  (provides recursive version)

• handle_duplicate_files - merge identical files (in terms of content) - prompts user for file name or uses first entry in duplicates list
  (has a recursive alternative)