`arng`

Simple & Capable files arranger (previously arranger)

About

Arng is a CLI file arng written in Perl
It cleans up your Directory by moving files to their corresponding Directory by their file extension
jpg, png, jpeg, webp -> Images
mp4, mkv, avi, flv -> Videos
and other common filetype extensions

Features

Arng can

control maxdepth when arranging
delete empty Directories
save logs of what exactly happened
revert the move using logfile
move only specific files by provided file extensions & Directory
arrange more than one Directory
move unrecognised filetypes to 'Other' Directory
arrange files by patterns

Installation

Its just a perl script download it make it executable and put somewhere in your $PATH

Via install script

bash -c "$(curl https://raw.githubusercontent.com/anhsirk0/file-arranger/master/install.sh)"

Manually

with wget

wget https://raw.githubusercontent.com/anhsirk0/file-arranger/master/arng.pl -O arng

or

with curl

curl https://raw.githubusercontent.com/anhsirk0/file-arranger/master/arng.pl --output arng

making it executable

chmod +x arng

copying it to $PATH (~/.local/bin/ , this step is optional)

cp arng ~/.local/bin/

Usage

arng [dirs] [options]

dry-run

$ arng -dry
files2.mp4 -> Videos/files2.mp4
files2.mp3 -> Music/files2.mp3
files1.mp4 -> Videos/files1.mp4
files2.pl -> Other/files2.pl
files1.mp3 -> Music/files1.mp3
files1.pdf -> Documents/files1.pdf
files1.pl -> Other/files1.pl
files2.pdf -> Documents/files2.pdf
0 Files moved

adding verbose

$ arng -v
files2.mp4 -> Videos/files2.mp4
files2.mp3 -> Music/files2.mp3
files1.mp4 -> Videos/files1.mp4
files2.pl -> Other/files2.pl
files1.mp3 -> Music/files1.mp3
files1.pdf -> Documents/files1.pdf
files1.pl -> Other/files1.pl
files2.pdf -> Documents/files2.pdf
8 Files moved

moving files by extensions to provided dir

$ arng -ext sh zsh fish -dir shell -v
script.sh -> shell/script.sh
script.zsh -> shell/script.zsh
script.fish -> shell/script.fish
3 Files moved

reversing the move via a logfile

logfiles are stored in ~/.config/arng/logs

$ arng -rev "~/.config/arng/logs/logfile1234"
8 files moved

not saving logs and not moving unrecognised filetypes to 'Other'

$ arng -nl -nu
8 files moved

$ arng --no-log --no-unknown
8 files moved

deleting empty directories

$ arng --delete-empty --no-arrange
2 Directory deleted
0 files moved

$ arng -de -na
2 Directory deleted
0 files moved

name/iname

$ arng -iname "episode*" -dir "Episodes" -v
episode_1.mp4 -> Episodes/episode_1.mp4
EPISODE_3.mp4 -> Episodes/EPISODE_3.mp4
episode_2.mp4 -> Episodes/episode_2.mp4
EPISODE_4.mp4 -> Episodes/EPISODE_4.mp4
4 Files moved

maxdepth

$ tree
.
└── dir
    ├── subdir1
    │   ├── subdir1_file.mp3
    │   ├── subdir1_file.mp4
    │   └── subdir1_file.pdf
    └── subdir2
        ├── subdir2_file.mp3
        ├── subdir2_file.mp4
        └── subdir2_file.pdf

3 directories, 6 files

$ arng
0 files moved

$ arng --maxdepth 3 -v
dir/subdir2/subdir2_file.mp4 -> Videos/subdir2_file.mp4
dir/subdir2/subdir2_file.pdf -> Documents/subdir2_file.pdf
dir/subdir2/subdir2_file.mp3 -> Music/subdir2_file.mp3
dir/subdir1/subdir1_file.mp4 -> Videos/subdir1_file.mp4
dir/subdir1/subdir1_file.pdf -> Documents/subdir1_file.pdf
dir/subdir1/subdir1_file.mp3 -> Music/subdir1_file.mp3
6 Files moved

Tweaking arng via config file

you need to create a file ~/.config/arng/arng.conf

you can download the sample config file and move it into the config Directory

wget https://raw.githubusercontent.com/anhsirk0/file-arranger/master/arng.conf

or