PickPocket

A python script to transfer all your Pocket links to a database in Notion.
Explore the docs · File issues and feature requests here

Table of Contents

• Table of Contents
• About The Project
• Getting Started
  • Prerequisites
  • Setup & Installation
• Usage
• Roadmap
• Contributing
• License
• Contact
• Acknowledgements

About The Project

A python script to copy all your Pocket saves to a database in Notion. Current iteration is based off the HTML export option provided by the folks at Pocket.

Intended for

• Those who are looking to transfer their reading lists from Pocket to Notion.
• Those who want to keep track and analyze what they read.

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• A Pocket account to retreive your saved content from.
• A Notion account to store your links.
• Python 3 on your system to run the code.

Setup & Installation

1. Clone this repository.

   git clone https://github.com/paperboi/PickPocket.git

2. Navigate to the directory and install the pre-requisite packages using

   pip install -r requirements.txt

Usage

1. Export your Pocket saves from here.
2. Duplicate this database template to your Notion workspace.
3. Since this code requires access of non-public pages, an authentication token from your Notion page is required. This token is stored in the token_v2 cookie. This can be found in the Storage tab of your browser's developer tools.
   • For Chrome: Open Developer Tools (Menu > Other tools > Developer Tools), navigate to Application tab and go to Storage\Cookies to find the token.
4. Store the path to your HTML file, the address to your database and the token_v2 value as PATH_POCKET_FILE, NOTION_TABLE_ID and NOTION_TOKEN respectively in a .env file in the same directory you have cloned this repository to.
5. To execute the script, navigate to the directory and run

   python pocket2notion.py

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Jeffrey Jacob - @DullBlackWall - jeffreysamjacob@gmail.com

Project Link: https://github.com/paperboi/PickPocket

Acknowledgements

• K.P. Govind for clearing my doubts every step of the way.
• Jamie Alexandre for the powerful notion-py API.