Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/groupdocs-viewer-app/GroupDocs.Viewer-for-.NET-CLI
CLI - Command-Line Interface for GroupDocs.Viewer for .NET document viewer and automation API.
https://github.com/groupdocs-viewer-app/GroupDocs.Viewer-for-.NET-CLI
cli csharp document-viewer dotnet groupdocs viewer
Last synced: about 2 months ago
JSON representation
CLI - Command-Line Interface for GroupDocs.Viewer for .NET document viewer and automation API.
- Host: GitHub
- URL: https://github.com/groupdocs-viewer-app/GroupDocs.Viewer-for-.NET-CLI
- Owner: groupdocs-viewer-app
- License: mit
- Created: 2021-07-01T09:25:55.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-02T17:50:14.000Z (3 months ago)
- Last Synced: 2024-07-03T06:52:07.403Z (3 months ago)
- Topics: cli, csharp, document-viewer, dotnet, groupdocs, viewer
- Language: C#
- Homepage: https://products.groupdocs.com/viewer/net
- Size: 1.54 MB
- Stars: 4
- Watchers: 7
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- jimsghstars - groupdocs-viewer-app/GroupDocs.Viewer-for-.NET-CLI - CLI - Command-Line Interface for GroupDocs.Viewer for .NET document viewer and automation API. (C# #)
README
# CLI for GroupDocs.Viewer for .NET
CLI - Command Line Interface for [GroupDocs.Viewer for .NET](https://products.groupdocs.com/viewer/net) document viewer and automation API.
## How to install
GroupDocs.Viewer CLI is a dotnet tool. To start using the CLI you'll need .NET runtime and GroupDocs.Viewer CLI.
1. Install .NET Core runtime following by the [instructions](https://docs.microsoft.com/en-us/dotnet/core/install/)
2. Install dotnet tool by running `dotnet tool install --global groupDocs.viewer-cli`
3. You can run GroupDocs.Viewer.CLI by using command `groupdocs-viewer`
## Example usage
Type `view` command and source filename to convert the file to HTML and place the output in the current directory:
```bash
groupdocs-viewer view source.docx
```
Set `output-format` parameter value to `PDF` to convert document to PDF:
```bash
groupdocs-viewer view source.docx --output-format PDF
```
Set `pages` parameter valued to `1,3,4` to convert first three pages of the document:
```bash
groupdocs-viewer view source.docx --output-format pdf --pages 1,2,3
```
The `--help` or `view --help` option provides more detail about each parameter. \
The `--version` option provides information about CLI version in use.
## Commands
* `view` converts file to specified `output-format`. The default value is `HTML`.
* `get-view-info` retrieves view details for a specified file that includes list of pages and source file-type.
## Parameters
### Parameters for "view" command
* `--file-type`: Source document file type e.g. `DOCX`.
* `--password` [short: `-pwd`]: Password to open password-protected file.
* `--encoding` [short: `-enc`]: Source document encoding e.g `UTF-8`.
* `--pages` [short: `-p`]: Comma-separated page numbers to convert e.g `1,2,3`.
* `--output` [short `-o`]: Output file path when converting to HTML, PNG, and JPG. Or output filename when converting to PDF.
* `--resource-filepath-template`: Resource filepath template when converting to HTML with external resources e.g. `p_{0}_{1}`.
* `--resource-url-format`: Resource URL format for HTML with external resources.
* `--height`: Output image height.
* `--width`: Output image width.
* `--max-height`: Max height for output image.
* `--max-width`: Max width for output image.
### Parameters for "view" and "get-view-info" commands
* `--license-path`: Path to license file.
* `--output-format` [short: `-f`]: Output format, supported values are `Html`, `HtmlExt`, `Png`, `Jpg`, and `Pdf`.
* `--verbose` [short `-v`]: Enable detailed logging to console.
* `--save-attachments`: Save attachments on disk if selected file support it.
* `--attachments-list`: Get attachments list for selected file if it supported.
## Setting the license
Without a license the tool will work in trial mode so you can convert only first two pages of a document see [Evaluation Limitations and Licensing of GroupDocs.Viewer](https://docs.groupdocs.com/viewer/net/evaluation-limitations-and-licensing-of-groupdocs-viewer/) for more details. A temporary license can be requested at [Get a Temporary License](https://purchase.groupdocs.com/temporary-license).
The license can be set with `--license-path` parameter:
```bash
groupdocs-viewer view source.docx --license-path c:\\licenses\\GroupDocs.Viewer.lic
```
Also, you can set path to the license file in `GROUPDOCS_VIEWER_LICENSE_PATH` environment variable.
## Linux dependencies
For correct deploy please install the following package dependencies:
* `apt-transport-https`
* `dirmngr`
* `gnupg`
* `libc6-dev`
* `libgdiplus`
* `libx11-dev`
* `ttf-mscorefonts-installer`
As an example the following commands should be executed to install the dependencies on [Ubuntu 18.04.5 LTS (Bionic Beaver)](https://releases.ubuntu.com/18.04.5/):
* `apt-get update`
* `apt-get install -y apt-transport-https`
* `apt-get install -y dirmngr`
* `apt-get install -y gnupg`
* `apt-get install -y ca-certificates`
* `apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys $ 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF`
* `echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic $ main" >> /etc/apt/sources.list.d/mono-official-stable.list`
* `apt-get update`
* `apt-get install -y --allow-unauthenticated libc6-dev libgdiplus libx11-dev`
* `apt-get install -y ttf-mscorefonts-installer`