Skip to main content

A lightweight CLI tool for compressing, encrypting, and backing up directories to Telegram & Google Drive.

Project description

📦 Backup Tool

GitHub release (latest by date) GitHub Workflow Status GitHub issues GitHub stars Code Coverage GitHub license GitHub forks GitHub watchers GitHub contributors Supported OS Docs

A lightweight CLI tool for compressing, encrypting, and backing up directories to Telegram & Google Drive. 🚀

✨ Features

  • Compress & encrypt directories using zstd and Fernet encryption 🔒
  • Upload backups to Telegram 📤
  • Upload backups to Google Drive ☁️
    ✅ Simple & easy-to-use CLI 🎯
    ✅ Fast & efficient ⚡

📥 Installation

You can install the tool using pip:

pip install zsafe

After installation, you can use it from anywhere:

zsafe --help

🚀 Usage

🔹 Create a Backup

zsafe backup --file /path/to/directory

🔹 Send Backup to Telegram

zsafe telegram --file backup.zst.enc --token YOUR_BOT_TOKEN --chat YOUR_CHAT_ID

🔹 Upload Backup to Google Drive

zsafe gdrive --file backup.zst.enc

⚙️ Configuration

To use Telegram and Google Drive features, set up your credentials:

🔹 Telegram Setup

🔹 Google Drive Setup

  • Authenticate via Google OAuth2.
  • Store credentials in ~/.zsafe/config.json.

🛠️ Development & Contribution

  1. Clone the repository:
git clone https://github.com/aminzdev/zsafe.git
cd zsafe
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the tool locally:
python backup_cli.py --help

🚀 Feel free to fork and submit PRs! Contributions are welcome. 😊


📜 License

This project is licensed under the MIT License - see the LICENSE file for details.


⭐ Support & Feedback

If you like this project, consider giving it a ⭐ star! 😊
For any issues, feel free to open an issue.

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

zsafe-0.1.0.tar.gz (16.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zsafe-0.1.0-py3-none-any.whl (17.7 kB view details)

Uploaded Python 3

File details

Details for the file zsafe-0.1.0.tar.gz.

File metadata

  • Download URL: zsafe-0.1.0.tar.gz
  • Upload date:
  • Size: 16.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for zsafe-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ce8cad1a8db14bfeb861c5d034adfd6f33232ca511a352acea1431ab59ade8cf
MD5 bbc68423a71af491e5cb81da5d66606e
BLAKE2b-256 e21c184f33a54d0ab4cef73b1c13af968a5a08765fcc29678550335f1b86737f

See more details on using hashes here.

File details

Details for the file zsafe-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: zsafe-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 17.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for zsafe-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ad3a7a464f354e0171141971e052820311950b88924114533fd63a32779cf7bc
MD5 80bea95d50aa1750bb2b86a22fda0b4b
BLAKE2b-256 5a5b2ffe8a59a3b702de702d51bc6361df860dd71313a9333fb5cfe519e8599b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page