Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paperboi/pickpocket
A python script to transfer all your Pocket links to a database in Notion.
https://github.com/paperboi/pickpocket
getpocket notion notion-py pocket python readitlater ril
Last synced: 2 months ago
JSON representation
A python script to transfer all your Pocket links to a database in Notion.
- Host: GitHub
- URL: https://github.com/paperboi/pickpocket
- Owner: paperboi
- License: mit
- Created: 2020-08-13T14:00:19.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-08-26T17:35:04.000Z (over 4 years ago)
- Last Synced: 2024-08-05T06:06:10.669Z (5 months ago)
- Topics: getpocket, notion, notion-py, pocket, python, readitlater, ril
- Language: Python
- Homepage:
- Size: 73.2 KB
- Stars: 16
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
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](#table-of-contents)
- [About The Project](#about-the-project)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Setup & Installation](#setup--installation)
- [Usage](#usage)
- [Roadmap](#roadmap)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
- [Acknowledgements](#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.
```sh
git clone https://github.com/paperboi/PickPocket.git
```
2. Navigate to the directory and install the pre-requisite packages using
```sh
pip install -r requirements.txt
```
## Usage
1. Export your Pocket saves from [here](https://help.getpocket.com/article/1015-exporting-your-pocket-list).
2. Duplicate this [database template](https://www.notion.so/personaljeff/e4a0751a114842c6b2b238218e52e7d2?v=062127a6aa4341fb98e6d74b0eadfc4c) 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
```sh
python pocket2notion.py
```
## Roadmap
See the [open issues](https://github.com/paperboi/PickPocket/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](https://github.com/paperboi/PickPocket/blob/master/LICENSE.md) for more information.
## Contact
Jeffrey Jacob - [@DullBlackWall](https://twitter.com/DullBlackWall) - [email protected]
Project Link: [https://github.com/paperboi/PickPocket](https://github.com/paperboi/PickPocket)
## Acknowledgements
* [K.P. Govind](https://github.com/reisub0) for clearing my doubts every step of the way.
* [Jamie Alexandre](https://github.com/jamalex/) for the powerful [notion-py](https://github.com/jamalex/notion-py) API.