Novel Writing Stats — Obsidian Plugin

An Obsidian plugin that adds a beautifully designed sidebar panel for long-form writers. It automatically detects, counts, and sorts all chapter files in your vault.

✨ Features

Feature	Details
📊 Writing Dashboard	Total word count, chapter count, and per-chapter average in a glanceable sidebar
📈 Progress Bars	Overall writing goal progress + per-chapter progress bar for every chapter
🔢 Smart Sorting	Correctly sorts 第一章 → 第二章 → … → 第十章 → 第十一章 (not alphabetically)
🔍 Chapter Search	Instant filter to jump to any chapter
⚡ Live Updates	Automatically refreshes when you save a file — no manual refresh needed
🗂️ Outline Filter	Toggle to include or exclude outline/notes files from the count

⚙️ Installation

This plugin is not yet listed in the official Obsidian Community Plugin store. Install it via one of these methods:

Method 1: BRAT (Recommended — supports auto-updates)

1. Install the BRAT plugin from the Obsidian Community Plugins browser.
2. Go to Settings → BRAT and click Add Beta Plugin.
3. Enter the GitHub URL: https://github.com/tracywong117/obsidian-novel-stats
4. Click Add Plugin — done!

Method 2: Manual Installation

1. Go to the GitHub Releases page and download main.js, manifest.json, and styles.css.
2. Open your Obsidian vault folder on disk.
3. Navigate to .obsidian/plugins/ (create the plugins folder if it doesn't exist).
4. Create a subfolder named obsidian-novel-stats.
5. Place the three downloaded files inside that folder.
6. In Obsidian, go to Settings → Community Plugins, reload, and enable Novel Writing Stats.

🚀 Usage

• Open Panel: Click the ✏️ pencil icon in the left ribbon.
• Command Palette: Press Cmd/Ctrl + P and search for Open Novel Writing Stats.

🔧 Settings

Open Settings → Novel Writing Stats to configure the plugin.