Skip to content

keithwithAI/reading-progress

Repository files navigation

Note Reading Progress

An Obsidian plugin that shows the remaining reading time and scroll progress for the current note. Works in both edit mode and reading mode, on desktop and mobile.

Features

  • Remaining reading time updates as you scroll
  • Works in reading (preview) mode, not just edit mode
  • Optional progress percentage
  • Multiple time formats (compact, simple, verbose, digital, default)
  • Configurable reading speed (words per minute)
  • Mobile-friendly out of the box — no CSS snippet required. The plugin ships its own styles.css and shows a styled pill at the bottom of the screen on mobile.
  • Status bar item exposes a .plugin-reading-progress CSS class for users who want to style it further.

Mobile

Obsidian hides the status bar on mobile by default. Note Reading Progress ships a styles.css that makes its own item visible as a pill near the bottom of the screen and (by default) hides the rest of the status bar so the pill stands alone.

Both behaviors are controlled by settings:

  • Show on mobile — show/hide the pill on mobile. Default: on.
  • Hide other status bar items on mobile — hide other plugins' status bar items while the pill is visible. Default: on. Turn off if you also want backlinks, properties, word count, etc. to appear on mobile.

If you want to restyle the pill, add a CSS snippet that targets body.reading-progress-mobile-visible.is-mobile .app-container .status-bar. The plugin's defaults can be overridden the standard way.

Settings

  • Reading speed — words per minute (default 300)
  • Format — how time is displayed
  • Append text — text appended after the time (default "left")
  • Show reading progress percentage — toggle to append (NN%) to the status
  • Show on mobile — see Mobile section above
  • Hide other status bar items on mobile — see Mobile section above

Acknowledgements

This plugin is a fork of Remaining reading time by ununnamed, MIT-licensed. Note Reading Progress adds reading-mode scroll support, a stable CSS class, in-plugin mobile styling, and other improvements.

License

MIT — see LICENSE.

About

Obsidian plugin showing remaining reading time and scroll progress in edit and reading modes

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors