refine-3.1.0 is not a library.

refine

Crates.io GitHub Sponsors

Refine your file collection using Rust!

What it does

This tool will revolutionize the way you manage your media collections! It can simultaneously scan multiple root directories and analyze all the files and directories found as a whole, performing some advanced operations on them. And it is very easy to use, with a simple and intuitive command line interface that will let you quickly get the results you want.

It will help you reasonably find duplicated files both identically and by fuzzy filename similarity, seamlessly join them into a single directory with advanced name conflict resolution, quickly list files from multiple directories sorted together by various criteria, effortlessly rename files and directories using advanced regular expression rules, intelligently rebuild entire media collection names by identifying groups and s, and even reliably probe collection filenames against a remote server! It is a one-stop solution for all your media needs, allowing you to organize them in a way that makes sense to you.

Use it to refine your photos, music, movies, porn, docs, or any other collections, cleaning up and organizing them in a way that makes sense to you.

Note: every command is dry-run by default, so don't worry experimenting! This is a key feature of this tool, the commands are interactive unless you say otherwise, allowing you to preview what would be done and then confirm or abort the changes. You can thus try out different commands and options without the risk of changing or losing anything!

I've made this tool to be the fastest and easiest way to organize media collections. It helps me a lot, and I hope it can help you too.

And yes, it is blazingly fast, like all Rust 🦀 software should be!

Enjoy!

refine 3.1 list

How to use it

Install refine with:

cargo install refine

And that's it, you're ready to go! You can now call it anywhere.

What's new in 3.1

This is a minor release with a major refactor of the codebase, improving the structure and maintainability of the code, as well as optimizing hot paths and polishing the user experience.

The most notable change is the support for comments in the rebuild command, which allows you to add comments to the collection media files that will be preserved upon rebuilding. This is useful to add notes or reminders right in the filenames. This provides context, making it easier to identify media and their content without having to open them. The comments are added at the end of the filename, after the sequence number, and are preserved even when the rest of the filename is changed by applying different naming rules.

What's new in 3.0

I'm thrilled to announce a release packed with deep, carefully engineered improvements! This update is the culmination of a significant technical effort, bringing both new capabilities and cool new refinements. The straight jump from 2.0 to 3.0 reflects the magnitude of these changes, about 100 commits worth of work over several months, with a strong focus on enhancing the core algorithms and bringing new features to life.

The flagship feature is the completely revamped dupes command, now equipped with a sophisticated detection algorithm that combines fuzzy string matching and a novel rare-token scoring system! This innovative approach vastly improves duplicate detection accuracy, even in tricky and non-exact cases. This means you’ll find more duplicates, not just exact matches, making cleanup much more effective!

This new algorithm employs a multi-faceted approach:

Sophisticated Name Similarity Detection:
- Fuzzy String Matching: Combines normalized Levenshtein distance with Sørensen-Dice coefficient for detecting both minor typos and structural similarities
- Rare Token Scoring: Builds corpus-wide token frequency maps and weights matches by token rarity using inverse logarithmic frequency
- Union-Find Clustering: Employs union-find data structures for efficient grouping with average similarity tracking across group merges
- Intelligent Filtering: Includes semantic filters to exclude TV series and sequential files using number pattern analysis
Advanced Text Processing:
- Unicode Normalization: Filenames are preprocessed with transliteration and accent removal to ensure consistent matching
- Multi-language Stopword Filtering: Comprehensive stopword lists for English and Portuguese built-in
- Media-specific Tag Recognition: Removal of common media tags (web-dl, blu-ray, codecs, resolutions, etc.)
- MIME-aware Classification: Features media type detection combining MIME guessing with extension overrides, so movies are not tagged as similar to their own subtitles
Other Optimizations:
- Parallel Processing: Parallel similarity computation with progress tracking, leveraging multicore CPUs
- Inverted Token Indexing: Efficient candidate pair generation using token-based blocking
- Advanced Content Sampling: Implements a new three-point sampling strategy (beginning, middle, end) still with configurable sample size, achieving high accuracy for large media files while avoiding full file reads

