[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/loranmutafov/gitwatch/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","loranmutafov","reponame","gitwatch","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2021-04-10T17:10:49.613613Z","description","","is_private","last_updated","2021-04-10T17:21:32.117802Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",103,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","\n\n\n\n * [gitwatch](#gitwatch)\n * [What to use it for?](#what-to-use-it-for)\n * [Installation](#installation)\n * [From Source](#from-source)\n * [Update](#update)\n * [bpkg](#bpkg)\n * [Archlinux](#archlinux)\n * [Requirements](#requirements)\n * [Notes for Mac](#notes-for-mac)\n * [What it does](#what-it-does)\n * [Usage](#usage)\n * [Starting on Boot](#starting-on-boot)\n * [SysVInit](#sysvinit)\n * [systemd](#systemd)\n * [Other Articles](#other-articles)\n * [On the Gitwatch Wiki](#on-the-gitwatch-wiki)\n\n\n\n\n\n# gitwatch\n\nA bash script to watch a file or folder and commit changes to a git repo\n\n## What to use it for?\n\nThat's really up to you, but here are some examples:\n\n* **config files**: some programs auto-write their config files, without\n waiting for you to click an 'Apply' button; or even if there is such\n a button, most programs offer you no way of going back to an earlier\n version of your settings. If you commit your config file(s) to a git repo,\n you can track changes and go back to older versions. This script makes it\n convenient, to have all changes recorded automatically.\n* **document files**: if you use an editor that does not have built-in git\n support (or maybe if you don't like the git support it has), you can use\n gitwatch to automatically commit your files when you save them, or combine\n it with the editor's auto-save feature to fully automatically and regularly\n track your changes\n* *more stuff!* If you have any other uses, or can think of ones, please let\n us know, and we can add them to this list!\n\n## Installation\n\n`gitwatch` can be installed in various ways.\n\n### From Source\n\n`gitwatch` can be installed from source by simply cloning the repository and\nputting the shell script into your `$PATH`. The commands below will do that\nfor you if `/usr/local/bin` is in your `$PATH`. You may need to invoke\n`install` with `sudo`.\n\n```sh\ngit clone https://github.com/gitwatch/gitwatch.git\ncd gitwatch\n[sudo] install -b gitwatch.sh /usr/local/bin/gitwatch\n```\n\n#### Update\n\nIf you installed `gitwatch` from source, you can update it by following the\nexact same steps (or `git pull` rather than clone if you kept the repository\naround).\n\n### bpkg\n\n`gitwatch` can be installed with [bpkg](https://github.com/bpkg/bpkg). Make\nsure you have [bpkg](https://github.com/bpkg/bpkg) installed before running\nthe command below. You may need to invoke `bpkg` with `sudo` when using the\n`-g` flag.\n\n```sh\n[sudo] bpkg install -g gitwatch/gitwatch\n```\n\n### Archlinux\n\nThere is an [AUR](https://aur.archlinux.org/packages/gitwatch-git/) package\nfor Archlinux. Install it with you favorite aur helper.\n\n## Requirements\n\nTo run this script, you must have installed and globally available:\n\n* `git` ([git/git](https://github.com/git/git) | [git-scm](http://www.git-scm.com))\n* `inotifywait` (part of **[inotify-tools](https://github.com/rvoicilas/inotify-tools)**)\n\n### Notes for Mac\n\nIf running on OS X, you'll need to install the following Homebrew tools:\n\n```sh\nbrew install fswatch\nbrew install coreutils\n```\n\n## What it does\n\nWhen you start the script, it prepares some variables and checks if the file\n[a] or directory [b] given as input really exists.\n\nThen it goes into the main loop (which will run forever, until the script is\nforcefully stopped/killed), which will:\n\n* watch for changes to the file/directory using `inotifywait` (`inotifywait`\n will block until something happens)\n* wait 2 seconds\n* `cd` into the directory [b] / the directory containing the file [a]\n \\(because `git` likes to operate locally)\n* `git add `[a] / `git add .`[b]\n* `git commit -m \"Scripted auto-commit on change ()\"`[a] / `git commit\n\n -a -m\"Scripted auto-commit on change ()\"`[b]\n\n* if a remote is defined (with `-r`) do a push after the commit (a specific\n branch can be selected with `-b`)\n\nNotes:\n\n* the waiting period of 2 sec is added to allow for several changes to be\n written out completely before committing; depending on how fast the script\n is executed, this might otherwise cause race conditions when watching\n a folder\n* currently, folders are always watched recursively\n\n## Usage\n\n`gitwatch.sh [-r [-b ]] `\n\nIt is expected that the watched file/directory are already in a git repository\n(the script will not create a repository). If a folder is being watched, this\nwill be watched fully recursively; this also means that all files and\nsub-folders added and removed from the directory will always be added and\nremoved in the next commit. The `.git` folder will be excluded from the\n`inotifywait` call so changes to it will not cause unnecessary triggering of\nthe script.\n\nIf you have any large files in your repository that are changing frequently,\nyou might wish to ignore them with a `.gitignore` file.\n\n### Starting on Boot\n\nIf you want to have the script auto-started upon boot, the method to do this\ndepends on your operating system and distribution. If you have a GUI dialog to\nset up startup launches, you might want to use that, so you can more easily\nfind and change the startup script calls later on.\n\nPlease also note that if either of the paths involved (script or target)\ncontains spaces or special characters, you need to escape them accordingly; if\nyou don't know how to do that, the internet will help you, or feel free to ask\nhere or contact me directly.\n\n#### SysVInit\n\nA central place to put startup scripts on Linux is generally `/etc/rc.local`\n(to my knowledge; only tested and confirmed on Ubuntu). This file, if it has\nthe +x bit, will be executed upon startup, **by the root user account**. If\nyou want to start `gitwatch` from `rc.local`, the recommended way to call it\nis:\n\n\n`su -c \"/absolute/path/to/script/gitwatch.sh /absolute/path/to/watched/file/or/folder\" -l &`\n\n\nThe `` bit should be replaced with your username or that of any\nother (non-root) user account; it only needs write-access to the git\nrepository of the file/folder you want to watch. The ampersand (`&`) at the\nend sends the launched process into the background (this is important if you\nhave other calls in `rc.local` after the mentioned line, because the\n`gitwatch` call does not usually return).\n\n#### systemd\n\n* If installed to a path other than `/usr/bin/gitwatch`, modify\n `gitwatch@.service` to suit\n* Create dir if it does not exist and copy systemd service file with `mkdir -p\n \"$HOME/.config/systemd/user\" && cp gitwatch@.service\n $HOME/.config/systemd/user`\n* Start and enable the service for a given path by running `systemctl --user\n --now enable gitwatch@$(systemd-escape \"'-r url/to/repository'\n /path/to/folder\").service`\n\n## Other Articles\n\n### On the Gitwatch Wiki\n\n* [How to install `gitwatch` as a Debian service with `supervisord`](https://github.com/gitwatch/gitwatch/wiki/gitwatch-as-a-service-on-Debian-with-supervisord)\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",14460796,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",3005555,"full_size",14457348,"id",145061524,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:4dbf4b584729c5741ece95a26d275a83bebf9944fb1569e41409114c755a81a8","features","last_pulled","2026-09-20T06:30:31.755101935Z","last_pushed","2021-04-10T17:21:32Z","os","linux","os_features","os_version","size","variant","2021-04-10T17:21:31.800138Z","last_updater","last_updater_username","media_type","v0.1.2","repository",12253157,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

loranmutafov/gitwatch

Tags for loranmutafov/gitwatch