fb2-clean 0.5.0

A simple GUI/CLI utility to remove images from fb2 books.
Documentation

fb2-clean

A simple GUI/CLI utility to remove images from fb2 books.

Tests

logo

Quick Start

GUI version

  1. Download a Fb2CleanGui-* archive for your system.
  2. Unpack it.
  3. Run the unpacked Fb2CleanGui.
  4. Setup if needed.
  5. Press START button to clean.

gui-example

CLI version

  1. Download a fb2-clean-* archive for your system.
  2. Unpack it.
  3. Run the unpacked fb2-clean in a directory with fb2 files.

cli-example

Default Behaviour

  • Saves cleaned files to the cleaned subdirectory.
  • Cleans all fb2 and fb2.zip in a CWD directory.
  • Removes binary, coverpage, and image tags.
  • Keeps input extension: saves fb2 as fb2 and fb2.zip as fb2.zip.

Advanced Use 🤓

Run fb2-clean -h to display help.

Option Description
-i, --input <path> Directory with files OR file to clean
-o, --output <dir> Save output files to directory
-r, --recursive <n> Find files in nested directories (up to n level)
-t, --tags <n[,m...]> Remove tags from file structure
-z, --zip Save output files as fb2.zip
-Z, --unzip Save output files as fb2
-w, --overwrite Overwrite input files
-e, --exit-on-err Don't clean next files on error
-j, --jobs <n> Max parallel jobs (multithreading)
-l, --lang <lng> Set log language

Manual Build 🤓

  1. Install Rust.
  2. Clone the repo:
git clone https://github.com/nujievik/fb2-clean --depth 1
  1. Enter the project directory:
cd fb2-clean
  1. Build:

    • GUI version:
    cargo build --release --bin Fb2CleanGui --no-default-features --features gui
    
    • CLI version:
    cargo build --release
    
  2. On success, the binary will be in target/release/ directory.