A cross-browser webextension for Nextcloud Bookmarks
Clone or download
Latest commit 6a7f0f8 May 17, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
screenshots added Chrome Webstore required files and Privacy Policy file Jan 13, 2017
src Chrome can not take svg icons May 17, 2018
.gitignore deleted test key May 17, 2018
LICENSE Initial commit Jan 13, 2017
README.md fixes #5 May 16, 2018
privacy_policy.md Minor adjustments to README and privacy_policy Jan 13, 2017

README.md

Browser extension for NextCloud Bookmarks

This is a cross-browser extension for NextCloud Bookmarks, a very popular bookmark application for NextCloud.

It allows you to add, search and delete your NextCloud Bookmarks.

This extension does not synchronize your browser bookmarks with NextCloud Bookmarks and it will never perform any kind of synchronization between the browser and NextCloud.

It has been tested on Firefox and Chrome but it should work also on Opera, Safari and Microsoft Edge.

Note: this extension doesn't work on OwnCloud but you can fork this repo and modify the code accordingly

Available features

  • it adds new bookmarks
  • it lists latest bookmarks
  • it searches for text among the bookmarks' title and description
  • it searches bookmarks by tag or by a tags combination (like 'tag1 AND tag2 AND tag3' and 'tag1 OR tag2 OR tag3')
  • it deletes a bookmark
  • you can choose if you want to display first the bookmark form or the search form

Missing features

  • it can not search for a bookmark starting from a URL (API lacks the method)
  • it can not retrieve the list of already set tags (API lacks the method)
  • it does not edit a bookmark
  • it lacks a translation (localization) system
  • it lacks translations

Disclaimer

This extension is ready for production but, of course, it can have bugs.

Screenshots

add_bookmark

save_bookmark

search_by_tag

search_by_tags_AND

search_by_tags_OR

Firefox screenshots

firefox_extensions_list

firefox_options

Chrome screenshots

Update 2018-02-28. Please don't use this extension for now. I didn't have the time to update it yet.

chrome_options

Help needed

I'd love to have any kind of feedback on this extension.

If you are a developer have a look at the code and please open issues or send greatly appreciated PRs.

If you are not a developer please open issues and tell me what's not working for you.

Thank you!

Installation

Server side

Update 2018-02-28: no changes are required on server side at the moment. Be sure you are running Nextcloud 12.04 or 12.05 and everything should work fine

Client side (browser)

Firefox You can install the Firefox AddOn from the Mozilla Webstore

Chrome Update @2017-01-16: You can install the Chrome Extension from the webstore Update 2018-02-28. Please don't use this extension for now. I didn't have the time to update it yet.

Don't forget to configure the addon settings:

  • URL of your NextCloud server
  • NextCloud username
  • NextCloud password

If you want to modify or debug this extension:

Clone this extension repository in your pc:

git clone git@github.com:damko/freedommarks-browser-webextension.git

Open Firefox and paste this about:debugging in the URL bar

Click on the Load Temporary Add-on button and select the freedommarks-browser-webextension/src/manifest.json file

Click Open

Paste this about:addons in the URL bar and you will see the FreedomMarks extension listed among the others

Click on the button Preferences on the right of FreedomMarks and fill in the form with:

  • URL of your NextCloud server
  • NextCloud username
  • NextCloud password