{"id":13862618,"url":"https://github.com/paperboi/PickPocket","last_synced_at":"2025-07-14T12:31:36.497Z","repository":{"id":115845610,"uuid":"287295336","full_name":"paperboi/PickPocket","owner":"paperboi","description":"A python script to transfer all your Pocket links to a database in Notion.","archived":false,"fork":false,"pushed_at":"2020-08-26T17:35:04.000Z","size":75,"stargazers_count":16,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-13T22:40:42.367Z","etag":null,"topics":["getpocket","notion","notion-py","pocket","python","readitlater","ril"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paperboi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-08-13T14:00:19.000Z","updated_at":"2023-10-16T16:38:12.000Z","dependencies_parsed_at":"2023-07-28T22:02:41.787Z","dependency_job_id":null,"html_url":"https://github.com/paperboi/PickPocket","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperboi%2FPickPocket","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperboi%2FPickPocket/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperboi%2FPickPocket/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperboi%2FPickPocket/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paperboi","download_url":"https://codeload.github.com/paperboi/PickPocket/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225974520,"owners_count":17553968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["getpocket","notion","notion-py","pocket","python","readitlater","ril"],"created_at":"2024-08-05T06:01:48.664Z","updated_at":"2024-11-22T22:31:20.417Z","avatar_url":"https://github.com/paperboi.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\n\u003c!-- PROJECT OVERVIEW --\u003e\n\u003cbr /\u003e\n  \u003ch1 align=\"center\"\u003ePickPocket\u003c/h1\u003e\n  \u003cp align=\"center\"\u003e\n    A python script to transfer all your Pocket links to a database in Notion. \n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/paperboi/PickPocket\"\u003eExplore the docs\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/paperboi/PickPocket/issues\"\u003eFile issues and feature requests here\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [About The Project](#about-the-project)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Setup \u0026 Installation](#setup--installation)\n- [Usage](#usage)\n- [Roadmap](#roadmap)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n- [Acknowledgements](#acknowledgements)\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nA 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.\n\n**Intended for**\n- Those who are looking to transfer their reading lists from Pocket to Notion.\n- Those who want to keep track and analyze what they read.\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nTo get a local copy up and running follow these simple steps.\n\n### Prerequisites\n\n* A Pocket account to retreive your saved content from.\n* A Notion account to store your links.\n* Python 3 on your system to run the code.\n  \n### Setup \u0026 Installation\n \n1. Clone this repository.\n    ```sh\n    git clone https://github.com/paperboi/PickPocket.git\n    ```\n2. Navigate to the directory and install the pre-requisite packages using\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n1. Export your Pocket saves from [here](https://help.getpocket.com/article/1015-exporting-your-pocket-list).\n2. Duplicate this [database template](https://www.notion.so/personaljeff/e4a0751a114842c6b2b238218e52e7d2?v=062127a6aa4341fb98e6d74b0eadfc4c) to your Notion workspace.\n3. 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.\n   - For Chrome: Open Developer Tools (*Menu \u003e Other tools \u003e Developer Tools*), navigate to Application tab and go to *Storage\\Cookies* to find the token.\n4. 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. \n5. To execute the script, navigate to the directory and run\n   ```sh\n   python pocket2notion.py\n   ```\n\n\u003c!-- ROADMAP --\u003e\n## Roadmap\n\nSee the [open issues](https://github.com/paperboi/PickPocket/issues) for a list of proposed features (and known issues).\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\n\u003c!-- Contributions are what make the open source community such an amazing place to be learn, inspire, and create. --\u003e\nAny contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the MIT License. See [LICENSE](https://github.com/paperboi/PickPocket/blob/master/LICENSE.md) for more information.\n\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nJeffrey Jacob - [@DullBlackWall](https://twitter.com/DullBlackWall) - jeffreysamjacob@gmail.com\n\nProject Link: [https://github.com/paperboi/PickPocket](https://github.com/paperboi/PickPocket)\n\n\n\n\u003c!-- ACKNOWLEDGEMENTS --\u003e\n## Acknowledgements\n\n* [K.P. Govind](https://github.com/reisub0) for clearing my doubts every step of the way.\n* [Jamie Alexandre](https://github.com/jamalex/) for the powerful [notion-py](https://github.com/jamalex/notion-py) API.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaperboi%2FPickPocket","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaperboi%2FPickPocket","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaperboi%2FPickPocket/lists"}