Skip to content

Chrome/Safari/Firefox extension for clipping arXiv articles to Notion.

License

Notifications You must be signed in to change notification settings

wangjksjtu/arxiv2notionplus

Repository files navigation

arxiv2notion+

NOTE: The enhancements are already merged to the original arxiv2notion repo. Thanks @denkiwakame!

build

Easy-to-use arXiv clipper for Notion based on Notion API (original repo: https://github.com/denkiwakame/arxiv2notion MIT License)

Download extensions: Chrome, Safari, Firefox

Safari demo

Chrome demo
Firefox demo

More Features: arxiv2notion+

  • Add the publication date for easier tracking
  • Add the comment parser for quick access to the potential project homepage or code link (if available)
  • Replace the author field from text to multi-select to fully leverage the search/filter in notion
  • Release a public notion database/table template to simplify the notion setup
  • Support Chrome, Safari and Firefox browsers

image image

Create databases in notion

  • The easiest approach is to clone the public template here to your own notion workspace
  • Follow the instruction of Notion API
    • navigate to My Integrations
    • + New integration
    • associated workspace: select your workspace where you save arXiv articles
  • Invite the integration to target databases via Share -> Invite invite_integration

Alternatively, you can follow the following steps to create database from scratch in notion

Click here to expand!
  • Login to notion.so by admin user
  • Create databases where you save arXiv articles
    • Follow this instruction https://www.notion.so/guides/creating-a-database , do NOT create a new database by /database !
    • Add properties listed below. Title URL Publisher Authors Abstract
    • Note that you should create extactly the same properties with listed names.
property type
Title Title
URL URL
Authors Multi-Select
Abstract Text
Published Date
Comment URL
Publisher Select

Installation

  • Download extension package from https://github.com/wangjksjtu/arxiv2notionplus/releases
  • (Chrome) Open Chrome then enter chrome://extensions in the URL bar
    • drag and drop the extension from your file manager anywhere onto the extensions page
    • or unzip the extension and load unpacked in developer mode
  • (Safari)
    • Enable develop mode in safari: Safari > Preferences > Advanced > check "Show Develop menu in menu bar"
    • Allow unsigned extensions: Menu bar > Develop > check "Allow Unsigned Extensions"
    • Unzip the extension arxiv2notionplus.safari.zip and click arxiv2notion application
    • Enable the extension from the extensions list (Safari > Preferences > Extensions)
  • (Firefox) Open Firefox then enter about:debugging in the URL bar
    • Click This Firefox
    • Click Load Temporary Add-on
    • Unzip the extension arxiv2notionplus.firefox.zip
    • Click arxiv2notionplus.chrome.crx in the unzipped folder

Setup

  • (Chrome) Right-click on the extension icon > Options
    • Copy integration id (not the secret token!) (see figures below) from https://www.notion.so/my-integrations/internal/${integration-id}
    • Paste the integration id and click on + button.
  • (Safari) Right-click on the extension icon > Manage Extension
    • Click Always Allow on Every Website (or allow always allow extension for arxiv.org) - you will see some warnings on the icon if this step is not conducted; you can also grant the permission there ;)
    • Click preferences to enter a new page and copy integration id (not the secret token!)
    • Paste the integration id and click on + button.
  • (Firefox) Right-click on the extension icon > Manage Extension
    • Go to preferences tab and copy integration id (not the secret token!)
    • Paste the integration id and click on + button.

If your entered id is valid, you can see the following callback messages.

In order to avoid storing Notion API key directoly onto chrome local storage,
arxiv2notion requests API token on-demand via integration ID when you are logged in.
Note that you must be logged in to notion.so when you use this extension.
integration id successful connection messages
ref2 image

Build locally (for Developers)

$ git clone https://github.com/wangjksjtu/arxiv2notionplus.git
$ npm install
$ npm run build
$ npm run watch # debug locally
$ npm run pack  # packaging to zip

Acknowledgement

This repo makes some small enhancements on parsing the authors/publication dates in arxiv pages. Thanks to Mai Nishimura for the awesome arxiv2notion repo!