Also in this release there are several other improvements, such as natural sorting for displaying entries in list and the global --show, better clash resolution reporting in join and rename, support for comments in collections in rebuild, new fetch options path_in and path_ex for including and excluding paths, new "recipe type" options in naming rules for advanced transformations, support for on-demand separators in naming rules regexes, etc. There's a lot to explore!

New in 2.0

Yay! This is a major release, with a lot of new features! The most exciting one is global support for COLORS, making files and directories much easier to read and distinguish!

Also, the list command is greatly improved, with support for listing directory entries, complete with their number of files and full sizes! This was only possible with the new precise recursion feature, allowing you to choose how deep you want to go within directories. You can also now sort the output by number of files, in addition to size (full recursive size), name, or path.

Another great new feature is the global --view option, which allows you to bypass any command and quickly view the filtered files and directories that will be processed by it! Countless times I wanted to preview my filter results, forcing me to replace the command with list, remove all other arguments, execute it, study the output, and painstakingly reconstruct the original command—a hugely frustrating process. And now we can do it in any command without changing anything, just by adding --view!

Everything is again more polished and optimized. Even the usage and help are much more user-friendly!

And last but not least, the input paths can now be relative, which will make all output also be relative and thus easier to read.

New in 1.4

This version introduces the probe command, which allows you to probe filenames against a remote server! This can be used to validate the filenames of your media collections by checking whether a URL points to a valid file or page on a remote server.

Also, the rebuild command has a new --case option, which allows you to keep the original case of the filenames, and the rename command has improved support for handling clashes, allowing you to insert sequence numbers in the filenames when you really want to let them be the same.

New in 1.3

This version is mostly about polishing, with some improvements and bug fixes.

We have a smarter list command, which hides full paths by default and uses descending order for size and ascending for name and path; join: change no_remove flag to parents (n -> p) and some clash options; rebuild: change simple_match flag to simple and fix full mode, which was not resetting sequences; general polishing.

New in 1.2

Here is a much improved partial mode in Rebuild command, which can alter groups of filenames while preserving sequences, and even detect and fix gaps in sequences caused by deleted files.

New in 1.1

Revamped join command! It now supports non-empty target folders, and will resolve clashes accordingly.

Also, several enum CLI arguments now support aliases, and I've fixed join command still moving files even when copy was requested.

New in 1.0

Yes, it is time. After a complete overhaul of the code, it's time to release 1.0! It's an accomplishment I'm proud of, which took over 70 commits and a month's work, resulting in most of the code being rewritten. It is more mature, stable, and well-structured now.

The major motivation for this version is the rebuild Partial mode! We can now rebuild collections even when some directories are not available! This means that files not affected by the specified naming rules will stay the same, keeping their sequence numbers, while new files are appended after the highest sequence found. It is handy for collections on external drives or cloud storage which are not always connected, allowing you to, even on the go, rebuild new files without messing up previous ones.

And this also includes:

rebuild: new --replace option to replace all occurrences of some string or regex in the filenames with another one.
new internal CLI options handling, which enables commands to modify them prior to their execution.
- the new rebuild partial mode is auto-enabled in case not all directories are currently available.

New in 0.18

rebuild: new force implementation that is easier to use
- it conflicts with any other options so must be used alone
- now it just overwrites filenames without exceptions → best used with -i or on already organized collections
- improved memory usage

New in 0.17

join: new clash resolve option
- by default, no changes are allowed in directories where clashes are detected
- all directories with clashes are listed, showing exactly which files are in them

New in 0.16

complete overhaul of the scan system, allowing directories to be extracted alongside files
new join command, already with directory support
new magic -i and -x options that filter both files and directories
new filter options for files, directories, and extensions
rename: include full directory support

