Installation

Install Quick Select in your Obsidian vault

Requirements

Quick Select requires Obsidian v0.15.0 or later and works on desktop and mobile devices.

Method 1: Community Plugins (Recommended)

The easiest way to install Quick Select is through Obsidian’s Community Plugins browser.

1. Open Obsidian Settings

   Click the settings icon (⚙️) in the bottom-left corner or press Cmd/Ctrl + ,

2. Navigate to Community Plugins

   In the settings sidebar, click Community plugins

3. Disable Safe Mode (if needed)

   If safe mode is enabled, click Turn on community plugins to disable it

4. Browse Community Plugins

   Click the Browse button to open the community plugins browser

5. Search for Quick Select

   Search for “Quick Select” in the search bar

6. Install the Plugin

   Click Install on the Quick Select plugin by James Alexandre

7. Enable the Plugin

   After installation completes, click Enable to activate Quick Select

Method 2: Manual Installation

Using BRAT (Beta Reviewers Auto-update Tester)

BRAT is useful for installing beta versions or plugins not yet in the community store.

1. Install BRAT

   First, install the BRAT plugin from the Community Plugins browser

2. Add Quick Select

   Open BRAT settings and click Add Beta Plugin

3. Enter Repository URL

   Paste the repository URL: https://github.com/itsonlyjames/obsidian-quick-select

4. Enable the Plugin

   Go to Settings → Community plugins and enable Quick Select

Manual File Installation

1. Download the Latest Release

   Visit the Quick Select releases page and download the latest main.js and manifest.json files

2. Locate Your Vault

   Open your vault folder in your file system

3. Navigate to Plugins Directory

   Go to .obsidian/plugins/ (create the plugins folder if it doesn’t exist)

4. Create Plugin Folder

   Create a new folder named quick-open inside the plugins directory

5. Copy Files

   Place the downloaded main.js and manifest.json files into the quick-open folder

6. Restart Obsidian

   Close and reopen Obsidian to detect the new plugin

7. Enable the Plugin

   Go to Settings → Community plugins and enable Quick Select

Ensure the folder name matches the plugin ID: quick-open (not quick-select or obsidian-quick-select).

Post-Installation Verification

After installation, verify that Quick Select is working:

1. Open Quick Switcher

   Press Cmd/Ctrl + O to open the Quick Switcher

2. Hold the Modifier Key

   Hold down Cmd (macOS) or Ctrl (Windows/Linux)

3. Check for Numbers

   You should see numbered indicators (1-9) appear next to the first nine items in the list

4. Test Selection

   While holding the modifier key, press a number (1-9) to select that item

If you don’t see the numbered indicators, check that the plugin is enabled in Settings → Community plugins.

Next Steps

Quick Start Guide

Learn how to use Quick Select and customize your settings