{"id":13503825,"url":"https://github.com/kimono-koans/httm","last_synced_at":"2025-05-13T16:06:39.735Z","repository":{"id":37028882,"uuid":"467297999","full_name":"kimono-koans/httm","owner":"kimono-koans","description":"Interactive, file-level Time Machine-like tool for ZFS/btrfs/nilfs2 (and even Time Machine and Restic backups!)","archived":false,"fork":false,"pushed_at":"2025-05-10T20:51:32.000Z","size":3900,"stargazers_count":1477,"open_issues_count":5,"forks_count":31,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-10T21:32:07.367Z","etag":null,"topics":["btrfs","btrfs-snapshots","cli","command-line","command-line-tool","freebsd","homelab","linux","nilfs","restic","rust","shell","terminal","unix","unix-command","unix-shell","zfs","zfs-snapshots","zfsonroot","zsh"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/httm","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kimono-koans.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":"2022-03-07T23:50:50.000Z","updated_at":"2025-05-10T21:30:33.000Z","dependencies_parsed_at":"2022-07-30T18:08:03.236Z","dependency_job_id":"98f8e528-4251-4a99-a86f-fffb9b4c971f","html_url":"https://github.com/kimono-koans/httm","commit_stats":{"total_commits":3897,"total_committers":5,"mean_commits":779.4,"dds":"0.39697202976648704","last_synced_commit":"aae75f101ed65440ae4671fb8b156765a141cb6a"},"previous_names":[],"tags_count":234,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimono-koans%2Fhttm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimono-koans%2Fhttm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimono-koans%2Fhttm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kimono-koans%2Fhttm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kimono-koans","download_url":"https://codeload.github.com/kimono-koans/httm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253486623,"owners_count":21916137,"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":["btrfs","btrfs-snapshots","cli","command-line","command-line-tool","freebsd","homelab","linux","nilfs","restic","rust","shell","terminal","unix","unix-command","unix-shell","zfs","zfs-snapshots","zfsonroot","zsh"],"created_at":"2024-07-31T23:00:46.016Z","updated_at":"2025-05-13T16:06:39.709Z","avatar_url":"https://github.com/kimono-koans.png","language":"Rust","funding_links":[],"categories":["Rust","Applications","🛠️ ZFS tools","cli","Miscellaneous","FileSystem"],"sub_categories":["System tools","ZFS Backup tools"],"readme":"[![asciicast](https://asciinema.org/a/637475.svg)](https://asciinema.org/a/637475)\n\n# `httm`\n\n*The dream of a CLI Time Machine is still alive with `httm`.*\n\n`httm` prints the size, date and corresponding locations of available unique versions (deduplicated by modify time and size) of files residing on snapshots, but can also be used *interactively* to select and restore files, even snapshot mounts by file! `httm` might change the way you use snapshots (because ZFS/BTRFS/NILFS2 aren't designed to find unique file versions) or the Time Machine concept (because `httm` is very fast!).\n\n`httm` boasts an array of seductive features, like:\n\n* Search for versions of multiple files on distinct datasets simultaneously\n* Search for and recursively list deleted files.  *Even browse files hidden behind deleted directories*.\n* List file snapshots from *all* local pools (detect local snapshot versions *as well as* locally replicated snapshot versions)!\n* List file snapshots from remote backup pools (even overlay replicated remote snapshot directories over live directories).\n* For use with `rsync`-ed non-ZFS/BTRFS/NILFS2/APFS local datasets (like ext4, XFS, or NTFS), not just ZFS/BTRFS/NILFS2 snapshots and TM backups.\n* Optionally preview snapshot file versions with a custom command (default is a `diff` compare to the live version)\n* List or even snapshot the mounts for a file directly\n* Roll *forward* to a previous snapshots, instead of rolling back (avoids destroying interstitial snapshots)\n* Guard any restore actions with precautionary snapshots\n* List snapshot names, even prune snapshots, which include a file name\n* Shortcut features: only display last snapshot, omit duplicates of the live file, etc.\n* Verification level: Like `rsync`, `httm` can determine whether file is unique based solely on metadata, or use checksums\n* 4 native interactive modes: browse, select, prune and restore\n* ANSI `ls` colors from your environment\n* Detect and display categories of unique file versions available (`multiple`, `single`, `single-with-snap`,..., etc.)\n* Select from several formatting styles (newline, null, tab delimited, JSON, CSV, etc.).  Parseable ... or not ...  oh my!\n* Packaged scripts which help you, and show you how to, use `httm`: [ounce](https://github.com/kimono-koans/httm/blob/master/scripts/ounce.bash), [bowie](https://github.com/kimono-koans/httm/blob/master/scripts/bowie.bash), [equine](https://github.com/kimono-koans/httm/blob/master/scripts/equine.bash), and [nicotine](https://github.com/kimono-koans/httm/blob/master/scripts/nicotine.bash)\n* Supports ZFS/BTRFS/NILFS2 snapshots, and Restic and Time Machine backups!\n\nUse in combination with you favorite shell's hot keys for even more fun.\n\nInspired by the [findoid](https://github.com/jimsalterjrs/sanoid) script, [fzf](https://github.com/junegunn/fzf), [skim](https://github.com/lotabout/skim) and many [zsh](https://www.zsh.org) key bindings.\n\n## Install via Native Packages\n\nFor Debian-based distributions (like Ubuntu), I maintain an (unsupported) personal package archive, or PPA.  See the [linked repository](https://github.com/kimono-koans/ppa).\n\nFor Debian-based and Redhat-based Linux distributions (like Ubuntu or Fedora, etc.), also check the [tagged releases](https://github.com/kimono-koans/httm/tags) for native packages for your distribution.  For Redhat-based Linux distributions, you may need to use the `--replacefiles` option when installing via `rpm -i`, see the linked [issue](https://github.com/kimono-koans/httm/issues/51).\n\nYou may also create and install your own native package from the latest sources, for Debian-based and Redhat-based Linux distributions, like so:\n\n```bash\n#!/bin/bash\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\ncargo install cargo-deb \ngit clone https://github.com/kimono-koans/httm.git\ncd ./httm/; cargo deb\n# to install on a Debian/Ubuntu-based system\ndpkg -i ./target/debian/httm_*.deb\n# or convert to RPM \nalien -r ./target/debian/httm_*.deb\n# and install on a Redhat-based system\nrpm -i --replacefiles ./httm_*.rpm\n```\n\nFor Arch-based Linux distributions, you can create and install your own native package from the latest sources, like so:\n\n```bash\n#!/bin/bash\n# warning: this is only an example PKGBUILD\n# you may need to edit the example, as needed, to conform to the latest release\nwget https://raw.githubusercontent.com/kimono-koans/httm/master/packaging/arch/example/PKGBUILD\nmakepkg -si\n```\n\nFor MacOS users, a user from the community (very exciting) has posted a [formulae](https://formulae.brew.sh/formula/httm) for [Homebrew](https://brew.sh).\n\n## Install via Source\n\nInstallation via a package is suggested for support purposes, but, those *wild childs*, who perhaps can't stop (or won't stop), they can install by piping a script to `bash`:\n\n```bash\nbash -c \"$(curl -fsSL https://raw.githubusercontent.com/kimono-koans/httm/master/packaging/install-from-source.bash)\"\n```\n\nFor those who simply wish to build `httm` incrementally themselves, the project contains only a few components:\n\n1. The `httm` executable.  To build and install:\n\n    ```bash\n    #!/bin/bash\n    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n    latest=\"(wget -nv -O - \"https://api.github.com/repos/kimono-koans/httm/releases/latest\" 2\u003e/dev/null | grep tag_name | cut -d: -f2 | cut -d'\"' -f2)\"\n    # cargo-install places a release binary in your $HOME/.cargo/bin, however, \n    # you may wish to: cp $HOME/.cargo/bin/httm /usr/local/bin/httm; cargo uninstall httm\n    cargo install --locked --git https://github.com/kimono-koans/httm.git --tag \"$latest\"\n    ```\n\n2. The optional `zsh` hot-key bindings: Use `ESC+s` to select snapshots filenames to be dropped to your command line (for instance after the `cat` command), or use `ESC+m` to browse for all of a file's snapshots. After you install the `httm` binary, to copy the hot key script to your home directory, and source that script within your `.zshrc`:\n\n    ```bash\n    ➜ httm --install-zsh-hot-keys\n    ```\n\n3. The optional `man` page: `cargo` has no native facilities for man page installation (though it may in the future!).  You can use `manpath` to see the various directories your system uses and decide which directory works best for you.  To install, just copy it to a directory in your `man` path, like so:\n\n    ```bash\n    ➜ cp ./httm/httm.1 /usr/local/share/man/man1/\n    ```\n\n4. The optional scripts.  See script usage below, in the Example Usage section, or follow the links ([ounce](https://github.com/kimono-koans/httm/blob/master/scripts/ounce.bash), [bowie](https://github.com/kimono-koans/httm/blob/master/scripts/bowie.bash), [equine](https://github.com/kimono-koans/httm/blob/master/scripts/equine.bash), and [nicotine](https://github.com/kimono-koans/httm/blob/master/scripts/nicotine.bash)), for more information.  To install, just copy it to a directory in your path, like so:\n\n    ```bash\n    #!/bin/bash\n    cp ./httm/scripts/ounce.bash /usr/local/bin/ounce\n    # bowie is \"required\" for the default/best \"--preview\" behavior\n    cp ./httm/scripts/bowie.bash /usr/local/bin/bowie\n    # equine is \"required\" for Time Machine support on MacOS\n    cp ./httm/scripts/equine.bash /usr/local/bin/equine\n    cp ./httm/scripts/nicotine.bash /usr/local/bin/nicotine\n    chmod +x /usr/local/bin/bowie /usr/local/bin/ounce /usr/local/bin/equine /usr/local/bin/nicotine\n    ```\n\n### Caveats\n\nRight now, you will probably need to use a Unix-ish-y Rust-supported platform to build and install (that is: only Linux, FreeBSD, and MacOS are *known* to work).  Note, your platform *does not* need to support ZFS/BTRFS/NILFS2 snapshots or TM backups to use `httm`.  And there is no fundamental reason a non-interactive Windows version of `httm` could not be built, as it once did build, but Windows platform support is not a priority for me right now.  Contributions from users are, of course, very welcome.\n\nOn FreeBSD, after a fresh minimal install, the interactive modes may not render properly, see the linked [issue](https://github.com/kimono-koans/httm/issues/20) for the fix.\n\nOn some Linux distributions, which include old versions of `libc`, `cargo` may require building with `musl` instead, see the linked [issue](https://github.com/kimono-koans/httm/issues/17).\n\n## Example Usage\n\nNote: Users may need to use `sudo` (or equivalent) to view versions on BTRFS or NILFS2 datasets, or Restic repositories, as BTRFS or NILFS2 snapshots or Restic repositories may require root permissions in order to be visible.  Restic and Time Machine backups also require an additional flag, see further discussion of Restic `--alt-store` in the below.\n\nLike other UNIX utilities (such as `cat`, `uniq`, `sort`), if you include no path/s as arguments, then `httm` will pause waiting for input on stdin:\n\n```bash\n# Press CTRL+C to send a SIGINT and quit the program\n➜ httm \n# Pipe output of find command to httm\n➜ find . -maxdepth 1 | httm\n```\n\nPrint all unique versions of your history file:\n\n```bash\n➜ httm ~/.histfile\n```\n\nPrint all unique versions of your history file, as formatted JSON:\n\n```bash\n➜ httm --json ~/.histfile\n```\n\nBrowse all files in your home directory, recursively, and view unique versions on local snapshots:\n\n```bash\n➜ httm -b -R ~\n```\n\nPrint all files on snapshots deleted from your home directory, recursive:\n\n```bash\n➜ httm -d -R ~\n```\n\nBrowse all files deleted from your home directory, recursively, and view unique versions on all local and alternative replicated dataset snapshots:\n\n```bash\n➜ httm -d=only -b -a -R ~\n```\n\nPrint all files on snapshots deleted from your home directory, recursive, newline delimited, piped to a text file:\n\n```bash\n# pseudo live file versions\n➜ httm -d -n -R --no-snap ~ \u003e pseudo-live-versions.txt\n# unique snapshot versions\n➜ httm -d -n -R --no-live ~ \u003e deleted-unique-versions.txt\n```\n\nBrowse all files in your home directory, recursively, and view unique versions on local snapshots, to select and ultimately restore to its original location, in overwrite mode:\n\n```bash\n➜ httm -r=overwrite -R ~\n```\n\nBrowse all files in your home directory, recursively, and view unique versions on local snapshots, to select and ultimately restore to your working directory, in \"guard\" mode, which overwrites and guards any restore action with a pre-recovery ZFS snapshot:\n\n```bash\n➜ printf \"\n# export a default httm restore mode\nexport HTTM_RESTORE_MODE=\\\"guard\\\"\" \u003e\u003e ~/.zshenv\n➜ httm -r -R ~\n```\n\nView unique versions of a file for recovery (shortcut, no need to browse a directory):\n\n```bash\n➜ httm -r /var/log/samba/log.smbd\n```\n\n`httm` is also a good Unix citizen, which means -- you *should* use the other Unix utilities to organize your queries how you like them.  `find` and `awk` are especially useful here:\n\n```bash\n# search for the text \"pattern\" among snapshots of httm manpage\n➜ httm -n --omit-ditto /usr/share/man/man1/httm.1.gz | xargs rg \"pattern\" -z\n\n# similarly, print the directory sizes of each unique snapshot\n➜ httm -n --omit-ditto /srv/downloads | xargs -I{} du -sh \"{}\"\n\n# print all unique versions of your `/var/log/syslog` file, \n# newline delimited piped to `find` to print only versions \n# with modify times of less than 1 day from right now.\n➜ httm -n --omit-ditto /var/log/syslog | xargs -I{} find '{}' -mtime -1\n\n# httm usually sorts snapshot versions in chronological order, \n# oldest to newest, but since these are just paths/strings \n# you may choose to sort them differently.\n#\n# here, print all unique versions of your `/var/log/syslog` file, \n# then print each snapshot version's size in bytes first, \n# then reverse sort by its size, then remove the number of bytes, \n# leaving only the paths in their new sorted order\n➜ httm -n --omit-ditto /var/log/syslog | xargs -I{} find '{}' -printf '%s\\t%p\\n' | \\\nsort -rn | awk 'BEGIN {FS=\"\\t\"}; {print $2}'\n```\n\nView [bowie](https://github.com/kimono-koans/httm/blob/master/scripts/bowie.bash)-formatted `diff` of each unique snapshot of `~/.zshrc` against the live file version (requires the `bowie` script be installed):\n\n```bash\n➜ httm --preview -s ~/.zshrc\n```\n\nView `cat` output of each unique snapshot of `~/.zshrc`:\n\n```bash\n➜ httm --preview=\"cat {snap_file}\" -s ~/.zshrc\n```\n\nRecover the last-in-time unique file version (shortcut, no need to browse a directory or select from among other unique versions):\n\n```bash\n➜ httm -l -r /var/log/samba/log.smbd\n```\n\nSnapshot the dataset upon which `/etc/samba/smb.conf` is located:\n\n```bash\n➜ sudo httm -S /etc/samba/smb.conf\n```\n\nBrowse all files, recursively, in a folder backed up via `rsync` to a remote share, and view unique versions on remote snapshots directly (only available for BTRFS Snapper and ZFS datasets).  (Note: Remember to make ZFS snapshots visible in your `smb.conf` with `zfsacl:expose_snapdir=True`).\n\n```bash\n# mount the share\n➜ open smb://\u003cyour name\u003e@\u003cyour remote share\u003e.local/Home\n# execute httm\n➜ httm -b -R /Volumes/Home\n```\n\nBrowse all files, recursively, in your MacOS home directory backed up via `rsync` to a ZFS or BTRFS Snapper remote share, shared via `smbd`, and view unique versions on remote snapshots. Note: The difference from above is, here, you're browsing files from a \"live\" directory:\n\n```bash\n# mount the share\n➜ open smb://\u003cyour name\u003e@\u003cyour remote share\u003e.local/Home\n# execute httm\n➜ httm -b -R --map-aliases /Users/\u003cyour name\u003e:/Volumes/Home ~\n```\n\nPrint all unique versions of your `.zshrc` file.  Note: The difference from above is, `httm`, now, even supports your Time Machine backups directly.  After using [equine](https://github.com/kimono-koans/httm/blob/master/scripts/equine.bash) to mount my personal Time Machine ZFS network share:\n\n```\n➜ sudo equine --mount-local\nDiscovering backup locations (this can take a few seconds)...\nMounting snapshots...\n...\n➜ sudo equine --mount-remote\nConnecting to remote Time Machine: smb://timemachine@montrose._smb._tcp.local./TM%20Volume ...\nMounting sparse bundle (this may include an fsck): Backups of kiev ...\n/dev/disk4\n/dev/disk5           EF57347C-0000-11AA-AA11-0030654\n/dev/disk5s1         41504653-0000-11AA-AA11-0030654 /Volumes/Backups of kiev\nDiscovering backup locations (this can take a few seconds)...\nMounting snapshots...\n...\n# restic users can do something similar by:\n# 1. mounting their repositories: restic -r /path/to/repo mount /path/to/mountpoint\n# 2. invoking httm with --alt-store: httm --alt-store=restic .zshrc\n➜ httm --alt-store=timemachine .zshrc\n─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\nTue May 09 22:57:09 2023  6.7 KiB  \"/Volumes/.timemachine/842A693F-CB54-4C5A-9AB1-C73681D4DFCD/2023-11-08-212757.backup/2023-11-08-212757.backup/Data/Users/kimono/.zshrc\"\nSun Nov 12 20:29:57 2023  6.7 KiB  \"/Volumes/.timemachine/842A693F-CB54-4C5A-9AB1-C73681D4DFCD/2023-11-18-011056.backup/2023-11-18-011056.backup/Data/Users/kimono/.zshrc\"\nSun Nov 26 02:14:56 2023  6.7 KiB  \"/Volumes/.timemachine/842A693F-CB54-4C5A-9AB1-C73681D4DFCD/2023-12-13-054342.backup/2023-12-13-054342.backup/Data/Users/kimono/.zshrc\"\n─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\nSun Nov 26 02:14:56 2023  6.7 KiB  \"/Users/kimono/.zshrc\"\n─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\n```\n\nView the differences between each unique snapshot version of the `httm` `man` page and each previous version (this simple script is the basis for [bowie](https://github.com/kimono-koans/httm/blob/master/scripts/bowie.bash)):\n\n```bash\n#!/bin/bash\nfilename=\"./httm/httm.1\"\n# previous version is unset\nprevious_version=\"\"\nfor current_version in $(httm -n --omit-ditto $filename); do\n    # check if initial \"previous_version\" needs to be set\n    if [[ -z \"$previous_version\" ]]; then\n        previous_version=\"$current_version\"\n        continue\n    fi\n\n    # print that current version and previous version differ\n    diff -q \"$previous_version\" \"$current_version\"\n    # print the difference between that current version and previous_version\n    diff \"$previous_version\" \"$current_version\"\n\n    # set current_version to previous_version\n    previous_version=\"$current_version\"\ndone\n```\n\nCreate a simple `tar` archive of all unique versions of your `/var/log/syslog`:\n\n```bash\n➜ httm -n --omit-ditto /var/log/syslog | tar -zcvf all-versions-syslog.tar.gz -T -\n```\n\nCreate a *kinda fancy* `tar` archive of all unique versions of your `/var/log/syslog`:\n\n```bash\n#!/bin/bash\nfile=\"/var/log/syslog\"\ndir_name=\"${$(dirname $file)/\\//}\"\nbase_dir=\"$(basename $file)_all_versions\"\n# squash extra directories by \"transforming\" them to simply snapshot names \nhttm -n --omit-ditto \"$file\" | \\\ntar \\\n--transform=\"flags=r;s|$dir_name|$base_dir|\" \\\n--transform=\"flags=r;s|.zfs/snapshot/||\" \\\n--show-transformed-names \\\n-zcvf \"all-versions-$(basename $file).tar.gz\" -T  -\n```\n\nCreate a *super fancy* `git` archive of all unique versions of `/var/log/syslog` (this simple script is the basis for [nicotine](https://github.com/kimono-koans/httm/blob/master/scripts/nicotine.bash)):\n\n```bash\n#!/bin/bash\n# create variable for file name\nfile=\"/var/log/syslog\"\n# create git repo\nmkdir ./archive-git; cd ./archive-git; git init\n# copy each version to repo and commit after each copy\nfor version in $(httm -n --omit-ditto $file); do\n    cp \"$version\" ./\n    git add \"./$(basename $version)\"\n    # modify commit date to match snapshot modify date-time\n    git commit -m \"httm commit from ZFS snapshot\" \\\n    --date \"$(date -d \"$(stat -c %y $version)\")\"\ndone\n# create git tar.gz archive\ntar -zcvf \"../all-versions-$(basename $file).tar.gz\" \"./\"\n# and to view\ngit log --stat\n```\n\nUse [ounce](https://github.com/kimono-koans/httm/blob/master/scripts/ounce.bash) (codename: \"dimebag\"), a wrapper script for `httm`, for no mental overhead, non-periodic dynamic snapshots:\n\n```bash\n# request ZFS snapshot privileges\n➜ ounce --give-priv\n# here you create a \"dummyfile\", ounce will add a snapshot of \"dummyfile\" \n# before you remove it, and httm will allow you to view the snapshot created\n➜ touch ~/dummyfile; ounce rm ~/dummyfile; httm ~/dummyfile\n────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\nWed Feb 15 12:59:42 2023  0 bytes  \"/home/kimono/.zfs/snapshot/snap_2023-02-15-12:59:42_ounceSnapFileMount/dummyfile\"\n────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\n                                   \"/home/kimono/dummyfile\"\n────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────\n# use as an alias around programs which modify files/dirs\n➜ printf \"\n# ounce aliases \nalias vim=\\\"ounce --trace vim\\\"\nalias emacs=\\\"ounce --trace emacs\\\"\nalias nano=\\\"ounce --trace nano\\\"\nalias rm=\\\"ounce rm\\\"\" \u003e\u003e ~/.zsh_aliases\n```\n\nUse [bowie](https://github.com/kimono-koans/httm/blob/master/scripts/bowie.bash), a wrapper script for `httm`, to display the difference between unique snapshot versions and the live file:\n\n```bash\n➜ bowie ~/.zshrc\n/home/kimono/.zshrc\n__\nFiles /home/kimono/.zfs/snapshot/snap_2023-02-14-13:42:11_ounceSnapFileMount/.zshrc and /home/kimono/.zshrc differ\n1c1\n\u003c ### If you come from bash you might have to change your $PATH.\n---\n\u003e # If you come from bash you might have to change your $PATH.\n```\n\nUse [nicotine](https://github.com/kimono-koans/httm/blob/master/scripts/nicotine.bash), a wrapper script for `httm`, to convert unique snapshot file versions to `git` archives:\n\n```bash\n➜ nicotine .zshrc\nnicotine git archive created successfully: /home/kimono/zshrc-git.tar.gz\n```\n\nRoll *forward* to a previous ZFS snapshot, instead of rolling back (this avoids destroying interstitial snapshots):\n\n```bash\n➜ sudo httm --roll-forward=rpool/scratch@snap_2023-04-01-15:26:06_httmSnapFileMount\n[sudo] password for kimono:\nhttm took a pre-execution snapshot named: rpool/scratch@snap_pre_2023-04-01-15:27:38_httmSnapRollForward\n...\nhttm roll forward completed successfully.\nhttm took a post-execution snapshot named: rpool/scratch@snap_post_2023-04-01-15:28:40_:snap_2023-04-01-15:26:06_httmSnapFileMount:_httmSnapRollForward\n```\n\n## Yo, @kimono-koans, where do your snapshots come from?\n\nIf you'd like to read more about how someone else/I personally create snapshots, you might try my [A Somewhat Opinionated Guide to Effective ZFS Snapshots](https://kimono-koans.github.io/opinionated-guide/).\n\n## I know what you're thinking, but slow your roll\n\n![To be clear, httm is *not*...](https://i.pinimg.com/originals/23/7f/2a/237f2ab8765663c721325366406197b7.gif)\n\n## License\n\nhttm is licensed under the MPL 2.0 License - see the LICENSE file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimono-koans%2Fhttm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkimono-koans%2Fhttm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkimono-koans%2Fhttm/lists"}