New in 0.15

nicer rename command output by parent directory
new threaded yes/no prompt that can be aborted with CTRL-C

New in 0.14

rename: disallow by default changes in directories where clashes are detected
- new --clashes option to allow them

New in 0.13

rename: new replace feature, finally!
global: make strip rules also remove . and _, in addition to - and spaces
global: include and exclude options do not check extensions
dupes: remove case option, so everything is case-insensitive now

New in 0.12

global: new --dir-in and --dir-out options.

New in 0.11

new rename command
rebuild, rename: improve strip exact, not removing more spaces than needed

New in 0.10

global: new --exclude option to exclude files

New in 0.9

new support for Ctrl-C, to abort all operations and gracefully exit the program at any time.
- all commands will stop collecting files when Ctrl-C is pressed
- both dupes and list command will show partial results
- the rebuild command will just exit, as it needs all the files to run

New in 0.8

new "list" command

New in 0.7

global: new --include option to filter input files
rebuild: new --force option to easily rename new files
rebuild: new interactive mode by default, making --dry_run obsolete (removed), with new --yes option to bypass it (good for automation)
rebuild: auto fix renaming errors
dupes: faster performance by ignoring groups with one file (thus avoiding loading samples)
rebuild: smaller memory consumption by caching file extensions

Commands

All commands will:

scan all the given directories recursively (excluding hidden .folders)
- can optionally filter files and directories based on several options
load the metadata for each file like size and creation date, as required by some commands
execute the command and show the results
ask the user to perform the changes, if applicable

The global refine command (help)

$ refine --help

Refine your file collections using Rust!

Usage: refine <COMMAND> [DIRS]... [FETCH] [OPTIONS]

Commands:
  dupes    Find possibly duplicated files by both size/sample and filename similarity
  join     Join files into a single directory with advanced conflict resolution
  list     List files from multiple disjoint directories sorted together
  rebuild  Rebuild entire media collections' filenames intelligently
  rename   Rename files and directories in batch using advanced regex rules
  probe    Probe collections' filenames against a remote server
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

For more information, see https://github.com/rsalmei/refine

The `dupes` command

The dupes command will analyze and report the possibly duplicated files, either by size or name. It will even load a sample from each file, to guarantee they are indeed duplicated. It is a small sample by default but can help reduce false positives a lot, and you can increase it if you want.

group all the files by size
for each group with the exact same value, load a sample of its files
compare the samples with each other and find possible duplicates
group all the files by words in their names
- the word extractor ignores sequence numbers like file-1, file copy, file-3 copy 2, etc.
run 2. and 3. again, and print the results

$ refine dupes --help

Find possibly duplicated files by both size/sample and filename similarity

Usage: refine dupes [DIRS]... [FETCH] [OPTIONS]

Arguments:
  [DIRS]...  The directories to scan

Options:
  -m, --mode <STR>         Identical (size and sample), or similar (rare tokens and fuzzy matching) [default: all] [possible values: identical, similar, all]
  -s, --sample <INT>       Sample size in kbytes (0 to disable) [default: 4]
  -t, --threshold <FLOAT>  The threshold for similarity checks (0.0 to 1.0) [default: 0.7]
  -v, --verbose            Show the cleaned filenames for similarity checks
  -h, --help               Print help

Fetch:
  -R, --recursion <INT>  The maximum recursion depth; use 0 for unlimited, 1 for shallow, and n for depth n [default: 0]
  -F, --only-files       Include only files
  -D, --only-dirs        Include only directories
  -i, --inc <REGEX>      Include files, directories, and paths that matches this
  -x, --exc <REGEX>      Exclude files, directories, and paths that matches this
  -I, --dir <REGEX>      Include only these directory names
  -X, --dir-ex <REGEX>   Exclude these directory names
      --path <REGEX>     Include only these paths
      --path-ex <REGEX>  Exclude these paths
      --file <REGEX>     Include only these filenames
      --file-ex <REGEX>  Exclude these filenames
      --ext <REGEX>      Include only these extensions
      --ext-ex <REGEX>   Exclude these extensions

