Flow.Launcher.Plugin.OneNote

<p align="center"> <a href="https://flowlauncher.com"> <img src="doc/flow.png" width=12.5%> </a> <a href="https://www.microsoft.com/en-gb/microsoft-365/onenote/digital-note-taking-app"> <img src= "doc/onenote.png" width=12.5%> </a> </p> <h1 align="center">OneNote for Flow Launcher</h1> <div align="center">

</div>

A OneNote plugin for Flow Launcher, allowing for the ability to quickly access and create notes.

<!-- omit from toc -->

Contents

• Installation
• Features
  • At a Glance
  • New with Version 2.1.0
  • Default Search
  • Notebook Explorer
    • Create New Items
  • Recent Pages
  • Scoped Search
  • Title Search
• Settings
  • Keywords
• Changelog
• Additional Information
• Acknowledgements

Installation

Using Flow Launcher type:

pm install OneNote

[!IMPORTANT]

• Versions 2.0+ requires Flow Launcher version 1.16+. For earlier versions see releases.
• Versions 3.0+ requires Flow Launcher version 2.1+.
• This plugin is local only! It requires an installation of OneNote on you system!
• Some features require Windows/Microsoft Search to be enabled on your system. See more info here.

Features

At a Glance

| Keyword | Name | Description | | -------------------------- | --------------------------------------- | ---------------------------- | | on {your search query} | Default Search | Search OneNote pages | | on nb:\ | Notebook Explorer | Navigate notebooks hierarchy | | on rp: | Recent Pages | View recently modified pages |

<!-- omit from toc -->

Modifiers

| Keyword | Name | Notes | | ------- | ------------------------------- | -------------------------------------------- | | > | Scoped Search | Search only within a specific hierarchy item | | * | Title Search | Search only the title of hierarchy items |

[!NOTE] Hierarchy items are notebooks, section groups, sections and pages.

New with Version 2.1.0

• :star: New page preview panel :star: for quickly creating pages with text!
• Added icons for different themes. The themes available are color, light, dark and one that matches Flow Launcher's current theme. Change it in the settings!

Default Search

on {your search query}

This allows you to search OneNote pages using the OneNote API which searches both the content in a page and the page title.

• Press <kbd>⏎ Enter</kbd> or left-click on a search result to open in OneNote.

[!NOTE] You can include bitwise operators like AND or OR (they must be uppercase) in your search. E.g. on hello there AND general kenobi.

Notebook Explorer

on nb:\

Traverse your OneNote notebooks explorer style.

• Press <kbd>⏎ Enter</kbd> or <kbd>⇥ Tab</kbd> or left-click on a result to auto complete the query.
• Press <kbd>⇧ Shift</kbd> + <kbd>⏎ Enter</kbd> or right-click on a result to open it directly in OneNote.

[!NOTE] Supports all OneNote hierarchy items i.e. notebooks, section groups, sections and pages.

Create New Items

Whilst using the notebook explorer, if your search query does not match any names of the items in the results, the plugin will give you an option to create a new item.

Pressing <kbd>Ctrl</kbd> + <kbd>⏎ Enter</kbd> on a selection will create the item but not open OneNote for quick creation.

[!NOTE] Supports creation of all OneNote hierarchy items i.e. notebooks, section groups, sections and pages.

Create Pages

A preview panel (Default shortcut: <kbd>F1</kbd>) allows for quick page creation with text content. No longer do you need to open OneNote to add text to a page!

This preview panel is available on all create a page results in the plugin and has the shortcuts listed below:

| Shortcut | Preview Panel Action | | ------------------------------------------------------- | --------------------------------------------------------- | | <kbd>Ctrl</kbd> + <kbd>S</kbd> | Creates the page in OneNote but does not open OneNote | | <kbd>Ctrl</kbd> + <kbd>O</kbd> | Creates the page in OneNote and opens it | | <kbd>Ctrl</kbd> + <kbd>⇥ Tab</kbd> | Traverse to next textbox/button | | <kbd>Ctrl</kbd> + <kbd>⇧ Shift</kbd> + <kbd>⇥ Tab</kbd> | Traverse to previous textbox/button |

[!NOTE] The traversal shortcuts work for Flow Launcher as a whole for navigating results.

Recent Pages

on rp:

Displays your recently modified OneNote pages.

Add a number after rp: to display that number of recent pages. E.g. the full query on rp:10 will show the 10 most recently modified pages.

Scoped Search

on nb:\{hierarchy path}\>{your search query}

Scoped search is the same as default search but restricted to search within a specific hierarchy item.

[!IMPORTANT] Must be used with notebook explorer.

<details> <summary><h4>Example Queries</h4></summary>

on nb:\A Notebook\A Section Group\>hello there

Will use the OneNote API to search the hierarchy item A Section Group for hello there

</details>

Title Search

on *{your search query}

Searches for hierarchy items based on their title alone. Unlike scoped search and default search which only return pages, title search can return all hierarchy item types.

[!NOTE] Can be used in conjunction with notebook explorer.

[!NOTE] Does not rely on the OneNote Search API (uses Flow Launcher's internal search), thus bitwise operators do not work.

<details> <summary><h4>Example Queries</h4></summary>

on nb:\A Notebook\A Section Group\*hello there

Will search for titles in the hierarchy item A Section Group that match or are similar to hello there

</details>

Settings

The plugin has a number of settings such as the ability to hide the recycle bin or indicate which pages have unread changes.

<details> <summary>Screenshot of settings</summary> <img src= "doc/settings.png" width="100%" alt="settings"> </details>

Keywords

All the keywords used can be changed according to user preference.

<details> <summary>Screenshot of keywords</summary> <img src= "doc/keywords.png" width="100%" alt="keywords"> </details>

Changelog

See here for the full list of changes.

Additional Information

In order to use default and scoped Windows/Microsoft Search must be enabled on your system. This is due to the API that these features rely on, requiring Windows Search. This will only be an issue if you have explicit turned off Windows Search. Other features should work as intended.

Acknowledgements

• Made with LinqToOneNote a library for exposing the OneNote API also made by me :smiley:
• Inspired by the OneNote plugin for PowerToys