Formatting
This commit is contained in:
parent
567aabda81
commit
e7fce9a9e8
13
README.md
13
README.md
|
@ -1,27 +1,26 @@
|
||||||
## Caesium Command Line Tools
|
# Caesium Command Line Tools [](https://github.com/sponsors/Lymphatus)
|
||||||
|
|
||||||
[](https://github.com/sponsors/Lymphatus)
|
|
||||||
[](https://github.com/Lymphatus/caesium-clt/actions?query=workflow%3ATest)
|
[](https://github.com/Lymphatus/caesium-clt/actions?query=workflow%3ATest)
|
||||||
[](https://github.com/Lymphatus/caesium-clt/actions/workflows/clippy.yml)
|
[](https://github.com/Lymphatus/caesium-clt/actions/workflows/clippy.yml)
|
||||||
[](https://github.com/Lymphatus/caesium-clt/actions/workflows/fmt.yml)
|
[](https://github.com/Lymphatus/caesium-clt/actions/workflows/fmt.yml)
|
||||||
|
|
||||||
v1.0.0-beta.0
|
v1.0.0-beta.0
|
||||||
|
|
||||||
### Development
|
## Development
|
||||||
|
|
||||||
#### Requirements
|
### Requirements
|
||||||
|
|
||||||
* [Rust](https://www.rust-lang.org/tools/install) >= 1.79.0
|
* [Rust](https://www.rust-lang.org/tools/install) >= 1.79.0
|
||||||
|
|
||||||
#### Build
|
### Build
|
||||||
|
|
||||||
`cargo build --release`
|
`cargo build --release`
|
||||||
|
|
||||||
### Usage
|
## Usage
|
||||||
|
|
||||||
See full usage docs [here](docs/USAGE.md).
|
See full usage docs [here](docs/USAGE.md).
|
||||||
|
|
||||||
#### Examples
|
### Examples
|
||||||
|
|
||||||
Losslessly compress ```image1.jpg```, located in the ```home``` directory, into a folder called ```output```
|
Losslessly compress ```image1.jpg```, located in the ```home``` directory, into a folder called ```output```
|
||||||
|
|
||||||
|
|
|
@ -4,62 +4,62 @@
|
||||||
|
|
||||||
##### Compression (at least one is required)
|
##### Compression (at least one is required)
|
||||||
|
|
||||||
- -q, --quality <QUALITY>
|
- `-q, --quality <QUALITY>`
|
||||||
Sets compression quality between 0 and 100. Higher the value, better the quality and bigger the file size.
|
Sets compression quality between 0 and 100. Higher the value, better the quality and bigger the file size.
|
||||||
- --lossless
|
- `--lossless`
|
||||||
Perform lossless compression. Some file formats may not support this or result in bigger file sizes.
|
Perform lossless compression. Some file formats may not support this or result in bigger file sizes.
|
||||||
- --max-size <MAX_SIZE>
|
- `--max-size <MAX_SIZE>`
|
||||||
Attempts to compress the image to the nearest size in bytes without exceeding it. If the requested size is too small,
|
Attempts to compress the image to the nearest size in bytes without exceeding it. If the requested size is too small,
|
||||||
it will output the smallest possible result.
|
it will output the smallest possible result.
|
||||||
|
|
||||||
##### Advanced compression
|
##### Advanced compression
|
||||||
|
|
||||||
- --png-opt-level <PNG_OPT_LEVEL>
|
- `--png-opt-level <PNG_OPT_LEVEL>`
|
||||||
Sets the optimization level for PNG files. Higher values result in better compression but take longer to complete.
|
Sets the optimization level for PNG files. Higher values result in better compression but take longer to complete.
|
||||||
Possible values are between 0 and 6. Default is 3.
|
Possible values are between 0 and 6. Default is 3.
|
||||||
- --zopfli
|
- `--zopfli`
|
||||||
Use zopfli when optimizing PNG files. It may take a very long time to complete, especially if the application is not
|
Use zopfli when optimizing PNG files. It may take a very long time to complete, especially if the application is not
|
||||||
build in release mode.
|
build in release mode.
|
||||||
|
|
||||||
##### Metadata
|
##### Metadata
|
||||||
|
|
||||||
- -e, --exif
|
- `-e, --exif`
|
||||||
Keeps EXIF metadata info during compression, if present. This can slightly increase the output file size.
|
Keeps EXIF metadata info during compression, if present. This can slightly increase the output file size.
|
||||||
- --keep-dates
|
- `--keep-dates`
|
||||||
Keeps the original last modified and last accessed date information, if possible.
|
Keeps the original last modified and last accessed date information, if possible.
|
||||||
|
|
||||||
##### Resizing
|
##### Resizing
|
||||||
|
|
||||||
- --width <WIDTH>
|
- `--width <WIDTH>`
|
||||||
Sets the width of the output image. If height is not set, it will preserve the aspect ratio. Can't be used with
|
Sets the width of the output image. If height is not set, it will preserve the aspect ratio. Can't be used with
|
||||||
`--long-edge` or `--short-edge`.
|
`--long-edge` or `--short-edge`.
|
||||||
- --height <HEIGHT>
|
- `--height <HEIGHT>`
|
||||||
Sets the height of the output image. If width is not set, it will preserve the aspect ratio. Can't be used with
|
Sets the height of the output image. If width is not set, it will preserve the aspect ratio. Can't be used with
|
||||||
`--long-edge` or `--short-edge`.
|
`--long-edge` or `--short-edge`.
|
||||||
- --long-edge <LONG_EDGE>
|
- `--long-edge <LONG_EDGE>`
|
||||||
Sets the size of the longest edge of the image. It is aware of rotation metadata. Can't be used with `--width` or
|
Sets the size of the longest edge of the image. It is aware of rotation metadata. Can't be used with `--width` or
|
||||||
`--height` or `--short-edge`.
|
`--height` or `--short-edge`.
|
||||||
- --short-edge <SHORT_EDGE>
|
- `--short-edge <SHORT_EDGE>`
|
||||||
Sets the size of the shortest edge of the image. It is aware of rotation metadata. Can't be used with `--width` or
|
Sets the size of the shortest edge of the image. It is aware of rotation metadata. Can't be used with `--width` or
|
||||||
`--height` or `--long-edge`.
|
`--height` or `--long-edge`.
|
||||||
|
|
||||||
##### Destination
|
##### Destination
|
||||||
|
|
||||||
- -o, --output <OUTPUT>
|
- `-o, --output <OUTPUT>`
|
||||||
Sets the output folder. If the folder does not exist, it will be created. Can't be used with `--same-folder-as-input`.
|
Sets the output folder. If the folder does not exist, it will be created. Can't be used with `--same-folder-as-input`.
|
||||||
- --same-folder-as-input
|
- `--same-folder-as-input`
|
||||||
Sets the output folder to be the same as the input folder. WARNING: this can potentially overwrite the original files
|
Sets the output folder to be the same as the input folder. WARNING: this can potentially overwrite the original files
|
||||||
if a suffix is not set. Overwritten files CANNOT be recovered.
|
if a suffix is not set. Overwritten files CANNOT be recovered.
|
||||||
- --suffix <SUFFIX>
|
- `--suffix <SUFFIX>`
|
||||||
Adds a suffix to the output filename, before the file extension.
|
Adds a suffix to the output filename, before the file extension.
|
||||||
- -S, --keep-structure
|
- `-S, --keep-structure`
|
||||||
Preserves the folder tree structure of the input files. Can be used only with `-R`.
|
Preserves the folder tree structure of the input files. Can be used only with `-R`.
|
||||||
- -o, --overwrite <OVERWRITE>
|
- `-o, --overwrite <OVERWRITE>`
|
||||||
Sets the overwrite policy if the output file already exists. Possible values are:
|
Sets the overwrite policy if the output file already exists. Possible values are:
|
||||||
- `all`: Always overwrite
|
- `all`: Always overwrite
|
||||||
- `never`: Never overwrite
|
- `never`: Never overwrite
|
||||||
- `bigger`: Overwrite only if the file to be overwritten is bigger
|
- `bigger`: Overwrite only if the file to be overwritten is bigger
|
||||||
- --format <FORMAT>
|
- `--format <FORMAT>`
|
||||||
Converts the original image to the selected format. Possible values are:
|
Converts the original image to the selected format. Possible values are:
|
||||||
- `jpeg`
|
- `jpeg`
|
||||||
- `png`
|
- `png`
|
||||||
|
@ -69,24 +69,24 @@
|
||||||
|
|
||||||
##### Other
|
##### Other
|
||||||
|
|
||||||
- -R, --recursive
|
- `-R, --recursive`
|
||||||
If the input is a folder, scan its subfolders too.
|
If the input is a folder, scan its subfolders too.
|
||||||
- -d, --dry-run
|
- `-d, --dry-run`
|
||||||
Do not write output files, only simulate the process.
|
Do not write output files, only simulate the process.
|
||||||
- --threads <THREADS>
|
- `--threads <THREADS>`
|
||||||
Specify the number of parallel jobs. The maximum is the number of processors available. `0` means that the application
|
Specify the number of parallel jobs. The maximum is the number of processors available. `0` means that the application
|
||||||
will try to guess the maximum number of parallel jobs available. Default is `0`.
|
will try to guess the maximum number of parallel jobs available. Default is `0`.
|
||||||
- -Q, --quiet
|
- `-Q, --quiet`
|
||||||
Suppress all output. Overrides `--verbose`.
|
Suppress all output. Overrides `--verbose`.
|
||||||
- --verbose <VERBOSE>
|
- `--verbose <VERBOSE>`
|
||||||
Select how much output you want to see. Possible values are:
|
Select how much output you want to see. Possible values are:
|
||||||
- `quiet`: Suppress all output
|
- `quiet`: Suppress all output
|
||||||
- `progress`: Show only progress and final results
|
- `progress`: Show only progress and final results
|
||||||
- `warnings-and-errors`: Show also skipped and error messages
|
- `warnings-and-errors`: Show also skipped and error messages
|
||||||
- `all`: Print all
|
- `all`: Print all
|
||||||
- -h, --help
|
- `-h, --help`
|
||||||
Print help. A summary can be seen with `-h`.
|
Print help. A summary can be seen with `-h`.
|
||||||
- -V, --version
|
- `-V, --version`
|
||||||
Print version.
|
Print version.
|
||||||
|
|
||||||
### Full help
|
### Full help
|
||||||
|
|
Loading…
Reference in New Issue