Modifiers:
      --show  Show the entries that will be processed, and ask for confirmation before proceeding
      --full  Do not strip the common prefix from the input paths when displaying them

Example:

$ refine dupes ~/Downloads /Volumes/External --sample 20

The `join` command

The join command will let you grab all files and directories in the given directories and join them into a single one. You can filter files however you like, and choose whether they will be joined by moving or copying. It will even remove the empty parent directories after a move joining!

Note: any deletions are only performed after files and directories have been successfully moved/copied. So, in case any errors occur, the files and directories partially moved/copied will be found in the target directory, so you should manually delete them before trying again.

detect clashes, i.e. files with the same name in different directories, and apply the given clash strategy
detect already in-place files
print the resulting changes to the filenames and directories, and ask for confirmation
if the user confirms, apply the changes
remove any empty parent directories when moving files

$ refine join --help

Join files into a single directory with advanced conflict resolution

Usage: refine join [DIRS]... [FETCH] [OPTIONS]

Arguments:
  [DIRS]...  The directories to scan

Options:
  -t, --target <PATH>  The target directory; will be created if it doesn't exist [default: .]
  -b, --by <STR>       The type of join to perform [default: move] [possible values: move, copy]
  -c, --clashes <STR>  How to resolve clashes [default: name-sequence] [possible values: name-sequence, parent-name, name-parent, ignore]
  -f, --force          Force joining already in place files and directories, i.e. in subdirectories of the target
  -p, --parents        Do not remove empty parent directories after joining files
  -y, --yes            Skip the confirmation prompt, useful for automation
  -h, --help           Print help

Fetch:
  -R, --recursion <INT>  The maximum recursion depth; use 0 for unlimited, 1 for shallow, and n for depth n [default: 0]
  -F, --only-files       Include only files
  -D, --only-dirs        Include only directories
  -i, --inc <REGEX>      Include files, directories, and paths that matches this
  -x, --exc <REGEX>      Exclude files, directories, and paths that matches this
  -I, --dir <REGEX>      Include only these directory names
  -X, --dir-ex <REGEX>   Exclude these directory names
      --path <REGEX>     Include only these paths
      --path-ex <REGEX>  Exclude these paths
      --file <REGEX>     Include only these filenames
      --file-ex <REGEX>  Exclude these filenames
      --ext <REGEX>      Include only these extensions
      --ext-ex <REGEX>   Exclude these extensions

Modifiers:
      --show  Show the entries that will be processed, and ask for confirmation before proceeding
      --full  Do not strip the common prefix from the input paths when displaying them

Example:

$ refine join ~/media/ /Volumes/External/ -i 'proj-01' -X 'ongoing' -t /Volumes/External/proj-01

The `list` command

The list command will gather all the files in the given directories, sort them by name, size, or path, and display them in a friendly format.

sort all files by either name, size, or path
- ascending by default for name and path, descending for size, or optionally reverse
print the results

$ refine list --help

List files from multiple disjoint directories sorted together

Usage: refine list [DIRS]... [FETCH] [OPTIONS]

Arguments:
  [DIRS]...  The directories to scan

Options:
  -b, --by <STR>      Sort by [default: size] [possible values: size, count, name, path]
  -r, --rev           Reverse the default order (size/count:desc, name/path:asc)
  -p, --paths         Show file paths
  -c, --no-calc-dirs  Do not calculate directory sizes
  -h, --help          Print help

