{"id":26154201,"url":"https://github.com/siakhooi/image-sitter","last_synced_at":"2026-06-17T20:05:29.825Z","repository":{"id":167234880,"uuid":"601598142","full_name":"siakhooi/image-sitter","owner":"siakhooi","description":"collection of bash scripts to maintain docker images.","archived":false,"fork":false,"pushed_at":"2026-06-03T02:34:24.000Z","size":4236,"stargazers_count":1,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-03T04:22:36.137Z","etag":null,"topics":["active","apt","bash"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/siakhooi.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-14T12:12:59.000Z","updated_at":"2026-06-03T02:34:23.000Z","dependencies_parsed_at":"2023-11-16T10:31:19.835Z","dependency_job_id":"5dcd0882-45df-471b-8ecc-ff2b674a3954","html_url":"https://github.com/siakhooi/image-sitter","commit_stats":null,"previous_names":["siakhooi/image-sitter"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/siakhooi/image-sitter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siakhooi%2Fimage-sitter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siakhooi%2Fimage-sitter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siakhooi%2Fimage-sitter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siakhooi%2Fimage-sitter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siakhooi","download_url":"https://codeload.github.com/siakhooi/image-sitter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siakhooi%2Fimage-sitter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34463560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"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":["active","apt","bash"],"created_at":"2025-03-11T08:21:51.802Z","updated_at":"2026-06-17T20:05:29.809Z","avatar_url":"https://github.com/siakhooi.png","language":"Shell","funding_links":["https://www.buymeacoffee.com/siakhooi","https://ko-fi.com/siakhooi"],"categories":[],"sub_categories":[],"readme":"# Image Sitter\n\nPrograms to take care of your container images. It helps to ensure you have an up to date local cache of the docker images that are frequently used.\n\n## Introduction\n\nBy maintaining the docker url in several files, categorize into groups, and 3 predefined subgroups, which are 'pull-always', 'pull-if-not-exists', and 'delete-if-exists'.\n`image-sitter` programs will do the necessary pull or delete when they are triggered.\n\n## Format of files\n\n- Each line of a file is a docker url, such as: nginx:latest.\n- lines started with # will be ignored.\n- blank lines will also be ignored.\n\n## Commands\n\n```bash\nimage-sitter-init group\nimage-sitter group [group ...]\nimage-sitter-pull-always group [group ...]\nimage-sitter-pull-if-not-exists group [group ...]\nimage-sitter-delete-if-exists group [group ...]\n```\n\n## Sample\n\n![sample](sample.gif \"Sample\")\n\n## Quick Start\n\n### Installation\n\n- Pre-requisite\n  - yq \u003chttps://github.com/mikefarah/yq\u003e\n  - docker \u003chttps://docs.docker.com/engine/install/\u003e\n\n```bash\n$ sudo curl -L https://siakhooi.github.io/apt/siakhooi-apt.list | sudo tee /etc/apt/sources.list.d/siakhooi-apt.list \u003e /dev/null\n$ sudo curl -L https://siakhooi.github.io/apt/siakhooi-apt.gpg  | sudo tee /usr/share/keyrings/siakhooi-apt.gpg \u003e /dev/null\n$ sudo apt update\n$ sudo apt install siakhooi-image-sitter\n```\n\n- To setup bash completion, add the following code in `~/.bashrc` file.\n\n```bash\nsource \u003c(image-sitter-completion)\n```\n\n### Using Image Sitter\n\n```bash\n# create the group\nimage-sitter-init quick-start-1\n\n# pull images\nimage-sitter quick-start-1\n```\n\n## Directory structure\n\n```txt\n~/.image-sitter/\n   + group1/\n      + pull-always/\n         + file1.txt\n         + file2.txt\n         + ...\n      + pull-if-not-exists/\n         + file1.txt\n         + file2.txt\n         + ...\n      + delete-if-exists/\n         + file1.txt\n         + file2.txt\n         + ...\n   + group2/\n      + pull-always/\n         + file1.txt\n         + file2.txt\n         + ...\n      + pull-if-not-exists/\n         + file1.txt\n         + file2.txt\n         + ...\n      + delete-if-exists/\n         + file1.txt\n         + file2.txt\n         + ...\n   + ...\n```\n\n## Deployments\n\n- \u003chttps://siakhooi.github.io/apt/\u003e\n\n## Badges\n\n![GitHub](https://img.shields.io/github/license/siakhooi/image-sitter?logo=github)\n![GitHub last commit](https://img.shields.io/github/last-commit/siakhooi/image-sitter?logo=github)\n![GitHub tag (latest by date)](https://img.shields.io/github/v/tag/siakhooi/image-sitter?logo=github)\n![GitHub issues](https://img.shields.io/github/issues/siakhooi/image-sitter?logo=github)\n![GitHub closed issues](https://img.shields.io/github/issues-closed/siakhooi/image-sitter?logo=github)\n![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/siakhooi/image-sitter?logo=github)\n![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed-raw/siakhooi/image-sitter?logo=github)\n![GitHub top language](https://img.shields.io/github/languages/top/siakhooi/image-sitter?logo=github)\n![GitHub language count](https://img.shields.io/github/languages/count/siakhooi/image-sitter?logo=github)\n![Lines of code](https://img.shields.io/tokei/lines/github/siakhooi/image-sitter?logo=github)\n![GitHub repo size](https://img.shields.io/github/repo-size/siakhooi/image-sitter?logo=github)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/siakhooi/image-sitter?logo=github)\n![Workflow](https://img.shields.io/badge/Workflow-github-purple)\n![workflow](https://github.com/siakhooi/image-sitter/actions/workflows/workflow-build-with-quality-checks.yml/badge.svg)\n![workflow](https://github.com/siakhooi/image-sitter/actions/workflows/workflow-deployments.yml/badge.svg)\n![Release](https://img.shields.io/badge/Release-github-purple)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/siakhooi/image-sitter?label=GPR%20release\u0026logo=github)\n![GitHub all releases](https://img.shields.io/github/downloads/siakhooi/image-sitter/total?color=33cb56\u0026logo=github)\n![GitHub Release Date](https://img.shields.io/github/release-date/siakhooi/image-sitter?logo=github)\n\n[![Generic badge](https://img.shields.io/badge/Funding-BuyMeACoffee-33cb56.svg)](https://www.buymeacoffee.com/siakhooi)\n[![Generic badge](https://img.shields.io/badge/Funding-Ko%20Fi-33cb56.svg)](https://ko-fi.com/siakhooi)\n![visitors](https://hit-tztugwlsja-uc.a.run.app/?outputtype=badge\u0026counter=ghmd-image-sitter)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiakhooi%2Fimage-sitter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiakhooi%2Fimage-sitter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiakhooi%2Fimage-sitter/lists"}