0.0
The project is in a healthy, maintained state
Organize files into their own separate folders
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

~> 1.68
>= 0

Runtime

~> 2.4
 Project Readme

OrganizeFiles

Decluttering your file system doesn’t have to be a hassle anymore. Moving files into their appropriate folders can be tedious and time-consuming—especially when done manually.

The Organize Files gem for Ruby streamlines this process by automatically organizing files based on their extensions. Simply point it to a directory, and it will sort the files into their respective folders. If a folder for a specific file extension doesn't already exist, it will be created for you.

Getting started

Install the gem

gem install organize_files

Usage

Enter the directory you want to sort the files in.

organize_files [options] <directory>
  • The directory you want to organize

Example:

organize_files '/path/to/downloads'

Output:

Successfully moved index2.pdf to /path/to/downloads/Documents/index2.pdf

Options:

  • -c, --config, CONFIG_FILE: Specify the configuration file to use.

  • If not provided, the script will look for ~/.organize_config.yml in your home directory.

  • If ~/.organize_config.yml is not found, it will use the built-in default configuration.

  • -h, --help, Prints this help message.

Configuration

You can customize how files are categorized by creating a YAML configuration file.

Default Configuration File:

The script will automatically look for a configuration file named ~/.organize_config.yml in your home directory.

Example ~/.organize_config.yml:

images:
  - .jpg
  - .jpeg
  - .png
documents:
  - .pdf
  - .docx
  - .txt
audio:
  - .mp3
  - .wav
videos:
  - .mp4
  - .mov
archives:
  - .zip
  - .rar
programming:
  - .rb
  - .py
  - .js

Requirements

This gem requires Ruby 3.0+.

Contributing

Please see CONTRIBUTING.md