Skip to content

Commit

Permalink
pushing 2.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
kevin-funderburg committed Dec 19, 2020
1 parent 0dcd42f commit 8548afe
Show file tree
Hide file tree
Showing 10 changed files with 95 additions and 327 deletions.
66 changes: 34 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# Navigate OneNote Notebooks With Alfred

Search or browse any notebook/section group/section in Microsoft OneNote from [Alfred 4][alfredapp].
Search or browse any notebook,section group,section or page in Microsoft OneNote from [Alfred][alfredapp].
* * *
![](./imgs/demo.gif)
![demo](./imgs/demo.gif)
* * *
<!-- MarkdownTOC autolink="true" bracket="round" depth="3" autoanchor="true" -->

- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [Licensing & thanks](#licensing--thanks)
- [Changelog](#changelog)
- [Navigate OneNote Notebooks With Alfred](#navigate-onenote-notebooks-with-alfred)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [Licensing & thanks](#licensing--thanks)
- [Changelog](#changelog)

<!-- /MarkdownTOC -->

<a id="features"></a>
## Features

- Search or browse all OneNote Notebooks and sections/section groups
- Search or browse all OneNote Notebooks/section groups/sections/pages.
- **When searching**:
- Press <kbd>↩︎</kbd> to either open the selected item in OneNote or browse the selection.
- **When browsing**:
Expand All @@ -29,54 +29,56 @@ Search or browse any notebook/section group/section in Microsoft OneNote from [A

Download [the latest release][gh-releases] and double-click the file to install in Alfred.

<a id="usage"></a>
## Usage

The two main keywords are `;so` & `;bo`:
The main keywords are `1a`, `1b`, `1r` & `1m`:

- `;so [<query>]` - Search all notebooks/section groups/sections
- `1a [<query>]` - Search all notebooks/section groups/sections/pages and retain memory for intelligent order.
- <kbd>↩︎</kbd> or <kbd>⌘</kbd><kbd>NUM</kbd> — If the selection is a page (i.e. has no children), then open selection in OneNote; otherwise browse selection in Alfred.
- <kbd>⌘</kbd><kbd>↩︎</kbd> — Open selection in OneNote instead of browse.

- <kbd>↩︎</kbd> or <kbd>⌘</kbd><kbd>NUM</kbd> — If the selection is a section with no subsections, then open selection in OneNote; otherwise browse selection in Alfred.
- <kbd>⌘</kbd><kbd>↩︎</kbd> — Open selection in OneNote instead of browse.
- `1b [<query>]` — Browse OneNote from top level Notebooks in Alfred.
- <kbd>↩︎</kbd> or <kbd>⌘</kbd><kbd>NUM</kbd> — View the selections sub-sections, if it has no sub-sections (deepest level of notebook) it will open the page in OneNote.
- <kbd>⌘</kbd><kbd>↩︎</kbd> — Open selection in OneNote instead.

- `;bo [<query>]`Browse OneNote from top level Notebooks in Alfred.
- <kbd>↩︎</kbd> or <kbd>⌘</kbd><kbd>NUM</kbd> — View the selections sub-sections, if it has no sub-sections (deepest level of notebook) it will open the page in OneNote.
- <kbd>⌘</kbd><kbd>↩︎</kbd> — Open selection in OneNote instead.
- `1r [<query>]`Search recent OneNote items.
- <kbd>↩︎</kbd> or <kbd>⌘</kbd><kbd>NUM</kbd> — If the selection is a page (i.e. has no children), then open selection in OneNote; otherwise browse selection in Alfred.
- <kbd>⌘</kbd><kbd>↩︎</kbd> — Open selection in OneNote instead of browse.

Base url is stored with `seturl`:
- `1m [<query>]` — Search recently modified OneNote items.
- <kbd>↩︎</kbd> or <kbd>⌘</kbd><kbd>NUM</kbd> — If the selection is a page (i.e. has no children), then open selection in OneNote; otherwise browse selection in Alfred.
- <kbd>⌘</kbd><kbd>↩︎</kbd> — Open selection in OneNote instead of browse.

<a id="configuration"></a>
### Configuration
- `1u` — Update stored OneNote data.

The workflow locates a plist file that contains the names of the notebooks, sections and pages, and then uses those to build a URL that OneNote can respond to. The base of the URL, however, is unique to each machine and cannot be found within the plist. So in order for this workflow to work
1. Open OneNote, right click a notebook, section, or page and click the `Copy Link to {Page/Notebook/Section}`.
2. Use the `seturl` keyword and paste the copied link and press <kbd>↩︎</kbd>. After the base url is stored, the workflow should be functional.
- **_NOTE:_** If your notebook is stored on Microsoft Sharepoint, the URL that's created _cannot be opened locally_, the notebook must be stored in OneDrive for the URL to valid.
- View the gif below to see this in action.
## Configuration

![](./imgs/seturldemo.gif)
The workflow locates a database for each notebook stored and uses them to perform searches and build a URL that OneNote can respond to. The first search may be slower than expected but afterwards it should speed up.

**_NOTE:_** Previous versions of this workflow did not get along with users whose notebooks were stored on Microsoft Sharepoint, I think this new version should work for it, but as mine are not stored on sharepoint, I can't test. If yours are stored on sharepoint and they still don't work, let me know.

<a id="licensing--thanks"></a>
## Licensing & thanks

This workflow is released under the [MIT Licence][mit].

This workflow uses on the wonderful library [alfred-workflow](https://github.com/deanishe/alfred-workflow) by [@deanishe](https://github.com/deanishe).

<a id="changelog"></a>
## Changelog

- v1.0.0 — 06/14/19
- First public release
- First public release
- v1.2.0 - 06/19/19
- Fixed storage of base url
- Fixed storage of base url
- v1.2.2 - 10/14/19
- Added trap for sharepoint URLs
- Added trap for sharepoint URLs
- v1.3.0 - 02/23/20
- Added search all functionality
- v1.3.1 - 02/25/20
- Added ability to browse a selection after searching all.
- Improved code logic and added new keywords.
- v2.0.0 - 12/18/20
- found databases which allowed to search/open every notebook item (including pages)
- changed script altogether in order to adapt

[alfredapp]: https://www.alfredapp.com/
[gh-releases]: https://github.com/kevin-funderburg/alfred-microsoft-onenote-navigator/releases/latest
Expand Down
Loading

0 comments on commit 8548afe

Please sign in to comment.