- Overview
- Scorecard
- Updates7
A distraction-free writing suite for Obsidian: zen mode, typewriter scrolling, letterbox masks, and a retro status bar — each independent, each toggled on its own.
Showcase
Features
Zen mode Hides UI chrome (tabs, ribbons, properties, native status bar, etc.), collapses sidebars, and can enter fullscreen. Optional focused-file mode hides every other pane. An on-screen exit button can be shown always, mobile-only, or never, with an auto-hide-on-hover option for desktop.
Typewriter mode Keeps the cursor line vertically centered as you type — works with or without zen mode active.
Letterbox masks Top and bottom masks frame the writing area, with adjustable height, horizontal inset, arrow style (triangles, chevrons, ASCII, or custom characters), and separator line style/weight/color. Drag the separator line to resize the mask; drag the arrow row to adjust the horizontal inset — both live, right in the editor.
Retro status bar A fixed bar at the bottom of the screen, sized to match the open note (not the full window), with a fully custom format string using tokens:
| Token | Shows |
|---|---|
{file} |
Current file path |
{words} |
Word count (selection count if text is selected) |
{chars} |
Character count (selection count if text is selected) |
{time} |
Current time |
{date} |
Current date (customizable format) |
{battery} |
Battery level |
{paragraph} |
Current paragraph / total paragraphs |
{goal} |
Writing goal progress (fraction or fill-bar) |
Click the bar to reset your word-goal baseline. Optional flash animation when the goal is met. Separate dark/light color pickers for the bar, arrows, and separator line.
Text options Optional paragraph indent (triggered by a blank line or every new line) and adjustable line spacing.
Word counts Optional per-file word counts in the file explorer (summed into folders) and per-heading word counts in the outline panel.
Commands
- Word-Smith: Toggle Word-Smith on/off — master switch for the whole plugin
- Word-Smith: Zen mode — toggles zen mode only
Installation
- Download
main.js,styles.css, andmanifest.json(or clone this repo). - Create a folder named
word-smithinside your vault's.obsidian/plugins/directory. - Copy the files into that folder.
- Reload Obsidian (or restart it), then enable Cursor-Smith under Settings → Community plugins.
Feedback
Found a bug or have an idea? Open an issue!
Pricing
Word-Smith is 100% free. If you’d like to support the project and help me keep the updates coming, you’re more than welcome to buy me a coffee. Your support means the world. Cheers!
License
MIT