From 033e8a2d26bb0ecaa8301609960d35d3467a88f4 Mon Sep 17 00:00:00 2001 From: kamtschatka Date: Sat, 25 May 2024 23:20:17 +0200 Subject: feature: Allow import Netscape HTML format (#163) * [Feature request] Netscape HTML format import/export #96 added the possibility to add exported bookmarks via the webUI for ease of use * [Feature request] Netscape HTML format import/export #96 updated the documentation * Extract the parser into its own file and reuse the existing bookmark upload logic --------- Co-authored-by: kamtschatka Co-authored-by: MohamedBassem --- docs/docs/10-import.md | 33 +++++++++++++++++++++++++-------- 1 file changed, 25 insertions(+), 8 deletions(-) (limited to 'docs') diff --git a/docs/docs/10-import.md b/docs/docs/10-import.md index f0e6ee35..14c59034 100644 --- a/docs/docs/10-import.md +++ b/docs/docs/10-import.md @@ -1,28 +1,45 @@ # Importing Bookmarks +## Import using the WebUI + +Hoarder supports importing bookmarks using the Netscape HTML Format. + +Simply open the WebUI of your Hoarder instance and drag and drop the bookmarks file into the UI. + +:::info +All the URLs in the bookmarks file will be added automatically, you will not be able to pick and choose which bookmarks to import! +::: + +## Import using the CLI + :::warning -Currently importing bookmarks requires some technical knowledge and might not be very straightforward for non-technical users. Don't hesitate to ask questions in github discussions or discord though. +Importing bookmarks using the CLI requires some technical knowledge and might not be very straightforward for non-technical users. Don't hesitate to ask questions in github discussions or discord though. ::: -## Import from Chrome +### Import from Chrome -- Open Chrome and go to `chrome://bookmarks` -- Click on the three dots on the top right corner and choose `Export bookmarks` -- This will download an html file with all of your bookmarks. +- First follow the steps below to export your bookmarks from Chrome - To extract the links from this html file, you can run this simple bash one liner (if on windows, you might need to use [WSL](https://learn.microsoft.com/en-us/windows/wsl/install)): `cat | grep HREF | sed 's/.*HREF="\([^"]*\)".*/\1/' > all_links.txt`. - This will create a file `all_links.txt` with all of your bookmarks one per line. - To import them, we'll use the [hoarder cli](https://docs.hoarder.app/command-line). You'll need a Hoarder API key for that. - -Run the following command to import all the links from `all_links.txt`: +- Run the following command to import all the links from `all_links.txt`: ``` cat all_links.txt | xargs -I{} hoarder --api-key --server-addr bookmarks add --link {} ``` -## Import from other platforms +### Import from other platforms If you can get your bookmarks in a text file with one link per line, you can use the following command to import them using the [hoarder cli](https://docs.hoarder.app/command-line): ``` cat all_links.txt | xargs -I{} hoarder --api-key --server-addr bookmarks add --link {} ``` + +## Exporting Bookmarks from Chrome + +- Open Chrome and go to `chrome://bookmarks` +- Click on the three dots on the top right corner and choose `Export bookmarks` +- This will download an html file with all of your bookmarks. + +You can use this file to import the bookmarks using the UI or CLI method described above \ No newline at end of file -- cgit v1.2.3-70-g09d2