arc-bookmarks

### [🇺🇸 English](README.MD) | [🇨🇳 简体中文](README_CN.MD)

arc-bookmarks is a Python script used to export sidebar data (bookmarks) from Arc Browser to HTML/JSON files. The HTML file can be imported into other browsers. Only applicable to MacOS.

Future

[x] Export to HTML bookmark file.
[x] Export to JSON file.
[x] Automatically import bookmarks into Chrome browser.
[x] Automatically import bookmarks into Edge browser.
[ ] Automatically import bookmarks into Firefox browser.
[ ] Automatically import bookmarks into Safari browser.
[ ] Import bookmarks from other browsers into the Arc browser sidebar.

Usage

Using the executable file (no Python environment required)

For versions prior to v0.0.4, please refer to this document: README

Go to Releases and download according to your system version.
- M1/M../arm64 (Apple Silicon)
- x86_64 (Intel)
Unzip the arc-bookmarks.macos.*.zip file.
Open the Terminal application on your system.

Navigate to the arc-bookmarks.macos.* folder.

# Apple Silicon
cd ~/Downloads/arc-bookmarks.macos.arm64
# Intel
cd ~/Downloads/arc-bookmarks.macos.x86_64

Add execution permissions to the arc-bookmarks file.
```
chmod +x ./arc-bookmarks
```

Run the arc-bookmarks file.

./arc-bookmarks --save-html=~/Downloads/bookmark.html

Using Python to run

Go to Releases and download arc-bookmarks.zip.
Unzip the arc-bookmarks.zip file.
Open the system Terminal application.
Enter cd, then drag the arc-bookmarks folder into the terminal window. Press Enter to execute.
```
cd ~/Downloads/arc-bookmarks
```

Execute the arc-bookmarks file.

python3 main.py --save-html=bookmark.html

Parameters

sidebar-file
- Default: ~/Library/Application Support/Arc/StorableSidebar.json
- Reference:
- Example: --sidebar-file="~/Library/Application Support/Arc/StorableSidebar.json"
- Description: The path to the StorableSidebar.json file of Arc Browser. It is the file used to store the sidebar data of Arc Browser. In general, you don't need to specify this parameter. If not specified, the program will use the default path.
save-json
- Default:
- Reference: ~/Downloads/bookmark.json
- Example: --save-json=bookmark.json
- Description: Save bookmarks to a JSON file.
save-html
- Default:
- Reference: ~/Downloads/bookmark.html
- Example: --save-html=bookmark.html
- Description: Save bookmarks to an HTML file. Can be imported into browsers.
import-to-chrome
- Default:
- Reference:
- Example: --import-to-chrome
- Description: Import bookmarks into Chrome browser.
- ⚠️Warning: Using this function will overwrite the bookmarks in the Chrome browser. Please make a backup yourself. After the import is successful, you need to restart the Chrome browser to see the imported bookmarks.
  - chrome-bookmarks-file
    - Default: ~/Library/Application Support/Google/Chrome/Default/Bookmarks
    - Reference:
    - Example: --chrome-bookmarks-file="~/Library/Application Support/Google/Chrome/Default/Bookmarks"
    - Description: The path to the Bookmarks file of Chrome browser. It is the file used to store the bookmarks of Chrome browser. In general, you don't need to specify this parameter. If not specified, the program will use the default path.
  - chrome-import-node
    - Default: bookmark_bar
    - Reference: bookmark_bar, other
    - Example: --chrome-import-node=bookmark_bar
    - Description: The node to import bookmarks into the Chrome browser. The default is bookmark_bar.
import-to-edge
- Default:
- Reference:
- Example: --import-to-edge
- Description: Import bookmarks into Edge browser.
- ⚠️Warning: Using this function will overwrite the bookmarks in the Edge browser. Please make a backup yourself. After the import is successful, you need to restart the Edge browser to see the imported bookmarks.
  - edge-bookmarks-file
    - Default: ~/Library/Application Support/Microsoft Edge/Default/Bookmarks
    - Reference:
    - Example: --edge-bookmarks-file="~/Library/Application Support/Microsoft Edge/Default/Bookmarks"
    - Description: The path to the Bookmarks file of Edge browser. It is the file used to store the bookmarks of Edge browser. In general, you don't need to specify this parameter. If not specified, the program will use the default path.
  - edge-import-node
    - Default: bookmark_bar
    - Reference: bookmark_bar, other
    - Example: --edge-import-node=bookmark_bar
    - Description: The node to import bookmarks into the Edge browser. The default is bookmark_bar.

Examples

Export as an HTML file, and save the exported file to ~/Downloads/bookmark.html.
```
./arc-bookmarks --save-html=~/Downloads/bookmark.html
```
Export as a JSON file, and save the exported file to ~/Downloads/bookmark.json.
```
./arc-bookmarks --save-json=~/Downloads/bookmark.json
```
Export as both an HTML file and a JSON file, and save the exported files to ~/Downloads/bookmark.html and ~/Downloads/bookmark.json respectively.
```
./arc-bookmarks --save-html=~/Downloads/bookmark.html --save-json=~/Downloads/bookmark.json
```
Import bookmarks into Chrome browser.
```
./arc-bookmarks --import-to-chrome
```
After the import is successful, you need to restart the Chrome browser to see the imported bookmarks.
Import bookmarks into Chrome and Edge browsers.
```
./arc-bookmarks --import-to-chrome --import-to-edge
```
After the import is successful, you need to restart the Chrome and Edge browsers to see the imported bookmarks.

Physton / arc-bookmarks

readme