Skip to main content

Ctrl-Z for the filesystem

Project description


Ctrl-Z for the filesystem

What is endjoy?

Endjoy is a command line program that allows you to restore all the files in a directory to the state they were in some time ago. Therefore, it allows you to revert modifications, deletions and creations of the files in the watched directory.
With this you can just try out any changes without fear, as you can always revert them with a single command.


sudo pip install endjoy


ej start # Start recursively monitoring the working directory

# Modify/create/delete some files or directories...

ej revert 5m # Revert changes done in the last five minutes
ej revert 1h # Revert changes done in the last hour

ej checkpoint NAME # Checkpoint the current state of the directory
ej checkpoint # List all the stored checkpoints

# Modify some more files

ej revert NAME # Revert the directory to how it was when the checkpoint NAME was created

ej suicide # Stop monitoring the directory and delete all temporary files created

What makes endjoy different from git?

tl;dr: endjoy is git stash on steroids

The most important difference between git and endjoy is that the latter runs in the background whereas git doesn't, this means that:

  • Doesn't require setting explicit checkpoints as with git commit
  • Runs asynchronously, so you don't have to wait for git to finish
  • Doesn't require any action till you need to use it to restore a previous state

If you need complex functionality, like merging different commits/checkpoints or moving forward and backwards between them, git is a better choice, as endjoy is much simpler and doesn't implement that

Why is it called endjoy?



Install from source (requires poetry):

# Optional
virtualenv --python=python3 venv
. venv/bin/activate
# Required
poetry install
# Run
# Run tests

How does it work?

On start it spawns a process, that will act as the server, with two threads:

  • One thread subscribes to be notified of changes on all the directories especified via inotify and stores all the changes along with a timestamp in shared memory
  • Another thread creates a named pipe and listens on it, when endjoy is called again with another command this thread performs whatever command was issued using the data that has been gathered by the first thread (inotify one)


@luis136 and @corollari


The Unlicense

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

endjoy-1.0.0.tar.gz (5.3 kB view hashes)

Uploaded source

Built Distribution

endjoy-1.0.0-py3-none-any.whl (5.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page