txt: ## dist_zef-samy-App-Ebread.md
  # ebread
  
  **ebread** (**eb**ook **read**er) is a program that dumps the contents of an EPUB ebook to plain text. It accomplishes this via the HTML dump feature found in many text-mode web browsers, like `lynx`. The outputted text should be suitable for reading and piping into other programs for further processing.
  
  ## Installing
  
  **ebread** should be able to run on most Unix-like operating systems, as long as they support the dependencies below. There is currently no plan to support Windows.
  
  **ebread** requires the [rakudo](https://rakudoc.org/) compiler.
  
  **ebread** depends on the following Raku modules, which can be installed via the [zef](https://github.com/ugexe/zef)) package manager.
  
  * `File::Temp`
  * `File::Which`
  * `XML`
  
  **ebread** also depends on the following system binaries to be installed:
  
  * `unzip`
  
  and at least one of the following text browsers:
  
  * `elinks`
  * `links`/`links2`
  * `lynx`
  * `w3m`
  
  Once all of the necessary dependencies are installed, **ebread** can be installed via zef.
  
  ```
  zef install .
  
  ```
  
  ## Usage
  
  ```
  ebread [options] epub
  
  ```
  
  By default, **ebread** will dump the text contents of a given EPUB to *stdout*. For more extensive documentation on the usage of **ebread**, you should consult the manual, which can be read either via [rakudoc](https://github.com/Raku/rakudoc) or **ebread**'s `--man` option.
  
  ```
  rakudoc App::Ebread
  ebread --man
  
  ```
  
  ## Copyright
  
  Copyright 2024-2025, Samuel Young
  
  This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.
  