neatify 1.0.0

A CLI tool to organize files by their extensions

Neatify

A simple CLI tool to organize files in a folder by their extensions.

Features

• Automatically organize files into folders by type (images, documents, videos, etc.)
• Manage custom extension mappings
• Add, remove, and list file extension categories
• Restore default extension mappings

Installation

From Source

# Clone the repository
git clone https://github.com/anmoljhamb/neatify.git
cd neatify

# Install in development mode
pip install -e .

Using pip

pip install neatify

Usage

Organize a Folder

neatify organise /path/to/folder

This will organize all files in the specified folder into subfolders based on their file types.

List Extensions

View all configured file extension categories:

neatify list

Add an Extension

Add a new extension to a category:

neatify add Image .webp

Remove an Extension

Remove an extension from a category:

neatify remove Image .webp

Remove a Category

Remove an entire category:

neatify rmcat oldcategory

Clear All Extensions

Clear all extension mappings:

neatify clear

Restore Defaults

Restore the default extension mappings:

neatify default

Custom Extensions File

Use a custom extensions JSON file:

neatify --file custom_extensions.json organise /path/to/folder

Examples

# Organize your Downloads folder
neatify organise ~/Downloads

# Add .svg to the image category
neatify add Image .svg

# View all extensions
neatify list

# Remove a category you don't need
neatify rmcat Audio