# readability-cli(1) -- get useful text from a web page ## SYNOPSYS **readable** *[SOURCE]* *[options]...* ## DESCRIPTION **readability-cli** takes any HTML page and strips out unnecessary bloat, leaving only the core text content. The resulting HTML may be suitable for terminal browsers, text readers, and other uses. This package provides the **readable** command, which uses Mozilla's Readability library. The same library is used in Firefox's Reader View. The *SOURCE* can be a URL, a file, or '-' for standard input. ## OPTIONS `--help` * Show help message, and exit. `-b`, `--base` *URL* * Specify the document's URL. This affects relative links: they will not work if **readability-cli** does not know the base URL. You only need this option if you read HTML from a local file, or from standard input. `-S`, `--insane` * Don't sanitize HTML. `-K`, `--insecure` * (Node.js version only) Allow invalid SSL certificates. `-j`, `--json` * Output all known properties of the document as JSON (see **Properties** subsection). `-l`, `--low-confidence` *MODE* * What to do if Readability is uncertain about what the core content actually is. The possible modes are: * **keep** - When unsure, don't touch the HTML, output as-is. * **force** - Process the document even when unsure (may produce really bad output). * **exit** - When unsure, exit with an error. * The default value is **keep**. If the `--properties` or `--json` options are set, the program will always run in **exit** mode. `-C`, `--keep-classes` * Preserve CSS classes for input elements. By default, CSS classes are stripped, and the input is adapted for Firefox's Reader View. `-o`, `--output` *FILE* * Output the result to FILE. `-p`, `--properties` *PROPERTIES*... * Output specific properties of the document (see **Properties** subsection). `-x`, `--proxy` *URL* * (Node.js version only) Use specified proxy. Node.js and Deno can also use `HTTPS_PROXY` environment variable. `-q`, `--quiet` * Don't print extra information. `-s`, `--style` * Specify *.css* file for stylesheet. `-A`, `--user-agent` *STRING* * Set custom user agent string. `-V`, `--version` * Print **readability-cli** and Node.js/Deno version, then exit. `--completion` * Print script for shell completion, and exit. Provides Zsh completion if the current shell is zsh, otherwise provides Bash completion. Currently broken when using Deno. ### Properties The `--properties` option accepts a list of values, separated by spaces. Suitable values are: * **title** - The title of the article. * **html-title** - The title of the article, wrapped in an `