Skip to content

Odotocodot/Flow.Launcher.Plugin.OneNote

Repository files navigation

OneNote for Flow Launcher

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

Contents

Installation

Using Flow Launcher type:

pm install OneNote

Important

For version 2.0+ requires at Flow Launcher version 1.16+. For earlier versions see releases.

Important

This plugin is local only! It requires an installation of OneNote on you system!

Features

At a Glance

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

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

  • New page preview panel ⭐ 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 ⏎ Enter 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.

default search gif

Notebook Explorer

on nb:\

Traverse your OneNote notebooks explorer style.

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

notebook explorer gif

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 Ctrl + ⏎ Enter on a selection will create the item but not open OneNote for quick creation.

create new item gif

Note

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

Create Pages

A preview panel (Default shortcut: F1) 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
Ctrl + S Creates the page in OneNote but does not open OneNote
Ctrl + O Creates the page in OneNote and opens it
Ctrl + ⇥ Tab Traverse to next textbox/button
Ctrl + ⇧ Shift + ⇥ Tab Traverse to previous textbox/button

Note

The traversal shortcuts work for Flow Launcher as a whole for navigating results.

create new quick note gif

create pages gif

Recent Pages

on rcntpgs:

Displays your recently modified OneNote pages.

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

recent pages gif

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.

scoped search gif

Example Queries

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

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.

title search gif title search gif

Example Queries

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

Settings

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

Screenshot of settings settings

Keywords

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

Screenshot of keywords keywords

Changelog

See here for the full list of changes.

Acknowledgements

  • Made with Linq2OneNote a library for exposing the OneNote API also made by me 😃
  • Inspired by the OneNote plugin for PowerToys