{"id":20519978,"url":"https://github.com/e-alizadeh/zotero2readwise-sync","last_synced_at":"2025-03-06T00:18:22.405Z","repository":{"id":46750422,"uuid":"444604776","full_name":"e-alizadeh/Zotero2Readwise-Sync","owner":"e-alizadeh","description":"An automated and scheduled trigger of Zotero2Readwise Python library (https://github.com/e-alizadeh/Zotero2Readwise) ","archived":false,"fork":false,"pushed_at":"2024-06-05T11:12:17.000Z","size":11306,"stargazers_count":66,"open_issues_count":3,"forks_count":160,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-16T10:32:27.432Z","etag":null,"topics":["automation","readwise","readwise-highlights","zotero"],"latest_commit_sha":null,"homepage":"","language":null,"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/e-alizadeh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"publiccode":null,"codemeta":null}},"created_at":"2022-01-05T00:20:19.000Z","updated_at":"2024-12-23T13:19:26.000Z","dependencies_parsed_at":"2024-06-05T12:45:26.811Z","dependency_job_id":"520696e6-3d3c-49f7-9ca4-dd36e2467722","html_url":"https://github.com/e-alizadeh/Zotero2Readwise-Sync","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/e-alizadeh%2FZotero2Readwise-Sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-alizadeh%2FZotero2Readwise-Sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-alizadeh%2FZotero2Readwise-Sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-alizadeh%2FZotero2Readwise-Sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/e-alizadeh","download_url":"https://codeload.github.com/e-alizadeh/Zotero2Readwise-Sync/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242123333,"owners_count":20075348,"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":["automation","readwise","readwise-highlights","zotero"],"created_at":"2024-11-15T22:17:21.525Z","updated_at":"2025-03-06T00:18:22.380Z","avatar_url":"https://github.com/e-alizadeh.png","language":null,"funding_links":["https://www.buymeacoffee.com/ealizadeh"],"categories":[],"sub_categories":[],"readme":"# Zotero2Readwise-Sync \n[![Zotero ➡️ Readwise Automation](https://github.com/e-alizadeh/Zotero2Readwise-Sync/actions/workflows/automation.yml/badge.svg)](https://github.com/e-alizadeh/Zotero2Readwise-Sync/actions/workflows/automation.yml/badge.svg)\n\nThis repo has actually a cronjob (time-based Job scheduler) using GitHub actions that automates the Zotero -\u003e Readwise \nintegration using the [Zotero2Readwise](https://github.com/e-alizadeh/Zotero2Readwise) Python library. \n\n# Instructions\n**You just need to fork this repository and add the following secrets to your git repository secrets, \nand you're ready to go!**\n- Readwise Access Token (secret name: **READWISE_TOKEN**)\n- Zotero Key (secret name: **ZOTERO_KEY**)\n- Zotero Library ID (secret name: **ZOTERO_ID**)\n\nCheck the [Section Usage](https://github.com/e-alizadeh/Zotero2Readwise#usage) in [Zotero2Readwise](https://github.com/e-alizadeh/Zotero2Readwise) repo to get \ninstructions on how to find above information. \n\n*Note that since Readwise token and Zotero Key's are sensitive information, they should be treated as your passwords.\nBecause of this, I'm using GitHub Action secrets to manage such sensitive variables!*\n\n# Change the scheduled automation\nYou can run Zotero2Readwise automation at any repeated schedule by changing the *cron schedule expression*. \nCheck [crontab guru](https://crontab.guru/) or [crontab](https://crontab.tech/) (has some examples) for more details. \n\nOnce you come up with the desired schedule, update the cron argument in `.github/workflows/automation.yml` file given below.\n*Don't forget the double quote around the expression!* \n\n```yaml\n  schedule:\n    - cron: \"0 3 * * 1,3,5\"\n```\n*Above is the default schedule I've set up to run the automation.*\nThe cron expression means to run the automation **at 03:00 AM every Monday, Wednesday, and Friday**. \nYou can change the schedule as you wish. Just make sure that your cron job expression is valid by checking \n\nA scheduled GitHub Action will show **scheduled** next to the deployment as can be seen below. \n![](img/scheduled_automation.jpg)\n\n\n# How to add secrets to your repo's GitHub Actions secrets\n![](img/github_action_secrets.gif)\n\n\n# Manual Trigger\nIf you want to manually trigger the automation, you can simply commit an empty message and push it to your forked repo, \nlike the following:\n```shell\ngit commit --allow-empty -m \"Trigger automation\"\n```\nand then,\n```shell\ngit push\n```\nThis will run the automation immediately and won't impact your scheduled automation.\n\n# Note\n*Keep in mind that GitHub Actions may run the scheduled automation with some delay (sometimes with one-hour delay!).*\n\n# 📫 How to reach me:\n\u003ca href=\"https://ealizadeh.com\" target=\"_blank\"\u003e\u003cimg alt=\"Personal Website\" src=\"https://img.shields.io/badge/Personal%20Website-%2312100E.svg?\u0026style=for-the-badge\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/in/alizadehesmaeil/\" target=\"_blank\"\u003e\u003cimg alt=\"LinkedIn\" src=\"https://img.shields.io/badge/linkedin-%230077B5.svg?\u0026style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://medium.ealizadeh.com/\" target=\"_blank\"\u003e\u003cimg alt=\"Medium\" src=\"https://img.shields.io/badge/medium-%2312100E.svg?\u0026style=for-the-badge\u0026logo=medium\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://twitter.com/intent/follow?screen_name=es_alizadeh\u0026tw_p=followbutton\" target=\"_blank\"\u003e\u003cimg alt=\"Twitter\" src=\"https://img.shields.io/badge/twitter-%231DA1F2.svg?\u0026style=for-the-badge\u0026logo=twitter\u0026logoColor=white\" /\u003e\u003c/a\u003e\n\n\u003ca href=\"https://www.buymeacoffee.com/ealizadeh\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-blue.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe-alizadeh%2Fzotero2readwise-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fe-alizadeh%2Fzotero2readwise-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe-alizadeh%2Fzotero2readwise-sync/lists"}