FOLDR V2

FOLDR v0.2.1

This release marks a major expansion of FOLDR from a simple root-folder organizer into a full-featured, cross-platform file management tool.

v0.2.1 introduces recursive organization, depth control, ignore rules, deduplication, watch mode, undo/history, custom configuration, and improved safety controls for preview-first workflows. FOLDR now handles real-world folder cleanup with greater flexibility, reliability, and control across Windows, macOS, and Linux.

Highlights

• Recursive organization with depth limits
• Ignore rules, show-ignored, and no-ignore support
• Deduplication with selectable strategies
• Watch mode for continuous auto-organization
• Undo and history for reversible operations
• Custom category configuration
• Verbose and quiet modes for different workflows

This is a substantial upgrade for users who need fast, safe, and practical folder organization.

What's Changed

• V2 by @qasimio in #3
• HISTORY | UNDO | TUI | RECURSIVE by @qasimio in #4
• Foldr v2 is battletested and working on windows with all its features by @qasimio in #11
• Removed --startup and added Documentation and code of conduct docs by @qasimio in #12
• Foldr v0.2.1 - Let's Deploy by @qasimio in #13

New Contributors

• @qasimio made their first contribution in #3

Full Changelog: v0.2.0...v0.2.1

FOLDR v0.1.7

FOLDR v0.1.7

Fixes

• Improved file categorization stability
• Sorting behavior fully verified across expanded file types
• Better handling of filenames containing quotes, spaces, and special characters

What’s New

• Massive expansion of supported file categories
• Added intelligent classification for:
  • Documents, Text & Data, and Spreadsheets
  • Images, Vector Graphics, Audio, Videos, and Subtitles
  • Archives, Disk Images, and Virtualization files
  • Source Code, Scripts, Notebooks, and Web assets
  • Machine Learning models and datasets
  • Databases and configuration/system files
  • Fonts, CAD, GIS, and 3D model formats
  • Certificates, Logs, Licenses, and project metadata
• Improved separation between executable files and package formats
• Better organization for development-heavy directories
• Expanded handling of temporary and miscellaneous system files

Example

foldr "D:\Devshelf videos" --dry-run

Installation or Upgrade

pip install foldr

Upgrade existing installation:

pip install --upgrade foldr

Usage

Organize a directory:

foldr <directory>

Preview changes safely:

foldr <directory> --dry-run

Notes

• Recursive directory processing is still intentionally excluded
• Designed to remain safe by default
• Categorization system is now extensible for future configuration support
• Future releases may introduce optional recursion and user-defined rules

PyPI: https://pypi.org/project/foldr/
Source: https://github.com/qasimio/Foldr

FOLDR v0.1.6

FOLDR v0.1.6

Fixes

• Improved file categorization stability
• Sorting behavior fully verified across expanded file types
• Better handling of filenames containing quotes, spaces, and special characters

What’s New

• Massive expansion of supported file categories
• Added intelligent classification for:
  • Documents, Text & Data, and Spreadsheets
  • Images, Vector Graphics, Audio, Videos, and Subtitles
  • Archives, Disk Images, and Virtualization files
  • Source Code, Scripts, Notebooks, and Web assets
  • Machine Learning models and datasets
  • Databases and configuration/system files
  • Fonts, CAD, GIS, and 3D model formats
  • Certificates, Logs, Licenses, and project metadata
• Improved separation between executable files and package formats
• Better organization for development-heavy directories
• Expanded handling of temporary and miscellaneous system files

Example

foldr "D:\Devshelf videos" --dry-run

Installation or Upgrade

pip install foldr

Upgrade existing installation:

pip install --upgrade foldr

Usage

Organize a directory:

foldr <directory>

Preview changes safely:

foldr <directory> --dry-run

Notes

• Recursive directory processing is still intentionally excluded
• Designed to remain safe by default
• Categorization system is now extensible for future configuration support
• Future releases may introduce optional recursion and user-defined rules

PyPI: https://pypi.org/project/foldr/
Source: https://github.com/qasimio/Foldr