An interactive CLI tool to organize messy directories by categorizing files into appropriate folders.
- Scans directories for files and categorizes them by extension
- Moves files to appropriate category folders (Videos, Images, Documents, etc.)
- Detects and handles duplicate files
- Interactive CLI with rich colorful interface
- User confirmation for all operations
Currently, nex is available for installation directly from GitHub:
# Install directly from GitHub
pip install git+https://github.com/S5SAJID/nex.gitAfter installation, you can run the tool with:
nexnex will be available on PyPI in the future. Once published, you'll be able to install it with:
pip install nex # Not available yetRun the tool:
nex- Select a directory to organize
- Review and confirm file categorization
- Identify and handle duplicate files
- Complete the organization process
Files are organized into the following categories based on their extensions:
- Audio (mp3, wav, flac, etc.)
- Videos (mp4, avi, mkv, etc.)
- Images (jpg, png, gif, etc.)
- Documents (pdf, doc, txt, etc.)
- Archives (zip, rar, 7z, etc.)
- Programming (py, js, html, etc.)
- Misc (all other files)
nex automatically detects when it's running in a project directory (containing files like requirements.txt, package.json, or directories like src, .git, etc.) and takes special care:
- Critical project files like
main.py,README.md, and configuration files won't be moved - A warning will be shown before organizing project directories
- You'll get a chance to review excluded files before proceeding
nex --dir /path/to/directory # Specify directory to organize
nex --exclude "*.py" # Exclude Python files
nex --exclude "data/*" # Exclude files in data directory
nex --no-project-detection # Disable project detection
While nex tries to be smart about detecting project structures, it's not perfect. Always review the proposed changes before confirming, especially in development directories.
MIT
For detailed documentation, see the docs directory: