Skip to content

Commit

Permalink
[Feature request] Netscape HTML format import/export hoarder-app#96
Browse files Browse the repository at this point in the history
updated the documentation
  • Loading branch information
kamtschatka committed May 17, 2024
1 parent 2da67cc commit a121cad
Showing 1 changed file with 25 additions and 8 deletions.
33 changes: 25 additions & 8 deletions docs/docs/10-import.md
Original file line number Diff line number Diff line change
@@ -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 <file_path> | 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 <key> --server-addr <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 <key> --server-addr <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

0 comments on commit a121cad

Please sign in to comment.