Socket
Socket
Sign inDemoInstall

joplin-plugin-personalizedrefrigerator-favorites

Package Overview
Dependencies
0
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    joplin-plugin-personalizedrefrigerator-favorites

Save any notebook, note, to-do, tag, or search as favorite in an extra panel view for quick access.


Version published
Maintainers
1
Created

Changelog

Source

[1.3.1] - 2023-11-14

Fixed

  • Use readOnly instead of disabled inputs as entries in the favorites sidebar. This fixes clicking on favorited items in Electron 26 (Joplin 2.13.5).

Changed

  • (Internal) Updated plugin API

Readme

Source

Joplin Favorites

[!NOTE]

This plugin is a fork of the original plugin, maintained at https://github.com/benji300/joplin-favorites/. At present, it is intended to fix an incompatibility with Electron 26 (Chromium 116). See the relevant bug report.

Favorites is a plugin to extend the UX and UI of Joplin's desktop application.

It allows to save any notebook, note, to-do, tag, or search as favorite in an extra panel view for quick access.

[!WARNING] CAUTION - Requires Joplin v2.1.5 or newer

Features

  • Save any of the following item types as favorites
    • Notebook
    • Note, To-do
    • Tag
    • Search
      • Not fully supported right now - see here for details
  • Set and edit user defined names for the favorites
  • Right-click on favorites to open edit dialog
  • Change position of favorites within the panel via drag & drop
  • Drag notebooks and notes from sidebar or note list directly to favorites
  • Configurable style attributes
  • Support horizontal and vertical layout
  • Toggle panel visibility

Screenshots

Favorites above note content

favorites-top-horizontal

Favorites in sidebar (vertical layout)

favorites-sidebar-vertical

NOTE - The used UI theme on this screenshot can be downloaded here.

Installation

Automatic (Joplin v1.6.4 and newer)

  • Open Joplin and navigate to Tools > Options > Plugins
  • Search for the plugin name and press install
  • Restart Joplin to enable the plugin
  • By default the panel will appear on the right side of the screen, see how to place the panel

Manual

  • Download the latest released JPL package (*.jpl) from here
  • Open Joplin and navigate to Tools > Options > Plugins
  • Press Install plugin and select the previously downloaded jpl file
  • Confirm selection
  • Restart Joplin to enable the plugin
  • By default the panel will appear on the right side of the screen, see how to place the panel

Uninstall

  • Open Joplin and navigate to Tools > Options > Plugins
  • Search for the plugin name and press Delete to remove the plugin completely
    • Alternatively you can also disable the plugin by clicking on the toggle button
  • Restart Joplin

Usage

Place the panel

By default the panel will be on the right side of the screen, this can be adjusted by:

  • View > Change application layout
  • Use the arrow keys (the displayed ones, not keyboard keys) to move the panel at the desired position
  • Move the splitter to reach the desired height/width of the panel
    • As soon as the width of the panel goes below 400px, it automatically switches from horizontal to vertical layout
  • Press ESC to save the layout and return to normal mode

Add favorite

  • To add a new favorite to the panel, you have to trigger the corresponding command

    • In the table you can see from which menu context the commands can be triggered
  • Selected notebooks, notes or to-dos can also be added via drag & drop into the panel

    • This will add new favorites at the dropped position
  • The Edit favorite before add option lets you choose whether or not to edit the name before adding a new favorite

    • This is not supported when adding multiple selected notes
    • For searches the dialog is always opened to enter the search query

    add-dialog

Edit favorite

  • Right click on one of the favorites to open the edit dialog

    edit-dialog

  • For searches, you can also edit the search query in the dialog

    edit-search-dialog

  • Rename favorite by clicking the rename icon on the right side in the vertical layout

Remove favorite

  • Right click on a favorite to open the edit dialog (see screenshots above) and press Delete to remove it

  • Remove favorite by clicking the delete icon on the right side in the vertical layout

  • Remove all favorites at once via the Remove all Favorites command

Currently favorites for searches are not fully supported. Due to restrictions of the App it is not possible to open the global search with a handled search query. To open a saved search follow this workaround:

  • Save your search via the Add search to Favorites command
  • You can enter a name and the search query in the dialog
  • Click on the search favorite to copy its query to the clipboard
  • This will also set the focus to the global search bar
  • Paste the clipboard content to the search bar and press Enter

Match with sidebar look

If you placed the favorites panel in the sidebar above or below the notebooks and tags (as shown here), you may also want to customize the look of this panel to match the sidebar. To do this, you can apply the following settings in the plugin advanced options. This will make the panel look the same as the actual sidebar, regardless of the app theme. Just copy and paste the following values:

  • Background color: var(--joplin-background-color2)
  • Hover background color: var(--joplin-background-hover)
  • Foreground color: var(--joplin-color2)
  • Divider color: var(--joplin-background-color2)

Then you're settings should look like:

favorites-top-horizontal

:warning: CAUTION - After changing the style of the favorites panel as described above, a small white border will appear below the panel. It is created by the App, not the plugin. Pleas see here for details.

Commands

This plugin provides additional commands as described in the following table.

Command LabelCommand IDDescriptionMenu contexts
Add notebook to FavoritesfavsAddFolderAdd favorite for selected notebookTools>Favorites, FolderContext, Command palette
Add note to FavoritesfavsAddNoteAdd favorite for selected note(s)Tools>Favorites, NoteListContext, EditorContext, Command palette
Add tag to FavoritesfavsAddTagAdd favorite for selected tagTagContext
Add search to FavoritesfavsAddSearchAdd favorite with entered search queryTools>Favorites, Command palette
Remove all FavoritesfavsClearRemove all favoritesTools>Favorites, Command palette
Toggle Favorites panel visibilityfavsToggleVisibilityToggle panel visibilityTools>Favorites, Command palette

Keyboard shortcuts

Keyboard shortcuts can be assigned in user options via Tools > Options > Keyboard Shortcuts to all commands which are assigned to the Tools>Favorites menu context. In the keyboard shortcut editor, search for the command label where shortcuts shall be added.

User options

This plugin adds provides user options which can be changed via Tools > Options > Favorites (Windows App).

NOTE - If default is set for an advanced style setting, the corresponding default color, font family, etc. will be used to match the common App look.

NOTE - In case color settings shall be overwritten, they must be specified as valid CSS attribute values, e.g. #ffffff, rgb(255,255,255), etc.

Feedback

  • :question: Need help?
  • :bulb: An idea to improve or enhance the plugin?
  • :bug: Found a bug?
    • Check the Forum if anyone else already reported the same issue. Otherwise report it by yourself.

Support

You like this plugin as much as I do and it improves your daily work with Joplin?

Then I would be very happy if you buy me a :beer: or :coffee: via PayPal :wink:

Contributing

Contributions to this plugin are most welcome. Feel free to open a pull request or an issue. Make sure to use conventional commit messages if you're creating a pull request.

Development

The npm package of the plugin can be found here.

Building the plugin

If you want to build the plugin by your own simply run npm run dist.

Updating the plugin framework

To update the plugin framework, run npm run update.

Changes

See CHANGELOG for details.

License

Copyright (c) 2021 Benjamin Seifert

MIT License. See LICENSE for more information.

Keywords

FAQs

Last updated on 14 Nov 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc