{"id":13563236,"url":"https://gitlab.com/aaronNG/reddio","last_synced_at":"2025-04-03T19:32:42.616Z","repository":{"id":55614656,"uuid":"12348179","full_name":"aaronNG/reddio","owner":"aaronNG","description":"a command-line interface for Reddit written in POSIX sh","archived":false,"fork":false,"pushed_at":null,"size":null,"stargazers_count":93,"open_issues_count":5,"forks_count":7,"subscribers_count":null,"default_branch":"master","last_synced_at":"2024-11-04T15:52:24.625Z","etag":null,"topics":["cli","curl","jq","minimal","posix","reddit","sh","shell","suckless"],"latest_commit_sha":null,"homepage":null,"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":null,"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}},"created_at":"2019-05-15T17:31:49.378Z","updated_at":"2024-05-10T21:43:29.682Z","dependencies_parsed_at":"2022-08-20T15:01:28.788Z","dependency_job_id":null,"html_url":"https://gitlab.com/aaronNG/reddio","commit_stats":null,"previous_names":[],"tags_count":7,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/aaronNG%2Freddio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/aaronNG%2Freddio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/aaronNG%2Freddio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/aaronNG%2Freddio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/owners/aaronNG","download_url":"https://gitlab.com/aaronNG/reddio/-/archive/master/reddio-master.zip","host":{"name":"gitlab.com","url":"https://gitlab.com","kind":"gitlab","repositories_count":4518515,"owners_count":6909,"icon_url":"https://github.com/gitlab.png","version":null,"created_at":"2022-05-30T11:31:42.605Z","updated_at":"2024-07-18T11:24:13.055Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/owners"}},"keywords":["cli","curl","jq","minimal","posix","reddit","sh","shell","suckless"],"created_at":"2024-08-01T13:01:16.723Z","updated_at":"2025-04-03T19:32:41.995Z","avatar_url":null,"language":null,"funding_links":[],"categories":["Command Line Utilities","Social media"],"sub_categories":["Internet","Reddit"],"readme":"# reddio\n\nreddio is a command-line interface for Reddit written in POSIX sh.\n\n![example session](example.png?raw=true \"Example session\")\n\n## Why\n\nTerminal user interfaces suck. Because `reddio` is command-line only, it's way more flexible than a TUI and integrates much better with other command-line utilities.\n\n## Dependencies\n\n* A POSIX compliant shell as `/bin/sh`\n* `coreutils` (GNU, busybox or others should work)\n* `cURL`\n* `jq`\n* `netcat` optional (for authentication)\n\n## Installation\n\n### System-wide installation into /usr/local\n\n```shell\nmake install\n```\n\n### Home directory installation into $HOME/.local\n\n```shell\nmake PREFIX=\"$HOME/.local\" install\nPATH=$HOME/.local/bin:$PATH\n```\n\n## Usage\n\n```\nreddio [-chqvV] [\u003ccommand\u003e [\u003cargs\u003e]]\n\n  -c \u003cfile\u003e    Use \u003cfile\u003e instead of the default config\n  -s \u003csession\u003e Use \u003csession\u003e instead of the default\n  -q           Quiet\n  -v           Verbose mode\n  -V           Print version information and exit\n  -h           Print this help and exit\n\nCommands:\n  comment delete edit login logout message print submit\n  (un)follow (un)hide (un)marknsfw (un)read (un)save\n  (un)spoiler (un)subscribe upvote downvote unvote.\n\nA unique part, of the beginning of the command, is also valid. For\nexample, 'p' for print or 'logi' for login.\n```\n\nAll sub-commands also have a `-h` option for printing usage information.\n\n## Examples\n\nPrint the two hottest submissions of r/commandline\n\n```shell\n$ reddio print -l 2 r/commandline\n18 Suggestions on mp3 streams for background music (self.commandline)\nhttps://www.reddit.com/r/commandline/comments/cdfq7p/suggestions_on_mp3_streams_for_background_music/\n14 comments | submitted 8.4 hours ago by jherazob to r/commandline t3_cdfq7p\n\n16 Βulk image resizing (cli) (youtube.com)\nhttps://www.youtube.com/attribution_link?a=NkwKg-k3QY0\u0026u=%2Fwatch%3Fv%3DidyBFtocLaU%26feature%3Dshare\n11 comments | submitted 1.2 days ago by vagelis_prokopiou to r/commandline t3_cd2zfg\n```\n\nCount the words of a self-post\n\n```shell\n$ reddio print -f '$text' by_id/t3_cdfq7p | wc -w\n156\n```\n\nPrint the top 5 urls of the month of r/linux\n\n```shell\n$ reddio print -f '$num. $url$nl' -l 5 -t month r/linux/top\n1. https://i.redd.it/edqgfmhoew431.jpg\n2. https://twitter.com/ISPAUK/status/1146725374455373824\n3. https://www.raspberrypi.org/blog/raspberry-pi-4-on-sale-now-from-35/\n4. https://i.redd.it/30c8yyn390a31.jpg\n5. https://i.redd.it/6k5u6euppn931.jpg\n```\n\nSubmit a selfpost to r/test\n\n```shell\n$ reddio submit -t 'Hello, World!' r/test 'Test submission using reddio - CLI reddit reader'\n```\n\nCheck for new messages and comment replies\n\n```shell\n$ reddio print -l 1 -f '${new:+New message(s)!$nl}' message/unread\nNew message(s)!\n```\n\nWithout `-t \u003ctext\u003e`, text is read from stdin\n\n```shell\n$ echo 'Hello, World! | reddio comment t1_anid36\n$ reddio comment t1_anid36 \u003csomefile\n$ reddio comment t1_anid36 \u003c\u003c-EOF\n\tHello, World!\nEOF\n```\n\nMore examples in [doc/examples](doc/examples). To learn about the available formatting variables, checkout [doc/formats.md](doc/formats.md).\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/gitlab.com%2FaaronNG%2Freddio","html_url":"https://awesome.ecosyste.ms/projects/gitlab.com%2FaaronNG%2Freddio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/gitlab.com%2FaaronNG%2Freddio/lists"}