Fetch:
  -R, --recursion <INT>  The maximum recursion depth; use 0 for unlimited, 1 for shallow, and n for depth n [default: 0]
  -F, --only-files       Include only files
  -D, --only-dirs        Include only directories
  -i, --inc <REGEX>      Include files, directories, and paths that matches this
  -x, --exc <REGEX>      Exclude files, directories, and paths that matches this
  -I, --dir <REGEX>      Include only these directory names
  -X, --dir-ex <REGEX>   Exclude these directory names
      --path <REGEX>     Include only these paths
      --path-ex <REGEX>  Exclude these paths
      --file <REGEX>     Include only these filenames
      --file-ex <REGEX>  Exclude these filenames
      --ext <REGEX>      Include only these extensions
      --ext-ex <REGEX>   Exclude these extensions

Modifiers:
      --show  Show the entries that will be processed, and ask for confirmation before proceeding
      --full  Do not strip the common prefix from the input paths when displaying them

Example:

$ refine list ~/Downloads /Volumes/External --by size --desc

The `rebuild` command

I’m really proud of the rebuild command. It smartly rebuilds all the filenames of entire media collections, e.g., musics by album/singer and videos by streamers and even photos from your camera. Sequence numbers are removed, filenames are stripped according to your needs, similar names are intelligently matched, groups are sorted deterministically by creation date, sequence numbers are regenerated, and files are finally renamed!

It's awesome to quickly find your collections neatly sorted automatically; it's like magic, getting all files cleaned up, sorted, and sequenced with a single command. And upon running it again, the tool will seem to recognize the new files that have been added, as it will regenerate everything but only display entries that need to be changed, as the rest are already correct! And in case you delete files, all the subsequent ones will be renamed accordingly! Quite impressive, don't you think?

And don't worry as this tool is interactive, so you can review all changes before applying them.

apply naming rules to strip or replace parts of the filenames
extract and strip sequence numbers from names
if force mode is enabled, set all names to the forced value
if smart match is enabled, remove spaces and underscores from names
group the files by their resulting names
sort the groups according to the files' created dates
regenerate sequence numbers for each group; if partial mode is enabled, continue from the highest sequence found in the group

Note that these groups can contain files from different directories, and it will just work
print the resulting changes to the filenames, and ask for confirmation
if the user confirms, apply the changes

$ refine rebuild --help

Rebuild entire media collections' filenames intelligently

Usage: refine rebuild [DIRS]... [FETCH] [OPTIONS]

Arguments:
  [DIRS]...  The directories to scan

Options:
  -b, --strip-before <STR|REGEX>        Strip from the start till occurrence; includes separators nearby, use {S} for separators
  -a, --strip-after <STR|REGEX>         Strip from occurrence till the end; includes separators nearby, use {S} for separators
  -e, --strip-exact <STR|REGEX>         Strip exact occurrences; includes separators nearby, use {S} for separators
  -r, --replace <{STR|REGEX}={STR|$N}>  Replace occurrences in the filename; separators are not touched, use {S} for separators
  -w, --throw <{STR|REGEX}={STR|$N}>    recipe: Throw some prefix to the end; use {S} for separators
  -s, --simple                          Disable smart matching, so "foo bar.mp4", "FooBar.mp4" and "foo__bar.mp4" are different
  -f, --force <STR>                     Force to overwrite filenames (use the Global options to filter files)
  -p, --partial                         Assume not all directories are available, which retains current sequences (but fixes gaps)
  -c, --case                            Keep the original case of filenames, otherwise they are lowercased
  -y, --yes                             Skip the confirmation prompt, useful for automation
  -h, --help                            Print help

Fetch:
  -R, --recursion <INT>  The maximum recursion depth; use 0 for unlimited, 1 for shallow, and n for depth n [default: 0]
  -F, --only-files       Include only files
  -D, --only-dirs        Include only directories
  -i, --inc <REGEX>      Include files, directories, and paths that matches this
  -x, --exc <REGEX>      Exclude files, directories, and paths that matches this
  -I, --dir <REGEX>      Include only these directory names
  -X, --dir-ex <REGEX>   Exclude these directory names
      --path <REGEX>     Include only these paths
      --path-ex <REGEX>  Exclude these paths
      --file <REGEX>     Include only these filenames
      --file-ex <REGEX>  Exclude these filenames
      --ext <REGEX>      Include only these extensions
      --ext-ex <REGEX>   Exclude these extensions

