Skip to content

ryancantrell321/QShield_v1.2_CLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pandora QShield

Logo

Version: 1.2 CLI

Release: January 2025

© RyanCantrell321, Pandora Dynamics

Python 3.12 GPL v3.0 GitHub Downloads


⬇️ Downloads

Download QShield_v1.2


About

Welcome to Pandora QShield CLI – a user-friendly backup and restore solution designed to keep your qBittorrent settings secure! With Pandora QShield, you can safely back up and restore your application settings, ensuring your preferences and configurations are preserved during Windows reinstallation, migration, or qBittorrent reinstallation.


🎯 Key Features

  • Portability: No installation required.
  • Secure Backup & Restore: Easily save and restore qBittorrent settings to a location of your choice.
  • Performance Optimization: Multi-instance defense mechanism and memory efficiency algorithm.
  • Precise Event Logs: Includes a logging system to record all actions for easy debugging.

📥 Minimum System Requirements

  • Intel or AMD processors (post-2014)
  • 64-bit Windows 10 Update 2020++ or Windows 11
  • RAM: 6 GB or better
  • qBittorrent version 4.0 or newer
  • Free disk space: 5 GB or more

NOTE: NOT TESTED ON ARM64 PROCESSORS.


🐞 Known Bugs

In some devices, qBittorrent may lose internet connectivity after a restore. To resolve this, manually set the connection interface in qBittorrent to "Any Interface":

qBittorrent > Settings > Advanced > Network Interface > Any Interface

We plan to address this bug in a future update.


📚 How to Install Python (For Method 1):

Install Python version 3.11.11, 3.12.8 or 3.13.1:


📚 How to Run (3 Methods: The choice is yours)

Method 1: Using python, directly from the source

QShield is portable. No installation needed. Follow these steps:

  1. Download qShield_v1.2(source).zip.
  2. Extract the downloaded .zip file.
  3. Open the folder named qShield_v1.2.
  4. Open Windows Powershell/Windows Terminal/CMD as admin
  5. cd into the directory you extracted the folder to. Example: cd D:\Backups\qShield_v1.2
  6. Type in the following pip install -r requirements.txt and press Enter
  7. Type in the following python main.py and press Enter
  8. Enjoy.

Note: If you are not interested in such heavy technicalities, please check Method 2 and 3

Video Tutorial (Method 1)

Watch Video


Method 2: Using .exe

QShield is portable. No installation needed. Follow these steps:

  1. Download qShield_v1.2.zip.
  2. Extract the downloaded .zip file.
  3. Open the folder named qShield_v1.2.
  4. Double-click qShield_v1.2.exe and grant admin privileges.

Video Tutorial (Method 2)

Watch Video


Method 3: Using GUI [Full of User Interface Bugs]

Visit GitHub repository for the GUI version to learn more: ryancantrell321/Pandora_QShield


💻 Usage

General Guidelines

  • Path strings must be entered without quotation marks.
  • Paths can include underscores but must not contain spaces or hyphens.
  • Ensure your disk directories remain in the same location as when the data was backed up.

Backup Instructions

  1. Press 1 for backup.
    The software retrieves data from the following directories:
    • %localappdata%\qBittorrent
    • %appdata%\qBittorrent
  2. Specify a location to save the backup.
    The location must exist and cannot include spaces or hyphens (underscores are allowed).
  3. The backup process will proceed.

Restore Instructions

  1. Press 2 to restore.
    The tool will automatically extract data from the .zip file it previously created and restore it to the original directories.
  2. Specify the file path and name of the .zip file.
  3. Important: Ensure qBittorrent is completely closed before restoring data.

📷 Screenshots and Usage Video

Screenshots

Screenshot 1
Screenshot 2
Screenshot 3
Screenshot 4


⚠️ With Great Power Comes Great Responsibility!

Use this data deletion tool only if you experience qBittorrent interface corruption.

Download qShield Deleter


📑 License

Pandora QShield is licensed under the GNU General Public License (GPL) v3.0.


🌐 Future Enhancements

  • Password-protected secure backups.
  • Cloud storage support.

💿 Virus Scan Results

Avast! and its affiliates might produce false positives!

File Name Virus Scan Link
qShield_v1.2(source).zip Scan Result
qShield_v1.2.zip Scan Result
qShield_v1.2.exe Scan Result

📞 Contact Us

Pandora Dynamics Logo

About

Command Line Version of QShield GUI V1.1

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages