What is it?

Cleaner is a utility for organizing your downloads, desktop, or any other directory with messy files in it.

How do I use it?

Cleaner is a console utility. You can just type:

user@machine$ clean

to organize files in the current directory.

Is it configurable?

You bet! Just put a ".clean.yml" file in your home directory to specify where all the files go.

Turn this...

.
|-- 13-inch-macbook-manual.pdf
|-- 2_large_glossy_books.png
|-- 2r3v7lu.jpg
|-- CouchDBX.zip
|-- DepthCharge.zip
|-- Dropbox 0.6.402.dmg
|-- EfFLvTB7Qgc0evz6RfmX4nIso1_400.gif
|-- Faeries-Aire-and-Death-Waltz.GIF
|-- Goban_3_2_12.dmg
|-- MeggyJrLibrary1.25.zip
|-- Passage_v3_MacOSX.dmg
|-- Pixen 3.1b.zip
|-- ProgrammingMeggyJr.pdf
|-- REST-cheatsheet.pdf
|-- Snowflake_mac.zip
|-- Widget_Creation_Tutorial_1.1.pdf
|-- contactmanager.dmg
|-- fortunecookie.png
|-- git-cheat-sheet-medium.png
|-- gosu-mac-0.7.12.tar.gz
|-- jesus_supper_zombie.jpg
|-- litebrite.zip
`-- plasma.zip

Into this!

.
|-- archives
|   |-- CouchDBX.zip
|   |-- DepthCharge.zip
|   |-- MeggyJrLibrary1.25.zip
|   |-- Pixen 3.1b.zip
|   |-- Snowflake_mac.zip
|   |-- gosu-mac-0.7.12.tar.gz
|   |-- litebrite.zip
|   `-- plasma.zip
|-- documents
|   |-- 13-inch-macbook-manual.pdf
|   |-- ProgrammingMeggyJr.pdf
|   |-- REST-cheatsheet.pdf
|   `-- Widget_Creation_Tutorial_1.1.pdf
|-- images
|   |-- 2_large_glossy_books.png
|   |-- 2r3v7lu.jpg
|   |-- EfFLvTB7Qgc0evz6RfmX4nIso1_400.gif
|   |-- Faeries-Aire-and-Death-Waltz.GIF
|   |-- fortunecookie.png
|   |-- git-cheat-sheet-medium.png
|   `-- jesus_supper_zombie.jpg
`-- programs
    |-- Dropbox 0.6.402.dmg
    |-- Goban_3_2_12.dmg
    |-- Passage_v3_MacOSX.dmg
    `-- contactmanager.dmg

I'm sold! Where do I get it?

You can have a tarball, get it through Rubygems, or check out the source:

Download tarball:

Click here to download the latest stable build, then run:

tar -xzvf clean-version.tar.gz

sudo gem install clean-version.gem

Install through Rubygems:

Coming soon

Check out the source:

To get the absolute latest version, check out the source with Git. Ensure you have Git installed, then run:

git clone http://git.yellownote.info/clean/.git

Once you have a clone of the repository, do this to build the gem and install it:

gem build clean.gemspec

sudo gem install clean-version.gem