Removes a page range from a PDF.
Documentize.RemovePages
Removes a page range from a PDF.
This is one of the Documentize CLI plugins: a small, self-contained command-line tool. What you download from the Documentize CLI Plugin Catalog is a pre-built, obfuscated .NET assembly (a .dll) -- not source code -- so you run it directly; no build step, SDK, or source checkout required.
Requirements
- .NET 10 runtime installed on your computer (Windows, macOS, or Linux). The download is a pre-built, obfuscated
Documentize.RemovePages.dll -- not source -- so the .NET SDK is not required, only the runtime. - An Aspose Documentize license file,
documentize.lic, placed next to Documentize.RemovePages.dll (the plugin runs in Aspose evaluation/unlicensed mode if it is absent).
OS packages
This plugin renders/edits documents through Aspose. On Linux, .NET's System.Drawing/GDI+ compatibility layer (libgdiplus) and a font configuration (fontconfig + at least one font family) are required for correct text measurement and rendering.
Windows
No extra OS packages are normally required — GDI+ and fonts are part of Windows. If the document uses fonts not installed system-wide, install them normally (Settings > Fonts) so Aspose can find them.
Linux (primary platform)
sudo apt-get update
sudo apt-get install -y libgdiplus fontconfig fonts-liberation fonts-dejavu-core
# Recommended for documents authored with Microsoft-compatible fonts:
sudo apt-get install -y ttf-mscorefonts-installer
fc-cache -f
Run
From the terminal (Linux) / cmd or PowerShell (Windows)
Run it:
# Any OS, with just the .NET 10 runtime installed
dotnet Documentize.RemovePages.dll --remove-range value
# If the download includes a native executable for your OS, you can also run it directly:
./Documentize.RemovePages --remove-range value # Linux/macOS
.\Documentize.RemovePages.exe --remove-range value # Windows (cmd.exe or PowerShell)
Show all available options:
dotnet Documentize.RemovePages.dll --help
Input and output files
The plugin does not take file paths as CLI flags. It reads input from, and writes output to, a per-task folder pair:
- Input folder:
<PLUGIN_INPUT_DIR>/<task-id>/ -- env var PLUGIN_INPUT_DIR, defaults to %TEMP%\documentize\input on Windows and /tmp/documentize/input on Linux/macOS. - Output folder:
<PLUGIN_OUTPUT_DIR>/<task-id>/ -- env var PLUGIN_OUTPUT_DIR, defaults to %TEMP%\documentize\output on Windows and /tmp/documentize/output on Linux/macOS.
Always pass an explicit --task-id so you know which folder to use -- if you omit it, the plugin generates a random GUID internally that you won't know in advance.
Place the PDF you want processed (*.pdf) in the input folder.
Example (Windows PowerShell):
$env:PLUGIN_INPUT_DIR = "C:\documentize-work\input"
$env:PLUGIN_OUTPUT_DIR = "C:\documentize-work\output"
New-Item -ItemType Directory -Force "$env:PLUGIN_INPUT_DIR\job1" | Out-Null
Copy-Item report.pdf "$env:PLUGIN_INPUT_DIR\job1\"
dotnet Documentize.RemovePages.dll --task-id job1 --remove-range value
dir "$env:PLUGIN_OUTPUT_DIR\job1"
The output folder also gets a <task-id>.json handoff file alongside the result -- that's metadata for the Plugin Manager and can be ignored for standalone/manual use.
CLI options
| Flag | Type | Default | Description |
|---|
--remove-range | string | (required) | Pages to remove, e.g. 1,3,5-7. |
Every plugin also accepts --task-id <guid> (alias --id) to set the task id used for the input/output working directories; if omitted, a new GUID is generated.
Alternative input: base64 task JSON
As an alternative to --flags, the plugin also accepts a single base64-encoded JSON argument instead. JSON field names are PascalCase (matching the CLI options above), plus an "ID" field for the task id (same as --task-id/--id; a fresh GUID is generated if omitted). Full field spec:
| JSON field | Type | Required | Default | Description |
|---|
ID | string (GUID) | no | new GUID if omitted | Task id -- same as --task-id/--id. |
RemoveRange | string | yes | -- | Pages to remove, e.g. 1,3,5-7. |
Full example:
{ "ID": "b1e6a4b0-0000-0000-0000-000000000000", "RemoveRange": "2,4,7-9" }
Encode it to base64 and pass that as the plugin's only argument:
# Windows PowerShell
$json = '{ "ID": "b1e6a4b0-0000-0000-0000-000000000000", "RemoveRange": "2,4,7-9" }'
$b64 = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes($json))
dotnet Documentize.RemovePages.dll $b64
# Linux/macOS
python3 -c "import base64; print(base64.b64encode('{ \"ID\": \"b1e6a4b0-0000-0000-0000-000000000000\", \"RemoveRange\": \"2,4,7-9\" }'.encode()).decode())"
dotnet Documentize.RemovePages.dll <base64-string-from-above>
Exit codes
| Code | Meaning |
|---|
| 0 | Success |
| 1 | The task ran but failed (see stderr for the exception) |
| 2 | Usage/argument error (missing required option, invalid value, --help) |