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.

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.

Default Search

on {your search query}

This is allows you to search OneNote pages using the OneNote API which searches both the content in a page as well as 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.

create new item gif

Note

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

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

2.0.0 Changelog: Massive Refactor and New Features

2.0.0 - 2023-10-05

Added

  • Created custom OneNote parser/library, adding the ability for several new features.
  • Support for section groups when using the notebook explorer.
  • Support for displaying unread results.
  • Support for showing locked sections in results (you still can't see inside them unless they are unlocked).
  • The ability to search by only title.
  • The ability to do a scoped search (e.g. search in one section only).
  • Settings! You can change these options:
    • Show unread icons.
    • Show encrypted sections.
    • Show recycle bin items.
    • Created coloured icons for notebook and sections.
    • Default number of recent pages
    • Customisable keywords!

Changed

  • Compressed images.
  • Reduced the calls to create a OneNote COM object, this should lead to a overall smoother experience.
  • Updated to .NET 7 (update Flow Launcher if an error persists).
  • Refactored majority of code and project structure.

Removed

Acknowledgements

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