Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tetzng/clip-to-notion

Efficiently fetch the title and metadata from a URL and tidily organize them into a Notion database.
https://github.com/tetzng/clip-to-notion

bookmarks notion

Last synced: 25 days ago
JSON representation

Efficiently fetch the title and metadata from a URL and tidily organize them into a Notion database.

Awesome Lists containing this project

README

        

# Clip to Notion (ctn)

`ctn` is a command-line tool designed to efficiently fetch the title and metadata from any URL and tidily organize them into your Notion workspace. By extracting key information such as titles and Open Graph tags, `ctn` streamlines the process of saving and managing online content directly within your Notion database.

## Prerequisites

- Notion API key.
- A Notion database set up for clipping, with the following properties:
- **Name**: Type `title`
- **URL**: Type `url`
- **Description**: Type `text`
- **Tags**: Type `multi-select` (only needed if using the `--tags` option)

## Installation

To install `ctn`, ensure you have Rust and Cargo installed, then run:

```sh
cargo install clip-to-notion
```

This will compile the project and install the ctn binary to your Cargo bin path.

## Usage

Before using ctn, make sure to initialize your configuration file:

```sh
ctn init
```

Follow the prompts to enter your Notion API key and database ID.

To clip a URL to your Notion database, use:

```sh
ctn run --tags
```

### Example

```
ctn run https://example.com --tags article,tech
```

## Configuration

The configuration file is stored at `~/.config/clip-to-notion/config.toml`. It contains your Notion API key and database ID.