GistifyMe is a versatile Bash script that enables you to back up and restore files and folders, compress them using xz, and upload the backup to a GitHub Gist. Whether you want to create backups or retrieve and extract previous ones, GistifyMe has you covered.

1. Clone this repository or download the script directly

   git clone https://github.com/mlibre/GistifyMe
   cd GistifyMe

2. Make the script executable by running the following command

   chmod +x gistifyme.bash

3. Run the script with the following command

   ./gistifyme.bash -g <GitHub Token> -f file1 [-f folder1 ...] [-d <output_dir>]

   Replace <GitHub Token> with your GitHub Personal Access Token, which is required to create Gists. You can generate a token in your GitHub account settings.

   Provide a list of files and folders you want to back up as arguments. The script will create a timestamped archive of the sources in tar.xz format, in the specified or default output directory, and upload it to your GitHub Gist.

   Example:

   ./gistifyme.bash -g "YOUR_GITHUB_TOKEN" -f file1.txt -f folder1 -d ./backup/

   By environmental variable:

   export GITHUB_TOKEN="YOUR_GITHUB_TOKEN"
   ./gistifyme.bash -f file1.txt -f folder1 -d ./backup/

4. Once the script finishes, it will display the URL of the created Gist, where you can access and share your backup.

To retrieve and extract a Gist backup, you can use the same script. Here's how:

1. Run the script with the following command, providing the Gist URL and an optional output directory:

   ./gistifyme.bash -r <Gist URL> [-d <output_dir>]
   
   # Example:
   ./gistifyme.bash -r "https://gist.github.com/mlibre/6bf478862e6c51164c74b52a4c058bf3"
   
   # Example with direct URL
   ./gistifyme.bash -r "https://gist.githubusercontent.com/mlibre/6bc1b165d3f/raw/d07/backup_2023-09-27T21-23-31.tar.xz"

   If you don't specify an output directory, the script will extract the backup in the current directory.

• Customize the backup directory path in the script to suit your preferences
• You can adjust the compression level in the script (currently set to the maximum, -9) if needed
• Ensure your GitHub Token has the necessary permissions to create and access Gists

This script is released under the public domain using the Unlicense.

Feel free to fork this repository, make improvements, and use it for your backup and restore needs.

0xc9b64496986E7b6D4A68fDF69eF132A35e91838e