{"id":32544443,"url":"https://github.com/cdzombak/flickr-rss","last_synced_at":"2025-10-28T17:59:33.764Z","repository":{"id":304884442,"uuid":"1020416576","full_name":"cdzombak/flickr-rss","owner":"cdzombak","description":"Generate an RSS feed of a Flickr photostream or your Friends \u0026 Family feed","archived":false,"fork":false,"pushed_at":"2025-09-25T13:06:22.000Z","size":546,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-23T21:41:32.363Z","etag":null,"topics":["flickr","rss"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cdzombak.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,"zenodo":null}},"created_at":"2025-07-15T20:48:59.000Z","updated_at":"2025-09-25T13:06:19.000Z","dependencies_parsed_at":"2025-07-17T01:33:11.267Z","dependency_job_id":"e9a614f6-04c4-4e19-8eab-4e46c897f9e2","html_url":"https://github.com/cdzombak/flickr-rss","commit_stats":null,"previous_names":["cdzombak/flickr-rss"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/cdzombak/flickr-rss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fflickr-rss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fflickr-rss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fflickr-rss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fflickr-rss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdzombak","download_url":"https://codeload.github.com/cdzombak/flickr-rss/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fflickr-rss/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281485702,"owners_count":26509764,"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","status":"online","status_checked_at":"2025-10-28T02:00:06.022Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["flickr","rss"],"created_at":"2025-10-28T17:59:32.587Z","updated_at":"2025-10-28T17:59:33.757Z","avatar_url":"https://github.com/cdzombak.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flickr-rss\n\nGenerate an RSS feed of a Flickr user's photostream or your Flickr Friends \u0026 Family feed.\n\n## Features\n\n- **User feeds**: Generate RSS feeds from any Flickr user's photos\n  - **Public photos only** when using API key alone\n  - **Includes friends/family photos** if you're in their network (requires OAuth)\n- **Friends \u0026 family feeds**: Generate feeds from your friends \u0026 family timeline (requires OAuth)\n- **Clean, high-res output:** output RSS items contain the Large-size image only; the image is also attached as an RSS Enclosure\n- Output to stdout or save to file\n\n## Usage\n\n### User Feeds\n\nGenerate RSS feeds from any Flickr user's photos:\n\n```bash\n# Public photos only (API key sufficient)\nflickr-rss generate username -c creds.yml\n\n# Include friends/family photos (if you're their friend/family; requires OAuth authentication)\nflickr-rss generate username -c creds-with-oauth.yml\n\n# Using user ID or profile URL\nflickr-rss generate 12345678@N00 -c creds.yml\nflickr-rss generate \"https://www.flickr.com/photos/username/\" -c creds.yml\n\n# Specify number of photos (default: 20)\nflickr-rss generate username --count 100 -c creds.yml\n\n# Save to file\nflickr-rss generate username -c creds.yml -o feed.xml\n```\n\n**Note**: If you're authenticated (have OAuth tokens) and are friends/family with the user, their private photos shared with you will be included in the feed. Without authentication, or if you're not in the target user's friends/family, only public photos are included.\n\n### Friends \u0026 Family Feeds\n\nGenerate feeds from your friends \u0026 family timeline (requires OAuth authentication):\n\n```bash\n# Friends \u0026 family feed\nflickr-rss generate -ff -c creds.yml\n\n# Specify count for friends \u0026 family (max 50 photos)\nflickr-rss generate -ff --count 30 -c creds.yml\n```\n\n### Authentication\n\n1. **Get API credentials**: Visit [Flickr App Garden](https://www.flickr.com/services/apps/create/) and create a non-commercial API key\n\n2. **Create credentials file**, then stop here if you don't need OAuth creds:\n```yaml\n# creds.yml\napi_key: your_api_key_here\napi_secret: your_api_secret_here\n```\n\n3. **Authenticate via OAuth**:\n```bash\n# Authenticate via OAuth to get your OAuth credentials:\nflickr-rss auth --api-key YOUR_API_KEY --api-secret YOUR_API_SECRET --save-creds creds.yml\n```\n\n### Reference\n\n```\nflickr-rss generate [username|userid|profile_url]\n```\n\nGenerate RSS feed for a Flickr user or friends \u0026 family timeline.\n\n**Flags:**\n- `-ff, --friends-family`: Generate friends \u0026 family feed instead of user feed\n- `--count`: Number of photos to include (default: 20, max 50 for friends \u0026 family)\n- `-c, --creds-file`: Path to YAML credentials file\n- `-o, --output`: Output file (default: stdout)\n- `-v, --verbose`: Verbose output\n\n```\nflickr-rss auth\n```\n\nAuthenticate with Flickr OAuth and save credentials.\n\n**Flags:**\n- `--api-key`: Flickr API key\n- `--api-secret`: Flickr API secret\n- `--save-creds`: Save credentials to specified YAML file\n\n## Installation\n\n### macOS via Homebrew\n\n```shell\nbrew install cdzombak/oss/flickr-rss\n```\n\n### Debian via apt repository\n\n[Install my Debian repository](https://www.dzombak.com/blog/2025/06/updated-instructions-for-installing-my-debian-package-repositories/) if you haven't already:\n\n```shell\nsudo mkdir -p /etc/apt/keyrings\ncurl -fsSL https://dist.cdzombak.net/keys/dist-cdzombak-net.gpg -o /etc/apt/keyrings/dist-cdzombak-net.gpg\nsudo chmod 644 /etc/apt/keyrings/dist-cdzombak-net.gpg\nsudo mkdir -p /etc/apt/sources.list.d\nsudo curl -fsSL https://dist.cdzombak.net/cdzombak-oss.sources -o /etc/apt/sources.list.d/cdzombak-oss.sources\nsudo chmod 644 /etc/apt/sources.list.d/cdzombak-oss.sources\nsudo apt update\n```\n\nThen install `flickr-rss` via `apt-get`:\n\n```shell\nsudo apt-get install flickr-rss\n```\n\n### Manual installation from build artifacts\n\nPre-built binaries for Linux and macOS on various architectures are downloadable from each [GitHub Release](https://github.com/cdzombak/flickr-rss/releases). Debian packages for each release are available as well.\n\n### Build and install locally\n\n```shell\ngit clone https://github.com/cdzombak/flickr-rss.git\ncd flickr-rss\nmake build\n\ncp out/flickr-rss $INSTALL_DIR\n```\n\n## Docker images\n\nDocker images are available for a variety of Linux architectures from [Docker Hub](https://hub.docker.com/r/cdzombak/flickr-rss) and [GHCR](https://github.com/cdzombak/dirshard/pkgs/container/flickr-rss). Images are based on the `scratch` image and are as small as possible.\n\nRun them via, for example:\n\n```shell\ndocker run --rm cdzombak/flickr-rss:1 [OPTIONS]\ndocker run --rm ghcr.io/cdzombak/flickr-rss:1 [OPTIONS]\n```\n\n## License\n\nGNU General Public License v3.0; see [LICENSE](LICENSE) in this repository.\n\n## Author\n\n[Claude Code](https://www.anthropic.com/claude-code) wrote this code with management by Chris Dzombak ([dzombak.com](https://www.dzombak.com) / [github.com/cdzombak](https://www.github.com/cdzombak)).\n\n\u003cbr /\u003e\u003cbr /\u003e![I believe in RSS](i%20believe%20in%20rss.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdzombak%2Fflickr-rss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdzombak%2Fflickr-rss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdzombak%2Fflickr-rss/lists"}