✍️ WebNovel Assistant

English | 中文

An all-in-one writing studio for novel and story writers in Obsidian.
Accurate word count & goal tracking · Story timeline · Foreshadowing manager · Chapter corkboard · Lore graphs & focus timers.

📖 User Guide 🎥 OBS CSS Guide 📋 Changelog

✨ Feature Highlights

🏠 Creative Homepage

Full-width Dashboard · Dynamic Welcome · Novel Overview · Stats Panel · One-Click New Novel & Import Novel

🗂️ Writing Workbench

All Chapters Panel · Timeline Board · Foreshadowing Board · Lore Board · Task Board · Notes Management

🌑 Immersive Writing Mode

Full-screen Focus · Typewriter Scroll & Line Dimming · Dynamic Dashboard · Slot-based Layout

📊 Word Count & Goals

3 Counting Modes · Multi-direction Goal Tracking · Strict Chapter Mode · Smart Chapter Sorting · Real-time Word Reminder · Folder Word Count Display

⏱️ Focus Time Tracking

Auto focus vs. slack detection · Web Worker · 365 Heatmap · Bar+line trend · Efficiency card

📝 Creative Assistants

🎥 OBS Streaming Overlay & 📱 Mobile

🎥 OBS Overlay	📱 Mobile
Real-time writing stats in OBS	Floating word count & focus timer widget
Custom style, opacity & content	Edge docking & auto-collapse handle
Zero latency, zero disk I/O	Copy Document — one-click with title prepended

📥 Installation

Method	Steps
Community Plugins (Recommended)	Settings → Community Plugins → Browse → Search "WebNovel Assistant" → Install → Enable
BRAT	Install BRAT → Add repo `HatanoChihiro/obsidian-webnovel-assistant` → Enable
Manual	Download → Extract to `.obsidian/plugins/web-novel-assistant/` → Restart & Enable

🚀 Quick Start

Install → open any Markdown file
Status bar shows live word count → click to set a goal
Command Palette Ctrl/Cmd+P → search "WebNovel"
Settings → customize each feature

Command	Description
Toggle Immersive Writing Mode	Full-screen distraction-free writing
Toggle Writing Status Panel	Detailed stats & history charts
Toggle Foreshadowing Panel	Manage foreshadowing & recovery
Toggle Timeline Panel	Manage story timeline
Toggle Writing Workbench View	Chapters, timeline, lore, task and notes boards
Open Chapter Overview	Card-style chapter overview
Start/Pause Focus Time Tracking	Toggle focus/slack tracking
Mark as Foreshadowing	Mark selected text as foreshadowing
Create Blank Sticky Note	New floating sticky note
Advanced Search	Search by book/global/custom scope
Create Next Chapter (Smart Increment)	Smart chapter numbering
Rebuild Lore Cache	Rebuild lore entries and chapter reference statistics
Reset Stream Statistics	Clear current session data

All commands can get custom shortcuts in Settings → Hotkeys

Need setup details or troubleshooting? See the full User Guide / 使用指南.

Setting	Default	Description
Language	Auto	UI language — auto-detects Obsidian locale
Default Chapter Goal	3000	Chapter word goal for new files
Daily Goal	5000	Daily writing target
File Explorer Word Count	Off	Folder word counts in sidebar
Smart Chapter Sorting	Off	Auto-sort by chapter numbers
Eye Care Mode	Off	Warm background color
Immersive Note Size	280px	Sticky note card size in immersive mode
Foreshadowing Filename	`Foreshadowing`	Customizable per workspace
Timeline Filename	`Timeline`	Customizable per workspace
Timed Task Filename	`Timed Task`	Customizable per workspace
Lore Folder Name	`Lore`	Supports dictionary outline mode
Word Count Mode	Webnovel	Webnovel / Standard / Native algorithm

Plugin settings → Enable OBS Overlay
OBS → Add Browser Source → URL http://127.0.0.1:24816/
Recommended: 300×500px

See OBS Overlay CSS Guide for full customization.

📄 License & 💖 Support

MIT License

⭐ Star · 🐛 Issues · 💡 Feature Requests

If this plugin helps with your writing, consider buying the author a coffee ☕. Your support is the greatest motivation for continuous updates!

Happy writing! ✍️