{"id":29554923,"url":"https://github.com/dawedawe/ferriby","last_synced_at":"2025-07-18T08:10:31.891Z","repository":{"id":303206169,"uuid":"1000493126","full_name":"dawedawe/ferriby","owner":"dawedawe","description":"Keep Ferris alive by contributing to a git repo","archived":false,"fork":false,"pushed_at":"2025-07-13T22:17:19.000Z","size":474,"stargazers_count":33,"open_issues_count":3,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-14T00:19:50.017Z","etag":null,"topics":["gamification","git","github","ratatui","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/dawedawe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["dawedawe"]}},"created_at":"2025-06-11T21:51:57.000Z","updated_at":"2025-07-13T22:17:19.000Z","dependencies_parsed_at":"2025-07-14T00:09:10.916Z","dependency_job_id":null,"html_url":"https://github.com/dawedawe/ferriby","commit_stats":null,"previous_names":["dawedawe/ferriby"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/dawedawe/ferriby","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawedawe%2Fferriby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawedawe%2Fferriby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawedawe%2Fferriby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawedawe%2Fferriby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dawedawe","download_url":"https://codeload.github.com/dawedawe/ferriby/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dawedawe%2Fferriby/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265726033,"owners_count":23818111,"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":["gamification","git","github","ratatui","rust"],"created_at":"2025-07-18T08:10:31.059Z","updated_at":"2025-07-18T08:10:31.877Z","avatar_url":"https://github.com/dawedawe.png","language":"Rust","readme":"# ferriby\n\nKeep Ferrises alive and happy by feeding them commits in your repositories.  \nThey can live in a local, a GitHub or a Codeberg repository.\n\n![Ferriby demo recording](./vhs/ferriby.gif)\n\n## Usage\n\n```shell\nferriby -gh owner/repository\n```\n\n```shell\nferriby -g path_to_local_repository\n```\n\n```shell\nferriby -cb owner/repository\n```\n\nYou can use ferriby with multiple repositories at once:\n\n```shell\nferriby -g local_path -gh owner/repo -g other_path -gh ...\n```\n\nUse a custom config file path:\n\n```shell\nferriby -c config_file.json\n```\n\n## Installation\n\nYou can install ferriby from [crates.io](https://crates.io/crates/ferriby):\n\n```shell\ncargo install ferriby\n```\n\nOn Arch Linux, you can install it from the [AUR](https://aur.archlinux.org/packages/ferriby):\n\n```shell\nparu -S ferriby\n```\n\n## Configuration\n\nTo access private GitHub repos and to have a higher rate limit for the checks,\nyou can pass a PAT (Personal Access Token) to ferriby via the environment variable `FERRIBY_GH_PAT`.  \nCreate your PAT in the [settings section](https://github.com/settings/personal-access-tokens) with `Repository permissions` of `Read`.\nTest it with\n\n```shell\nFERRIBY_GH_PAT=\"xyz\" ferriby -gh owner/repository\n```\n\nIt is strongly recommended to do this. Otherwise you are rate limited to 60 checks per hour.\n\n\nferriby looks for a config file in `$HOME/.config/ferriby/config.json` (`$HOME/AppData/Roaming/ferriby/config.json` on Windows).\nYou can override that path with the `-c` argument.\nThe config file should look like this:\n\n```json\n{\n  \"git\": [\n    \"/home/dawe/src/ferriby\",\n    \"/home/dawe/src/tusistor\"\n  ],\n  \"github\": [\n    \"dawedawe/ratatui\",\n    \"dawedawe/ratzilla\"\n  ],\n  \"codeberg\": [\n    \"dawe/ferriby\"\n  ]\n}\n```\n\nAt least one repository needs to be configured. The json needs to be clean, no trailing commas allowed.\n\n## Advisory\n\nThis is gamification. If you have a human to love or a dog to walk, do that!\n\n## Credits\n\nThe ASCII art is based on work by [Diggory Blake](https://github.com/diggsey). Thanks!\n\nThis is a [Ratatui] app generated by the [event driven async template].\n\n[Ratatui]: https://ratatui.rs\n[event driven async template]: https://github.com/ratatui/templates/tree/main/event-driven-async\n\n## License\n\nCopyright (c) dawe \u003cdawedawe@posteo.de\u003e\n\nThis project is licensed under the MIT license ([LICENSE] or \u003chttp://opensource.org/licenses/MIT\u003e)\n\n[LICENSE]: ./LICENSE\n","funding_links":["https://github.com/sponsors/dawedawe"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawedawe%2Fferriby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdawedawe%2Fferriby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawedawe%2Fferriby/lists"}