https://github.com/ytakahashi/chrome-bookmark-reader
A library/cli to read Bookmarks of Google Chrome.
https://github.com/ytakahashi/chrome-bookmark-reader
bookmark chrome cli cli-app typescript
Last synced: about 1 year ago
JSON representation
A library/cli to read Bookmarks of Google Chrome.
- Host: GitHub
- URL: https://github.com/ytakahashi/chrome-bookmark-reader
- Owner: ytakahashi
- License: mit
- Created: 2020-05-02T08:24:43.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-08-01T11:59:18.000Z (almost 2 years ago)
- Last Synced: 2025-03-30T13:51:13.494Z (about 1 year ago)
- Topics: bookmark, chrome, cli, cli-app, typescript
- Language: TypeScript
- Homepage:
- Size: 613 KB
- Stars: 16
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# chrome-bookmark-reader
[](https://badge.fury.io/js/chrome-bookmark-reader)
[](https://github.com/ytakahashi/chrome-bookmark-reader/actions)
[](./LICENSE)
A library/cli to read Bookmarks of Google Chrome.
This library parses bookmark json files of Google Chrome and returns the result as a flat json object.
## Requirements
- Node.js >= 12
## Usage
### As a library
```terminal
npm install chrome-bookmark-reader
```
```terminal
yarn add chrome-bookmark-reader
```
```typescript
import { getChromeBookmark } from 'chrome-bookmark-reader'
const path = '/path/to/Chrome/Bookmark'
const result = getChromeBookmark(path)
console.log(result)
// shows your bookmark contents
```
#### option
```typescript
const option = {
shouldIncludeFolders: true,
}
const result = getChromeBookmark(path, option)
```
- `shouldIncludeFolders`: If `true`, results include bookmark folders (defaults to `false`).
### As a cli
```terminal
npm install -g chrome-bookmark-reader
```
```terminal
chrome-bookmark --file "/path/to/Chrome/Bookmark" [--pattern "something"] [--output "text"]
# -> shows your bookmark contents
```
#### options
- `--file` (`-f`): Required. Path to Chrome Bookmarks File (see below).
- `--pattern` (`-p`): Optional. If specified, result is filtered by the given value.
- `--output` (`-o`): Optional. Result is displayed according to this value. format. One of `"json"` or `"text"` is available. Defaults to `"json"`.
For detail, type `chrome-bookmark --help`.
#### Notice
If you are a mac user, you can find the bookmark json file at the following location:
- `"/Users/{Username}/Library/Application Support/Google/Chrome/{Chrome Profile}/Bookmarks"`
- [Where are Google Chrome bookmarks stored in macOS for multiple profiles?](https://apple.stackexchange.com/questions/322935/where-are-google-chrome-bookmarks-stored-in-macos-for-multiple-profiles)
For windows, see following article.
- [How to Find Chrome Bookmarks File Location in Windows](https://windowsloop.com/find-google-bookmarks-folder-windows/)
### Related repositories
- [chrome-history-reader](https://github.com/ytakahashi/chrome-history-reader)