Modifiers:
      --show  Show the entries that will be processed, and ask for confirmation before proceeding
      --full  Do not strip the common prefix from the input paths when displaying them

Example:

$ refine rebuild ~/media /Volumes/External -a 720p -a Bluray -b xpto -e old

The `rename` command

The rename command will let you batch rename files like no other tool, seriously! You can quickly strip common prefixes, suffixes, and exact parts of the filenames, as well as apply any regex replacements you want. By default, in case a filename ends up clashing with other files in the same directory, that whole directory will be disallowed to make any changes. The list of clashes will be nicely formatted and printed, so you can manually check them. And you can optionally allow changes to other files in the same directory, removing only the clashes if you find it safe.

apply naming rules to strip or replace parts of the filenames
handle the clashes according to the given strategy, which can:
- forbid any changes in the directory where clashes are detected
- ignore the clashes, allowing other changes in the same directory
- apply sequence numbers to the clashes, allowing all changes
print the resulting changes to the filenames and directories, and ask for confirmation
if the user confirms, apply the changes

$ refine rename --help

Rename files and directories in batch using advanced regex rules

Usage: refine rename [DIRS]... [FETCH] [OPTIONS]

Arguments:
  [DIRS]...  The directories to scan

Options:
  -b, --strip-before <STR|REGEX>        Strip from the start till occurrence; includes separators nearby, use {S} for separators
  -a, --strip-after <STR|REGEX>         Strip from occurrence till the end; includes separators nearby, use {S} for separators
  -e, --strip-exact <STR|REGEX>         Strip exact occurrences; includes separators nearby, use {S} for separators
  -r, --replace <{STR|REGEX}={STR|$N}>  Replace occurrences in the filename; separators are not touched, use {S} for separators
  -w, --throw <{STR|REGEX}={STR|$N}>    recipe: Throw some prefix to the end; use {S} for separators
  -c, --clashes <STR>                   How to resolve clashes [default: sequence] [possible values: sequence, ignore, forbid]
  -y, --yes                             Skip the confirmation prompt, useful for automation
  -h, --help                            Print help

Fetch:
  -R, --recursion <INT>  The maximum recursion depth; use 0 for unlimited, 1 for shallow, and n for depth n [default: 0]
  -F, --only-files       Include only files
  -D, --only-dirs        Include only directories
  -i, --inc <REGEX>      Include files, directories, and paths that matches this
  -x, --exc <REGEX>      Exclude files, directories, and paths that matches this
  -I, --dir <REGEX>      Include only these directory names
  -X, --dir-ex <REGEX>   Exclude these directory names
      --path <REGEX>     Include only these paths
      --path-ex <REGEX>  Exclude these paths
      --file <REGEX>     Include only these filenames
      --file-ex <REGEX>  Exclude these filenames
      --ext <REGEX>      Include only these extensions
      --ext-ex <REGEX>   Exclude these extensions

Modifiers:
      --show  Show the entries that will be processed, and ask for confirmation before proceeding
      --full  Do not strip the common prefix from the input paths when displaying them

Example:

$ refine rename ~/media /Volumes/External -b "^\d+_" -r '([^\.]*?)\.=$1 '

The `probe` command

The probe command allows you to probe filenames against a remote server, which can be very useful to validate the filenames of your media collections. It works by checking whether a URL points to a valid file or page on a remote server.

The URL can be any valid HTTP(S) URL, and must have a placeholder for the filename. The command generates URLs by replacing the placeholder with the names of the files, and sends a HEAD request to each one, allowing you to use some advanced options to control the behavior, such as the timeout, number of retries, wait times, exponential backoff, and when to display errors. The request is expected to return:

