{"id":15630414,"url":"https://github.com/augustohp/reading-dump","last_synced_at":"2025-04-29T11:56:08.465Z","repository":{"id":71200123,"uuid":"94696858","full_name":"augustohp/reading-dump","owner":"augustohp","description":"💩 Read while taking a dump. Tags articles on GetPocket that take 5min or less to read.","archived":false,"fork":false,"pushed_at":"2017-08-24T15:55:35.000Z","size":17,"stargazers_count":5,"open_issues_count":5,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-29T11:56:03.748Z","etag":null,"topics":["php","pocket-api","reading"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/augustohp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2017-06-18T15:46:10.000Z","updated_at":"2023-05-18T21:14:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"e557b2da-2360-4e77-b7b1-a3e2bfc1747a","html_url":"https://github.com/augustohp/reading-dump","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/augustohp%2Freading-dump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/augustohp%2Freading-dump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/augustohp%2Freading-dump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/augustohp%2Freading-dump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/augustohp","download_url":"https://codeload.github.com/augustohp/reading-dump/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251498965,"owners_count":21598979,"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":["php","pocket-api","reading"],"created_at":"2024-10-03T10:32:37.643Z","updated_at":"2025-04-29T11:56:08.459Z","avatar_url":"https://github.com/augustohp.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reading dump - Spend 5 minutes reading something\n\nYou've added **a lot** of articles into [Pocket][] and forgot to read\nthem? Well, we tag articles that are 5 minutes long so you read\nthem while taking your next dump.\n\n## Quick start\n\nThis is bad, but it should work. First you need this requirements:\n\n1. [PHP][] 5.4.0 or greater (`php` as the command will be inferred from now on).\n1. [Composer][] installed (`composer.phar` as the command will be inferred from now on).\n1. [Git][] installed (`git` will be inferred).\n\n```\n$ git clone git@github.com:augustohp/reading-dump.git\n$ cd reading-dump\n$ composer.phar install\n$ export POCKET_APP_CONSUMER_KEY=\"68036-0687e76e71d1c40d0fa1cca5\"\n$ php -S 127.0.0.1:8080 -t www/\n```\n\nYou should now be able to create an access token [opening this page][1]\nin your browser. Make sure you `export` your access token in the\nterminal you are going to use. The mechanics are separated into\ndifferent commands so it is easier to refactor them into reusable\ncomponents in the future - or just because I've not put any thoughts\nwhatsoever into making them:\n\n1. Display a list of unread articles, one per line, displaying `item-id`, `since` and `word count`.\n1. Filter articles that are 5 minute long from the list.\n1. Tag articles by their `article-id` as `reading-dump`.\n\nThis looks like something like this, you can cron that:\n\n```\n$ export POCKET_APP_ACCESS_TOKEN=\"the token generated by previous page\"\n$ php reading-dump.php pocket-retrieve --limit 10 --since 1497812212 | \\\n    php reading-dump.php filter-reading-time --less-than-min 5 |\n    php reading-dump.php pocket-tag --tag \"reading-dump\"\n```\n\n## TO DO\n\nA list of ideas that might be interesting:\n\n* [ ] Make comments accept streams and direct arguments at the same time.\n* [ ] Retrieve the access token through console (no web page on our end needed).\n* [ ] Maintain a `$HOME/.reading-dump.ini` file with *access token* and other useful states.\n* [ ] Implement a *pager* so `limit` and `offset` can be inferred.\n* [ ] Offer a single [command][2] `reading-dump.phar cron-daily`.\n* [ ] Make it beautiful (E.g: allow different sources and outputs, send to kindle).\n\n[1]: http://127.0.0.1:8080\n[2]: https://github.com/box-project/box2 \"Phar creation utility\"\n[Pocket]: https://getpocket.com\n[Composer]: https://getcomposer.org\n[PHP]: https://php.net\n[Git]: https://git-scm.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faugustohp%2Freading-dump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faugustohp%2Freading-dump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faugustohp%2Freading-dump/lists"}