https://github.com/nmeum/git-shuffle

Randomize Git commit timestamps to enhance privacy
https://github.com/nmeum/git-shuffle

git privacy

Last synced: 27 days ago
JSON representation

Randomize Git commit timestamps to enhance privacy

• Host: GitHub
• URL: https://github.com/nmeum/git-shuffle
• Owner: nmeum
• License: gpl-3.0
• Created: 2020-10-04T13:25:25.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-01-01T23:00:21.000Z (almost 3 years ago)
• Last Synced: 2024-06-12T03:12:57.636Z (5 months ago)
• Topics: git, privacy
• Language: C
• Homepage:
• Size: 41 KB
• Stars: 9
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# git-shuffle

Randomize timestamps associated with Git commits to enhance privacy.

## Motivation

Git associates timestamps with commits. These timestamps expose coding

hours and thereby potentially violate ones privacy. This tool randomizes

the hour of the day, as contained in these timestamps, to enhance

privacy. The tool can be employed automatically for all Git repository

through global `githooks(5)` (see below).

## Status

I use this daily, works entirely fine for my purposes as is.

## Installation

This software only requires [libgit2][libgit2 website]. If libgit2 was

installed successfully, compile this software as follows:

	make

Afterwards, the software can be installed system-wide using:

	make install

## Usage

This tool can be invoked manually from a Git repository. For example,

the following command would randomize timestamps of all unpushed

commits on the `master` branch (i.e. behaves like `git-rebase(1)`):

	$ git shuffle origin/master

However, it is likely desirable to automate this process through global

`githooks(5)`. For this purpose `core.hooksPath` will need to be set

using `git-config(1)`. Additionally, a `post-commit` hook must be

created which amends the previously created commit. For example using:

	$ git config --global core.hooksPath ~/.config/git/hooks

	$ mkdir -p ~/.config/git/hooks

	$ printf "#!/bin/sh\ngit shuffle -a\n" > ~/.config/git/hooks/post-commit

	$ chmod +x ~/.config/git/hooks/post-commit

Program usage is described further in the provided man page.

## Portability

This code requires `getentropy(3)` (which is available on Linux and

OpenBSD but not mandated by POSIX) and `timegm(3)` and `err.h` which are

also not mandated by POSIX but widely available on both Linux and BSD

systems.

## Related Work

The [git-privacy][git-privacy repo] utility shares the same goals but

has way more configuration options and is thus more complicated.

Furthermore, it doesn't utilize [libgit2][libgit2 website].

## License

This program is free software: you can redistribute it and/or modify it

under the terms of the GNU General Public License as published by the

Free Software Foundation, either version 3 of the License, or (at your

option) any later version.

This program is distributed in the hope that it will be useful, but

WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General

Public License for more details.

You should have received a copy of the GNU General Public License along

with this program. If not, see .

[libgit2 website]: https://libgit2.org/

[git-privacy repo]: https://github.com/EMPRI-DEVOPS/git-privacy