# Note Navigator Plugin **Streamline your note review workflow with enhanced file navigation and deletion features.** ## Table of Contents - [Purpose](#purpose) - [Features](#features) - [Installation](#how-to-install-the-plugin) - [Usage](#using-note-navigator-navigate-and-delete-command) - [Settings](#settings) - [Commands](#commands) - [Screenshots](#screenshots) - [Support and Contributing](#support-and-contributing) ## Purpose The "Note Navigator" plugin simplifies note review by providing file navigation commands and deletion aids. It ensures a focused review process by automatically navigating to the next logical note after deletion, making it ideal for processing temporary notes, "read it later" articles, or any collection of notes requiring cleanup. I developed it to make navigation feel more natural after migrating from OneNote to [Obsidian](https://obsidian.md/) and it is helpful for navigating through notes made by the Obsidian Web Clipper. It may be useful for those with a folder hierarchy based set of notes (instead of heavily linked notes). ## Features ### 1. File Navigation - Navigate to the **next** or **previous** file in the current folder or entire vault. - Keeps track of the current sorting method used in File Explorer, whether by file name, modified date, or creation date, and supports both ascending and descending order. ### 2. File Deletion - Delete the current file and automatically navigate to the next file, overriding Obsidian's default behavior of navigating to the last open file. ### 3. Attachment and Folder Management - Automatically delete **orphaned attachments** (attachments no longer referenced by any note). - Remove **empty folders** after deleting notes or attachments. ### 4. Prompts and Notifications - Optional **Confirmation prompt** before deleting files, with details on affected attachments and folders. - Optional **Notification** for each deleted file. ### 5. Statistics - Track the number of deleted files, folders, and attachments. ### 6. Scroll Past End of Note - **Scroll past the end of the current note**: Scrolls to the end of the note and a bit further, useful when logging content to the tail of a long note. ## Screenshots ### Confirmation Dialog Shows the confirmation prompt before deleting a file with details about affected attachments and folders. ![Confirmation Dialog](img-conf-dialog.png) ### Settings Panel Plugin settings showing navigation scope, deletion behavior, prompts, and statistics options. ![Settings Panel](img-settings-dialog.png) ### Hotkeys Configuration Command palette and hotkey assignment interface for Note Navigator commands. ![Hotkeys Configuration](img-hotkeys-dialog.png) ## How to Install the Plugin ### Option 1: Community Plugin Store (Recommended) 1. Open Obsidian and go to **Settings** → **Community plugins** 2. Click **Browse** and search for "Note Navigator" 3. Click **Install** and then **Enable** ### Option 2: Manual Installation 1. **Download:** Obtain the plugin files (`main.js`, `manifest.json`, `styles.css`) from the [GitHub repository](https://github.com/mudnug/note-navigator) 2. **Create Plugin Folder:** Create a new folder in your Obsidian vault's plugins directory (e.g., `.obsidian/plugins/note-navigator`) 3. **Place Files:** Copy the downloaded plugin files into the newly created folder 4. **Enable Plugin:** Open Obsidian (or reload Obsidian), go to **Settings** → **Community plugins**, and enable **Note Navigator** ## Using Note Navigator "Navigate and Delete" Command 1. **Assign a Hotkey (Recommended):** Go to "Settings" -> "Hotkeys" and search for "note navigator" to see the plugin commands. Assign a hotkey combination to commands you wish to execute (e.g., `Ctrl+Alt+D` or `Cmd+Option+D`). 2. **Configure Settings:** Adjust plugin settings to match your workflow. You may want to show confirmations the first few times you use it, and then once you're comfortable with how it works, you can hide the confirmation prompts. 3. **Open a Note:** Open the note you want to review and potentially delete. 4. **Execute the Command:** Use the assigned hotkey (or the command palette) to execute the "Navigate and Delete" command. 5. **Confirmation (Optional):** If enabled, a dialog box will appear asking you to confirm the deletion. 6. **Navigation:** The current note will be deleted, and the plugin will automatically navigate to the next note based on the selected sort order and scope. ## Settings ### Navigation - **Navigation Scope:** Choose between navigating within the **entire vault** or the **active folder**. ### Deletion Behavior - **Remove Orphan Attachments:** Toggle automatic deletion of unused attachments. - **Remove Empty Folders:** Toggle automatic deletion of empty folders. ### Prompts - **Show Confirmation:** Enable or disable confirmation prompts before deletion. - **Show Notice:** Enable or disable notifications for deleted files. ### Statistics - View counters for deleted files, folders, and attachments. - Reset counters with a single button. ## Commands The plugin provides the following commands, accessible via the command palette or hotkeys: ### File Operations - **Delete current file and navigate to next note** - Deletes the active file and navigates to the next file - **Move current file and navigate to next note** - Opens the move dialog for the current file, then navigates to the next file ### Navigation - **Navigate to next file** - Navigate to the next file in the current folder or vault - **Navigate to previous file** - Navigate to the previous file in the current folder or vault - **Scroll past end of note** - Instantly scrolls to the end of the current note and a bit further (I found Ctrl+End in Obsidian won't scroll to the end of long documents.) ### Utilities - **Rename parent folder of current note** - Opens a dialog to rename the parent folder of the currently active note - **Log debugging messages to console** - Outputs debugging information about sorting and deletion methods --- ## Support and Contributing If you encounter any issues or have suggestions for improvements, please: - Report bugs on the [GitHub Issues](https://github.com/mudnug/note-navigator/issues) page - Contribute code via [GitHub Pull Requests](https://github.com/mudnug/note-navigator/pulls) --- **Note:** The plugin's functionality is triggered only through its commands and does not override Obsidian's default delete behavior.