Obsidian Stats logoObsidian Stats

Zone Scroll Zoom

by kqint
5
4
3
2
1
New Plugin
Install Code

Description

Zoom where your mouse is — font in editor, interface elsewhere. - This plugin has not been manually reviewed by Obsidian staff.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Obsidian Zone Scroll Zoom

简体中文 | 繁體中文 | English

An Obsidian plugin that scales the interface and font with keyboard shortcuts, where the zoom behavior adapts to your mouse position.

Demo

Features

  • Shortcut Zoom: Use keyboard shortcuts to zoom in different areas (default: Ctrl + Scroll Wheel).
  • Zone-Based Zooming:
    • Mouse in Editor Area: Zooms the editor font size.
    • Mouse in Non-Editor Area: Zooms the entire Obsidian interface (including sidebar, menus).
  • Real-time Status Display: A clean OSD indicator appears at the top of the screen, showing the current scale/font size in real time.
  • Customizable Settings: Adjust zoom precision in settings, modify shortcuts (supports Ctrl/Cmd, Shift, Alt). Personal settings are automatically saved to data.json.
  • Multi-language Support: Supports English, Simplified Chinese, and Traditional Chinese. Switch languages in settings or follow Obsidian's system language.
  • Reset Zoom Ratio: A button in the settings page to quickly restore default font size (16px) or interface scale (100%).

[!note] Before using this plugin, go to Settings → Appearance and disable "Quick font size adjustment".

Installation

Community Plugin Marketplace

Open Obsidian Settings → Community Plugins → Browse, search "Zone Scroll Zoom", install and enable.

Or visit the plugin page and click "Add to Obsidian".

BRAT Installation
  1. Install BRAT.
  2. Open BRAT settings → Add Beta Plugin.
  3. Enter repository: kqint/obsidian-zone-scroll-zoom.
Manual Installation
  1. Download main.js and manifest.json from releases/latest.
  2. Create an obsidian-zone-scroll-zoom folder inside .obsidian/plugins/, and place main.js and manifest.json into this folder.
  3. Enable the plugin in Obsidian settings.

Internationalization

Language source files are located in src/locales/:

  • src/locales/en.json
  • src/locales/zh-CN.json
  • src/locales/zh-TW.json

Adding a New Language

  1. Copy src/locales/en.json to src/locales/xx.json and translate all string values (keep the keys as-is).
  2. In src/i18n.ts, register your locale by adding:
    • An import for your JSON file
    • An entry in BUILT_IN_LOCALES
    • Obsidian language code mappings in OBSIDIAN_LANG_MAP
    • Locale metadata in LOCALE_META
  3. Add the locale option name to all existing locale files under settings.language.options.
  4. Run npm run build and test.

See CONTRIBUTING.md for the detailed step-by-step guide.

License

MIT License

Sponsors