{"id":13728851,"url":"https://github.com/manojkarthick/reddsaver","last_synced_at":"2026-03-05T00:09:51.411Z","repository":{"id":47104813,"uuid":"316837571","full_name":"manojkarthick/reddsaver","owner":"manojkarthick","description":"CLI tool to download saved and upvoted media from Reddit","archived":false,"fork":false,"pushed_at":"2026-03-01T08:13:14.000Z","size":175,"stargazers_count":148,"open_issues_count":1,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-03-01T08:18:51.646Z","etag":null,"topics":["reddit","reddit-api","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manojkarthick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-11-28T23:03:15.000Z","updated_at":"2026-03-01T08:01:36.000Z","dependencies_parsed_at":"2024-01-11T00:01:40.695Z","dependency_job_id":"10f561ad-f541-4409-a49e-989050990cd0","html_url":"https://github.com/manojkarthick/reddsaver","commit_stats":{"total_commits":89,"total_committers":4,"mean_commits":22.25,"dds":0.0898876404494382,"last_synced_commit":"e2e7573b9ed20a370db9f25077a0f430562aabce"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/manojkarthick/reddsaver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkarthick%2Freddsaver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkarthick%2Freddsaver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkarthick%2Freddsaver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkarthick%2Freddsaver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manojkarthick","download_url":"https://codeload.github.com/manojkarthick/reddsaver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manojkarthick%2Freddsaver/sbom","scorecard":{"id":615481,"data":{"date":"2025-08-11","repo":{"name":"github.com/manojkarthick/reddsaver","commit":"e2e7573b9ed20a370db9f25077a0f430562aabce"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/11 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/docker.yml:1","Warn: no topLevel permission defined: .github/workflows/rust.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE-APACHE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE-APACHE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.4.0 not signed: https://api.github.com/repos/manojkarthick/reddsaver/releases/49022750","Warn: release artifact v0.3.3 not signed: https://api.github.com/repos/manojkarthick/reddsaver/releases/45158048","Warn: release artifact v0.3.2 not signed: https://api.github.com/repos/manojkarthick/reddsaver/releases/40058777","Warn: release artifact v0.3.1 not signed: https://api.github.com/repos/manojkarthick/reddsaver/releases/38378978","Warn: release artifact v0.3.0 not signed: https://api.github.com/repos/manojkarthick/reddsaver/releases/38214409","Warn: release artifact v0.4.0 does not have provenance: https://api.github.com/repos/manojkarthick/reddsaver/releases/49022750","Warn: release artifact v0.3.3 does not have provenance: https://api.github.com/repos/manojkarthick/reddsaver/releases/45158048","Warn: release artifact v0.3.2 does not have provenance: https://api.github.com/repos/manojkarthick/reddsaver/releases/40058777","Warn: release artifact v0.3.1 does not have provenance: https://api.github.com/repos/manojkarthick/reddsaver/releases/38378978","Warn: release artifact v0.3.0 does not have provenance: https://api.github.com/repos/manojkarthick/reddsaver/releases/38214409"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/docker.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/docker.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/docker.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/rust.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/rust.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/rust.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/rust.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/rust.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/rust.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/rust.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/rust.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/rust.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/rust.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/rust.yml:65: update your workflow using https://app.stepsecurity.io/secureworkflow/manojkarthick/reddsaver/rust.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating rust:1.50.0 to rust:1.50.0@sha256:25a32551f42722169ea0b50b9ea752bd43a31b3e52371e735ea675866e4eb164","Warn: containerImage not pinned by hash: rpizerow.Dockerfile:1: pin your Docker image by updating rustembedded/cross:arm-unknown-linux-gnueabi to rustembedded/cross:arm-unknown-linux-gnueabi@sha256:ada74c4c68f8d14d112cea003ab4aa447990d344530f28f30301e919f0a0b1b3","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   8 third-party GitHubAction dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"27 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: RUSTSEC-2021-0139","Warn: Project is vulnerable to: RUSTSEC-2021-0145 / GHSA-g98v-hv3f-hcfr","Warn: Project is vulnerable to: RUSTSEC-2024-0375","Warn: Project is vulnerable to: RUSTSEC-2022-0078 / GHSA-f85w-wvc7-crwc","Warn: Project is vulnerable to: RUSTSEC-2021-0141","Warn: Project is vulnerable to: RUSTSEC-2023-0034 / GHSA-f8vr-r385-rh5r","Warn: Project is vulnerable to: RUSTSEC-2024-0003 / GHSA-8r5v-vm4m-4g25","Warn: Project is vulnerable to: RUSTSEC-2024-0332 / GHSA-q6cp-qfwq-4gcv","Warn: Project is vulnerable to: RUSTSEC-2021-0079 / GHSA-5h46-h7hh-c6x9","Warn: Project is vulnerable to: RUSTSEC-2021-0078 / GHSA-f3pg-qwvg-p99c","Warn: Project is vulnerable to: RUSTSEC-2022-0022 / GHSA-f67m-9j94-qv9j","Warn: Project is vulnerable to: RUSTSEC-2024-0421 / GHSA-h97m-ww89-6jmq","Warn: Project is vulnerable to: RUSTSEC-2020-0016","Warn: Project is vulnerable to: RUSTSEC-2023-0022 / GHSA-3gxf-9r58-2ghg","Warn: Project is vulnerable to: RUSTSEC-2023-0024 / GHSA-6hcf-g6gr-hhcr","Warn: Project is vulnerable to: RUSTSEC-2023-0023 / GHSA-9qwg-crg9-m2vc","Warn: Project is vulnerable to: RUSTSEC-2023-0044 / GHSA-xcf7-rvmh-g6q4","Warn: Project is vulnerable to: RUSTSEC-2023-0072 / GHSA-xphf-cx8h-7q9g","Warn: Project is vulnerable to: GHSA-q445-7m23-qrmw","Warn: Project is vulnerable to: RUSTSEC-2024-0357","Warn: Project is vulnerable to: RUSTSEC-2025-0004 / GHSA-rpmj-rpgj-qmpm","Warn: Project is vulnerable to: RUSTSEC-2022-0013 / GHSA-m5pq-gvj9-9vr8","Warn: Project is vulnerable to: RUSTSEC-2023-0018 / GHSA-mc8h-8q98-g5hr","Warn: Project is vulnerable to: RUSTSEC-2021-0124 / GHSA-fg7r-2g4j-5cgr","Warn: Project is vulnerable to: RUSTSEC-2023-0005 / GHSA-4q83-7cq4-p6wg","Warn: Project is vulnerable to: GHSA-rr8g-9fpq-6wmg","Warn: Project is vulnerable to: RUSTSEC-2025-0023"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T03:49:49.854Z","repository_id":47104813,"created_at":"2025-08-21T03:49:49.854Z","updated_at":"2025-08-21T03:49:49.854Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29966684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T09:33:09.965Z","status":"ssl_error","status_checked_at":"2026-03-01T09:25:48.915Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["reddit","reddit-api","rust"],"created_at":"2024-08-03T02:00:51.265Z","updated_at":"2026-03-01T10:01:39.653Z","avatar_url":"https://github.com/manojkarthick.png","language":"Rust","funding_links":[],"categories":["Social media"],"sub_categories":["Reddit"],"readme":"# Reddsaver ![build](https://github.com/manojkarthick/reddsaver/workflows/build/badge.svg) [![Crates.io](https://img.shields.io/crates/v/reddsaver.svg)](https://crates.io/crates/reddsaver)\n\nCommand line tool to download saved/upvoted media from Reddit.\n\n**Supported sources:**\n| Source | Media types |\n|---|---|\n| Reddit | Images (JPG/PNG), GIFs, image galleries, videos |\n| Imgur | Direct images, GIFVs (downloaded as mp4) |\n| Gfycat / Redgifs | GIFs (downloaded as mp4) |\n| Giphy | GIFs |\n| YouTube | Videos (requires `yt-dlp`) |\n\n\u003e Does *not* support Imgur post/album links — only direct media links.\n\n## Prerequisites\n\n**ffmpeg** — required to merge the separate audio and video streams that Reddit uses for hosted videos.\nInstall from https://www.ffmpeg.org/download.html or via your package manager.\n\n**yt-dlp** — required only if you want to download YouTube videos linked in your saved/upvoted posts.\nInstall from https://github.com/yt-dlp/yt-dlp or via your package manager.\n\n## Installation\n\n### Release binaries\n\nDownload a pre-built binary for your platform from the [releases page](https://github.com/manojkarthick/reddsaver/releases).\n\n### MacPorts\n\n```shell\nsudo port selfupdate\nsudo port install reddsaver\n```\n\n### Homebrew\n\n```shell\nbrew tap manojkarthick/reddsaver\nbrew install reddsaver\n```\n\n### Arch Linux\n\n```shell\nyay -S reddsaver\n```\n\n### cargo\n\n```shell\ncargo install reddsaver\n```\n\n### nix\n\n```shell\nnix-env --install reddsaver\n```\n\nOr via [home-manager](https://github.com/nix-community/home-manager):\n\n```nix\nhome.packages = [ pkgs.reddsaver ];\n```\n\n### Build from source\n\nRequires a current stable Rust toolchain with Cargo support for lock file version 4.\nIf `cargo build` fails with a lock file version error, upgrade Rust and Cargo first.\n\n```shell\ngit clone https://github.com/manojkarthick/reddsaver.git\ncargo build --release\n./target/release/reddsaver\n```\n\n### Docker\n\n```shell\nmkdir -pv data/\ndocker run --rm \\\n    --volume=\"$PWD/data:/app/data\" \\\n    --volume=\"$PWD/reddsaver.env:/app/reddsaver.env\" \\\n    ghcr.io/manojkarthick/reddsaver:latest -d /app/data -e /app/reddsaver.env\n```\n\n## Setup\n\n1. Create a Reddit script application at https://www.reddit.com/prefs/apps\n   - Click **create an app** at the bottom of the page\n   - Give it a name (e.g. `\u003cusername\u003e-reddsaver`)\n   - Choose **script** as the type\n   - Set any redirect URL (e.g. `http://localhost:8080`)\n   - Click **create app** — the string beneath the app name is your **client ID**; the string next to **secret** is your **client secret**\n\n2. Create a `.env` file (e.g. `reddsaver.env`) with your credentials:\n\n```shell\nREDDSAVER_CLIENT_ID='\u003cclient_id\u003e'\nREDDSAVER_CLIENT_SECRET='\u003cclient_secret\u003e'\nREDDSAVER_USERNAME='\u003cusername\u003e'\nREDDSAVER_PASSWORD='\u003cpassword\u003e'\n```\n\n\u003e [!IMPORTANT]\n\u003e Use single quotes for values in the env file, especially if a value contains `$`. Unquoted `$` triggers variable substitution, and double-quoted values containing special characters can be parsed unexpectedly.\n\u003e\n\u003e If you have 2FA enabled: `REDDSAVER_PASSWORD='\u003cpassword\u003e:\u003c2FA_TOTP_token\u003e'`\n\n## Usage\n\n```shell\n# Create a directory to save media to\nmkdir -pv data/\n\n# Verify the configuration is correct\nreddsaver -e reddsaver.env -d data --show-config\n\n# Download saved media\nreddsaver -e reddsaver.env -d data\n\n# Download upvoted media instead\nreddsaver -e reddsaver.env -d data --upvoted\n\n# Dry run — print URLs without downloading\nreddsaver -e reddsaver.env -d data --dry-run\n\n# Restrict to specific subreddits\nreddsaver -e reddsaver.env -d data --subreddits pics,aww,videos\n```\n\nOn subsequent runs, files that already exist in the data directory are skipped automatically.\n\n## Command line reference\n\n```\nReddSaver 1.0.0\nManoj Karthick Selva Kumar\nSimple CLI tool to download saved media from Reddit\n\nUSAGE:\n    reddsaver [FLAGS] [OPTIONS]\n\nFLAGS:\n    -r, --dry-run       Dry run and print the URLs of saved media to download\n    -h, --help          Prints help information\n    -s, --show-config   Show the current config being used\n    -u, --upvoted       Download media from upvoted posts\n    -V, --version       Prints version information\n\nOPTIONS:\n    -d, --data-dir \u003cDATA_DIR\u003e           Directory to save the media to [default: data]\n    -e, --from-env \u003cENV_FILE\u003e           Set a custom .env style file with secrets [default: .env]\n    -S, --subreddits \u003cSUBREDDITS\u003e...    Download media from these subreddits only\n```\n\n## File naming\n\nDownloaded files are named using the format:\n\n```\n{subreddit}/{author}_{post_id}_{index}_{hash8}.{ext}\n```\n\n- **author** — Reddit username of the poster; files sort naturally by user in any file browser\n- **post_id** — base-36 Reddit post ID; use it to navigate directly to the source post\n- **index** — `0` for single media; `0`, `1`, … for gallery items; `component_0`/`component_1` for Reddit videos with separate audio/video tracks\n- **hash8** — first 8 characters of the MD5 hash of the media URL, used as a collision guard\n\nExample: `aww/thunderbird42_abc123_0_f3a8b2c1.jpg`\n\n## Utilities\n\n### parse_file.sh\n\nGiven any file downloaded by reddsaver, prints the subreddit, username, and a direct link to the source Reddit post.\n\n```shell\n./scripts/parse_file.sh data/aww/thunderbird42_abc123_0_f3a8b2c1.jpg\n# Subreddit: aww\n# Username:  thunderbird42\n# Post link: https://www.reddit.com/r/aww/comments/abc123/\n```\n\n## Download summary\n\nAt the end of each run, reddsaver prints a summary broken down by media source:\n\n```\n#####################################\nDownload Summary:\n  Total supported:  467\n  Total downloaded: 459\n  Total skipped:    8\n\n  Source                   | Supported | Downloaded | Skipped\n  -----------------------------------------------------------\n  Imgur GIF                |         8 |          8 |       0\n  Imgur Image              |        48 |         48 |       0\n  Reddit GIF               |        14 |         14 |       0\n  Reddit Image             |       320 |        320 |       0\n  Reddit Video (no audio)  |         3 |          3 |       0\n  Redgifs                  |        74 |         66 |       8\n#####################################\n```\n\nSkipped items are either already present on disk or could not be retrieved (a `WARN` log line is printed for each).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanojkarthick%2Freddsaver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanojkarthick%2Freddsaver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanojkarthick%2Freddsaver/lists"}