PickPocket

<!-- PROJECT OVERVIEW --> <br /> <h1 align="center">PickPocket</h1> <p align="center"> A python script to transfer all your Pocket links to a database in Notion. <br /> <a href="https://github.com/paperboi/PickPocket">Explore the docs</a> · <a href="https://github.com/paperboi/PickPocket/issues">File issues and feature requests here</a> </p> </p> <!-- TABLE OF CONTENTS -->

Table of Contents

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

<!-- ABOUT THE PROJECT -->

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 -->

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 EXAMPLES -->

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 -->

Roadmap

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

<!-- CONTRIBUTING -->

Contributing

<!-- Contributions are what make the open source community such an amazing place to be learn, inspire, and create. -->

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 -->

License

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

<!-- CONTACT -->

Contact

Jeffrey Jacob - @DullBlackWall - jeffreysamjacob@gmail.com

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

<!-- ACKNOWLEDGEMENTS -->

Acknowledgements

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