dragoid/README.md

Download and read novels offline

# Dragoid

Download novels to read offline.

## Requirements

- Linux
- Node.js v22.17.0 or higher.

## Installation

```bash
npm install -g dragoid
```

### Puppeteer

Some bots use Puppeteer with Chrome to retrieve information (novel or chapter). If Chrome is not found in `~/.cache/puppeteer`, try installing it manually using the following command:

```bash
npx puppeteer browsers install chrome
```

## Usage

```bash
dragoid <command> [options]
```

To view general help:

```bash
dragoid --help
```

To view the installed version:

```bash
dragoid --version
```

## Examples

### Download:

Download a novel and save it in EPUB format:

```bash
dragoid download \
  --mode=novel \
  --url="https://site.com/my-novel" \
  --format=epub
```

Check if the site is supported using:

```bash
dragoid download --list-crawlers
```

List supported output formats:

```bash
dragoid download --list-output-formats
```

Download only a specific chapter of the novel:

```bash
dragoid download \
  --mode=chapter \
  --url="https://site.com/my-novel/cap-10" \
  --format=json
```

For more information about the download command, <a href="./docs/command-download.md">click here</a>.

### Starting the web reader

Starts a local server with a web reader to preview downloaded novel files in `JSON` format.

```bash
dragoid preview \
  --file="./my-novel.json" \
  --public
```

<img src="./docs/reader.png" alt="Reader Preview" />

For more information about the preview command, <a href="./docs/command-preview.md">click here</a>.

## Supported Download Formats

| Type    | JSON | EPUB | TXT |
| ------- | ---- | ---- | --- |
| Novel   | ✅   | ✅   | ✅  |
| Chapter | ✅   | -    | ✅  |