{"id":18451734,"url":"https://github.com/skynewz/putio-operator","last_synced_at":"2026-04-30T13:34:12.707Z","repository":{"id":58936237,"uuid":"533344639","full_name":"SkYNewZ/putio-operator","owner":"SkYNewZ","description":"Manage RSS feeds from Kubernetes Custom Resources ","archived":false,"fork":false,"pushed_at":"2024-03-13T21:33:47.000Z","size":182,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T09:19:43.413Z","etag":null,"topics":["kubebuilder","kubernetes","kubernetes-operator","putio"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SkYNewZ.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-09-06T13:46:40.000Z","updated_at":"2022-09-14T13:03:14.000Z","dependencies_parsed_at":"2024-06-21T11:56:47.773Z","dependency_job_id":null,"html_url":"https://github.com/SkYNewZ/putio-operator","commit_stats":{"total_commits":13,"total_committers":1,"mean_commits":13.0,"dds":0.0,"last_synced_commit":"ed4987b7abdf6e015b547ab2033a40d085b7d54e"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkYNewZ%2Fputio-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkYNewZ%2Fputio-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkYNewZ%2Fputio-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkYNewZ%2Fputio-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SkYNewZ","download_url":"https://codeload.github.com/SkYNewZ/putio-operator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249553660,"owners_count":21290273,"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":["kubebuilder","kubernetes","kubernetes-operator","putio"],"created_at":"2024-11-06T07:29:34.987Z","updated_at":"2026-04-30T13:34:12.672Z","avatar_url":"https://github.com/SkYNewZ.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# putio-operator\n\nManage your [Put.io](https://app.put.io/) RSS feeds with Kubernetes Custom Resources.\n\n[![Go](https://github.com/SkYNewZ/putio-operator/actions/workflows/main.yml/badge.svg)](https://github.com/SkYNewZ/putio-operator/actions/workflows/main.yml)\n\n## Usage\n\nBefore creating an RSS feed resource, you must configure a secret containing an OAuth2 token to interact with Put.io\nAPI. You can get one here https://app.put.io/account/api/apps/new.\n\nThen, place the OAuth2 token into a Kubernetes secret. For example:\n\n```\nkubectl -n default create secret generic putio-token --from-literal=token=\u003cyour oauth2 token\u003e\n```\n\nThen, you can create RSS feed by specifying this secret. You can see examples [here](config/samples/_v1alpha1_feed.yaml)\n.\n\n```yaml\napiVersion: putio.skynewz.dev/v1alpha1\nkind: Feed\nmetadata:\n  name: house-of-the-dragons\n  namespace: default\nspec:\n  keyword: \"House.of.the.Dragon.S01E\u0026.MULTi.1080p.WEB.H264-FW\"\n  rss_source_url: \"https://rss.site.fr/rss?id=2184\"\n  title: \"House of the Dragon\"\n  parent_dir_id: 1022542820 # 'House of the Dragon' folder\n  authSecretRef:\n    key: putio-token\n    name: token\n\n```\n\nThe `kubectl get feeds` output will give you\n\n```\nNAME                           KEYWORD                                                                        LAST FETCH   PAUSED   TITLE                           AGE\nhouse-of-the-dragons           House.of.the.Dragon.S01E\u0026.MULTi.1080p.WEB.H264-FW                              20h          true     House of the Dragon             2d2h\n\n```\n\n## Getting Started\n\nYou’ll need a Kubernetes cluster to run against. You can use [KIND](https://sigs.k8s.io/kind) to get a local cluster for\ntesting, or run against a remote cluster.\n**Note:** Your controller will automatically use the current context in your kubeconfig file (i.e. whatever\ncluster `kubectl cluster-info` shows).\n\n### Running on the cluster\n\n1. Install Instances of Custom Resources:\n\n```sh\nkubectl apply -f config/samples/\n```\n\n2. Build and push your image to the location specified by `IMG`:\n\n```sh\nmake docker-build docker-push IMG=\u003csome-registry\u003e/putio-operator:tag\n```\n\n3. Deploy the controller to the cluster with the image specified by `IMG`:\n\n```sh\nmake deploy IMG=\u003csome-registry\u003e/putio-operator:tag\n```\n\n### Uninstall CRDs\n\nTo delete the CRDs from the cluster:\n\n```sh\nmake uninstall\n```\n\n### Undeploy controller\n\nUnDeploy the controller to the cluster:\n\n```sh\nmake undeploy\n```\n\n## License\n\nCopyright 2022 Quentin Lemaire \u003cquentin@lemairepro.fr\u003e.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskynewz%2Fputio-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskynewz%2Fputio-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskynewz%2Fputio-operator/lists"}