a 200 OK or 403 Forbidden response to be considered valid;
a 404 Not Found to be considered invalid;
any other response is retried, with exponential backoff, until the maximum number of retries is reached, then it is considered failed.

It does not support any kind of parallel connections or API rate limiting by design in order to not disturb the server too much. It thus only works in a sequential manner and may take a while to complete. It also does not support any kind of authentication, redirects, or custom headers, so it may not work for some servers.

extract the names from files (without sequence numbers and extension), and deduplicate them
pick the desired subset of them (by a regex)
prepare the URL for each name and probe it with a HEAD request
split the results into Valid, Invalid, Failed, and Pending (in case you press Ctrl+C)
print the invalid ones, along with a summary of the results

$ refine probe --help

Probe collections' filenames against a remote server

Usage: refine probe [DIRS]... [FETCH] [OPTIONS]

Arguments:
  [DIRS]...  The directories to scan

Options:
  -p, --pick <REGEX>     Pick a subset of the files to probe
  -u, --url <URL>        The URL to probe filenames against (use `$` as placeholder, e.g. https://example.com/$/)
  -t, --timeout <INT>    The HTTP connection and read timeouts in milliseconds [default: 2000]
  -n, --min-wait <INT>   The initial time to wait between retries in milliseconds [default: 1000]
  -b, --backoff <FLOAT>  The factor by which to increase the time to wait between retries [default: 1.5]
  -a, --max-wait <INT>   The maximum time to wait between retries in milliseconds [default: 5000]
  -r, --retries <INT>    The maximum number of retries; use 0 to disable and -1 to retry indefinitely [default: -1]
  -e, --errors <STR>     Specify when to display errors [default: each10] [possible values: never, last, always, each10]
  -h, --help             Print help

Fetch:
  -R, --recursion <INT>  The maximum recursion depth; use 0 for unlimited, 1 for shallow, and n for depth n [default: 0]
  -F, --only-files       Include only files
  -D, --only-dirs        Include only directories
  -i, --inc <REGEX>      Include files, directories, and paths that matches this
  -x, --exc <REGEX>      Exclude files, directories, and paths that matches this
  -I, --dir <REGEX>      Include only these directory names
  -X, --dir-ex <REGEX>   Exclude these directory names
      --path <REGEX>     Include only these paths
      --path-ex <REGEX>  Exclude these paths
      --file <REGEX>     Include only these filenames
      --file-ex <REGEX>  Exclude these filenames
      --ext <REGEX>      Include only these extensions
      --ext-ex <REGEX>   Exclude these extensions

Modifiers:
      --show  Show the entries that will be processed, and ask for confirmation before proceeding
      --full  Do not strip the common prefix from the input paths when displaying them

Example:

$ refine probe ~/media /Volumes/External --url 'https://example.com/$/' -r3 -el

Changelog

Complete here.

License

This software is licensed under the MIT License. See the LICENSE file in the top distribution directory for the full license text.

Maintaining an open source project is hard and time-consuming, and I've put much ❤️ and effort into this.

If you've appreciated my work, you can back me up with a donation! Thank you. 😊

refine 3.1.0

refine

Refine your file collection using Rust!

What it does

How to use it

What's new in 3.1

What's new in 3.0

New in 2.0

New in 1.4

New in 1.3

New in 1.2

New in 1.1

New in 1.0

New in 0.18

New in 0.17

New in 0.16

New in 0.15

New in 0.14

New in 0.13

New in 0.12

New in 0.11

New in 0.10

New in 0.9

New in 0.8

New in 0.7

Commands

The global refine command (help)

The dupes command

The join command

The list command

The rebuild command

The rename command

The probe command

Changelog

License

The `dupes` command

The `join` command

The `list` command

The `rebuild` command

The `rename` command

The `probe` command