2021-02-21 15:55:27 +00:00
|
|
|
fif
|
|
|
|
|
===
|
2021-02-21 16:15:35 +00:00
|
|
|
[](https://crates.io/crates/fif)
|
|
|
|
|
[](https://git.bune.city/lynnesbian/fif/src/branch/master/LICENSE)
|
2021-02-27 02:43:15 +00:00
|
|
|
|
2021-02-28 12:16:54 +00:00
|
|
|
[](https://drone.bune.city/lynnesbian/fif)
|
2021-02-21 16:15:35 +00:00
|
|
|
|
2021-02-21 15:55:27 +00:00
|
|
|
A command-line tool for detecting and optionally correcting files with incorrect extensions.
|
|
|
|
|
|
|
|
|
|
## Installation
|
2021-02-27 02:43:15 +00:00
|
|
|
### Default backend
|
2021-02-21 15:55:27 +00:00
|
|
|
```bash
|
|
|
|
|
cargo install --locked fif
|
|
|
|
|
```
|
|
|
|
|
|
2021-02-27 02:43:15 +00:00
|
|
|
### Other backends
|
|
|
|
|
`fif` supports using [infer](https://crates.io/crates/infer) or [xdg-mime](https://crates.io/crates/xdg-mime) as its
|
|
|
|
|
backend for looking up file types. By default, xdg-mime will be used on Linux, and infer on all other systems.
|
|
|
|
|
|
|
|
|
|
xdg-mime should work on any Unixy system with [libmagic/file(1)](https://www.darwinsys.com/file/) installed, although
|
|
|
|
|
I've only tested it on Linux. infer should work on any system.
|
|
|
|
|
|
|
|
|
|
You can override the default backend for your system at compile time like so:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# xdg-mime
|
|
|
|
|
cargo install --features=xdg-mime-backend
|
|
|
|
|
# infer
|
|
|
|
|
cargo install --features=infer-backend
|
|
|
|
|
```
|
|
|
|
|
|
2021-02-21 15:55:27 +00:00
|
|
|
## Usage
|
2021-02-21 16:08:08 +00:00
|
|
|
See `fif --help` for more.
|
|
|
|
|
|
|
|
|
|
### The basics
|
|
|
|
|
The simplest way to use fif looks like this:
|
|
|
|
|
```bash
|
|
|
|
|
fif -E images ~/Pictures
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
This command will scan all of the files with extensions used by image files (.jpg, .png, etc) in your `~/Pictures`
|
|
|
|
|
directory.
|
|
|
|
|
|
|
|
|
|
You can also manually specify a set of extensions to use:
|
|
|
|
|
|
2021-02-21 15:55:27 +00:00
|
|
|
```bash
|
2021-02-21 16:08:08 +00:00
|
|
|
fif -e jpeg,jpg,zip,docx ~/Documents
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
By default, fif will output a bash script that can be used to fix all the files it found with incorrect file extensions.
|
|
|
|
|
You might find it useful to output this script to a file (rather than to stdout):
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
fif -E images ~/Pictures > output.sh
|
|
|
|
|
```
|
2021-02-27 02:43:15 +00:00
|
|
|
|
|
|
|
|
More coming soon!
|
