# Dialogue Stats for Obsidian

Word count and dialogue percentage for the note you are writing, in the status bar.

```
Words: 1,694  |  Dialogue: 34%
```

![Status bar showing Words and Dialogue percent](media/status-bar-preview.png)

The dialogue number changes color. Low, target, and high each get a color you choose.

## Settings

Settings → Community plugins → Dialogue Stats. You get:

- A live preview of the status bar for the current note
- Two sliders for the low and high thresholds
- Three native color pickers
- A toggle to show or hide the status bar item
- A reset button

Every change saves at once.

![Settings tab with sliders and color pickers](media/settings-preview.png)

## Mobile

Obsidian mobile has no status bar. Use the command **Dialogue Stats: Show stats for current note**. It shows the numbers in a notice.

## How it counts

- YAML front matter at the top of the note is skipped.
- Markdown headings and horizontal rules are skipped.
- Dialogue is any text between double quotes. Straight `"` and curly `“ ”` both count.
- Words are split on whitespace.
- Dialogue % = dialogue words ÷ all body words, rounded to the nearest whole percent.

Em-dash dialogue with no quotation marks is not counted. Quoted signs, letters, and thoughts are counted.

The counting core is shared with the Dialogue Stats VS Code extension. Same file, same numbers, in both apps.

## Install by hand

1. Build: `npm install && npm run build`
2. Copy `main.js`, `manifest.json`, and `styles.css` into `<vault>/.obsidian/plugins/dialogue-stats/`
3. Reload Obsidian and enable the plugin under Community plugins.

## Development

```
npm install
npm run dev     # watch build
npm test        # unit tests for the counting core
npm run build   # production build
```

## Starter vault

A ready-made vault with the plugin installed, sample chapters, and a walkthrough is kept alongside this repo during development. After any change, `npm run install:vault` rebuilds and copies `main.js`, `manifest.json`, and `styles.css` into it. The script expects the vault at `../basic-obsidian-vault`.

## License

MIT. See `LICENSE`.