README file from
GithubObsidian Ribbon Hider
An Obsidian plugin that lets you declutter your workspace by hiding ribbon buttons (on the left sidebar) with a simple right-click.
Created by Lucy Roh.
If you liked it,
Requirements
Obsidian 1.13.0 or later, on desktop or mobile.
Features
- Right-Click to Hide: Simply right-click on any ribbon button — or touch and hold it on mobile — and select
Hide "[Button Name]"to hide it immediately. - Settings Dashboard: A dedicated settings tab listing all active ribbon buttons, allowing you to easily toggle them back on.
- Unhide All: A single button to restore all hidden ribbon items instantly.
- Orphan Cleanups: Automatically tracks hidden buttons from disabled or removed plugins, allowing you to clean them up from settings.
- Lightweight: Uses clean, non-intrusive CSS styling to toggle button visibility, leaving the underlying DOM intact and fully compatible with other plugins.
Installation
Manual Installation
- Go to the Releases page and download the latest release files:
main.jsmanifest.jsonstyles.css
- Create a folder named
ribbon-hiderinside your vault's plugins folder:<your-vault>/.obsidian/plugins/ribbon-hider/. - Move the downloaded files into that folder.
- Open Obsidian and navigate to Settings > Community plugins. Click the refresh button, then toggle the switch next to Ribbon Hider to enable it.
Development
If you'd like to build the plugin from source or contribute to its development, follow these steps:
Setup
- Clone this repository.
- Install dependencies:
npm install
Build Scripts
- Development Build (with watch mode):
npm run dev - Production Build:
npm run build
License
This project is licensed under the MIT License.