Obsidian Stats logoObsidian Stats

Tab Numbers

by Jordan Duabe
5
4
3
2
1
Score: 50/100
Install Code

Description

Displays numbered badges on Obsidian tabs when Ctrl or Cmd is held.

Reviews

  • Jordan Long
    Reviewed on Aug 19th, 2026
    Very useful. Like the circle + number implementation.

Stats

4
stars
266
downloads
0
forks
23
days
23
days
23
days
2
total PRs
0
open PRs
0
closed PRs
2
merged PRs
0
total issues
0
open issues
0
closed issues
20
commits

Latest Version

0.1.6
24 days ago

Changelog

  • Bump minAppVersion to 1.13.0, the version that introduced the getSettingDefinitions()/setControlValue() APIs already used in Settings.ts, resolving an obsidianmd/no-unsupported-api finding.
  • Remove the pre-1.13.0 display() method entirely; SettingTab.display() already has a concrete, deprecated-but-optional default implementation once getSettingDefinitions() is implemented, so nothing needs to override it.
  • Use createDiv() instead of createEl("div", ...) per obsidianmd/prefer-create-el.
See all version on GitHub

README file from

Github

Tab Numbers

Obsidian Tab Numbers logo

Displays numbered badges (1-8) on Obsidian tabs when Ctrl or Cmd is held. This plugin complements the default Obsidian keyboard shortcuts for switching tabs (Ctrl/Cmd 1-8, 9 selects the last tab) by adding tab number 'hints'. When working with split panes, each split will have its own tab sequence and tab numbers will only be displayed on the currently active (split) pane.

Screenshots

Obsidian window with 3 open tabs showing tab numbers

Customization

The badge text and background color can be customized via the plugin settings.

  • Badge text color: Customize the tab number color (default: black #000000)
  • Badge background color: Customize the badge background (default: purple #a882ff)

Installation

Manual installation is currently the only supported method.

  1. Download the plugin files from the latest release on GitHub

    • Download the main.js, manifest.json, and styles.css files.

  2. Copy files to your vault's plugin directory:

    • Copy main.js, manifest.json, and styles.css to: 
      /path/to/your/vault/.obsidian/plugins/tab-numbers/

  3. Reload Obsidian:

    • Open Developer Console: Ctrl/Cmd + Shift + I
    • Run: app.commands.executeCommandById('app:reload')
    • Or restart Obsidian

  4. Enable the plugin:

    • Go to Settings → Community plugins
    • Find "Tab Numbers" and enable the plugin

Development

Setup

# Install dependencies
pnpm install

# Start development build (watch mode)
pnpm run dev

# Production build
pnpm run build

Testing

To test the plugin during development:

  1. Build the plugin:

    pnpm run build

  2. Copy files to your test vault:

    • Copy main.js, manifest.json, and styles.css to: 
      /path/to/your/vault/.obsidian/plugins/tab-numbers/

  3. Reload Obsidian:

    • Open Developer Console: Ctrl/Cmd + Shift + I
    • Run: app.commands.executeCommandById('app:reload')
    • Or restart Obsidian

  4. Enable the plugin:

    • Go to Settings → Community plugins
    • Find "Tab Numbers" and enable the plugin
Sponsors