Skip to content

official-Arvind/jigar-tools

Repository files navigation


Typing SVG


Latest Release Stars Β  Contributors Β  License



The world's most aggressive, high-performance Android backup & restore suite. Engineered for power users who refuse to wait. Free forever.


Deploy God Mode

πŸ›‘οΈ Stability Policy (Gold Edition)

Important

Jigar Tools v2.0 is considered the final, feature-complete Gold Edition. No further features or updates will be pushed to this repository, unless one of the following breaking changes occurs:

  • Android OS level storage updates breaking current architecture
  • ADB protocol revisions disrupting operations
  • Critical data vulnerabilities

This ensures absolute maximum stability for your most critical data.


⚑ What Is This?

Jigar Tools is a Windows-native toolkit designed to sync your Android device to your PC at absolute maximum velocity. It leverages a 20-thread parallel ADB architecture, a robust 3-stage fallback engine, and an elegant WinForms GUI that grants you surgical precision over what to back up or restore. No cloud dependencies. No subscriptions. Pure performance.

Initial Backup  (50 GB)  β†’  5–10 minutes   @ 80–150 MB/s
Delta Sync      ( 5 GB)  β†’  < 2 minutes    @ 120–180 MB/s  
Full Restore    (50 GB)  β†’  8–15 minutes   @ 60–120 MB/s

πŸ—‚οΈ The Arsenal

πŸš€ JigarSmartSync.ps1

Titan Backup Engine

  • ⚑ 20x Parallel Threads β€” Maximize USB bandwidth safely, bypassing the 32-bit 2.14GB arithmetic overflow limits.
  • πŸ” 3-Stage Fallback β€” Circumvents all known ADB path limitations (including single-quote path traps).
  • πŸ“ Dynamic Device Folder β€” Creates/uses a backup folder named after the device model (e.g. 22101316G).
  • πŸ’Ύ Location Memory β€” Automatically recalls your previous backup destination.
  • 🌲 Interactive EXCLUDE Menu β€” Exclude specific folders/files via an intuitive UI.
  • πŸ”„ Delta Sync β€” Intelligently transfers only modified or new files.
  • πŸ“ Persistent Logging β€” Comprehensive transcripts saved to Logs\.
  • β›” Graceful Abortion β€” Safely cleans ADB temporary files on Ctrl+C.

⚑ JigarSmartRestore.ps1

Titan Restore Engine

  • ⚑ 20x Parallel Threads β€” Lightning-fast data restoration with batched mkdir directory pre-allocation.
  • πŸ” 3-Stage Fallback β€” Bulletproof injection into the Android filesystem.
  • πŸ—‚οΈ Smart Backup Picker β€” Automatically lists available device backups in a numbered console menu.
  • 🌲 Interactive INCLUDE Menu β€” Surgically select exact files/folders to restore.
  • πŸ”„ Delta Restore β€” Bypasses identical files already present on the device.
  • πŸ“» Media Scanner Trigger β€” Broadcasts Android intents directly to index newly restored media in the Gallery instantly.
  • πŸ’Ύ Location Memory β€” Pre-loads snapshots based on your settings.json.
  • πŸ“ Persistent Logging β€” Detailed operational logs preserved in Logs\.
  • β›” Graceful Abortion β€” Halts cleanly without leaving orphaned temp files.

βš™οΈ Jigar_Tools_Setup.bat

Master Control Center

Option Action
[1] JigarSync Backup (20x Threads)
[2] Jigar Smart Restore (Full / Selective)
[3] Device Status & App Backup Helper
[4] Check for Updates (Auto-Updater)
[5] Exit (Kills ADB Server)

πŸ—‘οΈ Jigar_Tools_Uninstall.bat

Clean System Uninstaller

  • Strips the tool directory from your System PATH.
  • Removes the Desktop shortcut cleanly.
  • Halts the background ADB server daemon.
  • Offers optional total wipe of all local backup data and logs.

πŸš€ Getting Started

Step 1 β€” Download

Acquire the latest release ZIP from the Releases page and extract the contents anywhere on your system.

Step 2 β€” Initial Setup

Right-click on Jigar_Tools_Setup.bat β†’ Run as Administrator

The God Mode Launcher will autonomously:

  • βœ… Validate PowerShell 5.1+ compatibility.
  • βœ… Inject the tools directory into your System PATH permanently.
  • βœ… Generate a "Jigar Tools" shortcut on your Desktop.
  • βœ… Initialize core configuration files (settings.json and .version).
  • βœ… Boot directly into the Master Control Menu.

Step 3 β€” Device Connection

1.  Connect your Android device via USB.
2.  On the device β†’ tap ALLOW for USB Debugging authorization.
3.  Set the USB connection mode to File Transfer.
4.  Keep the screen UNLOCKED throughout the operation.

Step 4 β€” Engage

[1] JigarSync Backup   β†’  Pull data: Phone to PC (20x Threads)
[2] Smart Restore      β†’  Push data: PC to Phone (20x Threads)
[3] Device Status      β†’  Check connection status & get App Backup instructions
[4] Check for Updates  β†’  Trigger the GitHub auto-updater
[5] Exit               β†’  Clean shutdown + ADB server termination

🌲 Interactive Selection Menus

Both core scripts launch an optional, dark-themed WinForms TreeView GUI post-scanβ€”granting you absolute, granular control over the data payload before a single byte is transferred.

πŸ”΄ Sync β€” EXCLUDE Interface

  • All nodes begin unchecked (Full Backup default).
  • Check nodes to explicitly skip them.
  • Checking a directory recursively skips its entire contents.
  • Uncheck a nested child to rescue it from a skipped parent.
  • Click "Skip" to bypass the menu and execute a full mirror.

🟒 Restore β€” INCLUDE Interface

  • All nodes begin unchecked (Zero Restore default).
  • Check exact nodes you want pushed back to the device.
  • Precise partial selections are fully supported at any depth.
  • Click "Restore All" to bypass the menu and restore the entire snapshot.

Most-Specific-Ancestor Logic β€” If /sdcard/DCIM is excluded, but /sdcard/DCIM/Camera is explicitly included, the deeper instruction takes precedence. Complex selection matrices are handled flawlessly.

Asynchronous Lazy Loading β€” The GUI renders instantly, even when parsing 50,000+ files. Subdirectories are populated dynamically only upon expansion.


πŸ”„ Intelligent Auto-Updater

[4] CHECK FOR UPDATES  β†’  Pings github.com/official-Arvind/jigar-tools

Update Sequence:
  1.  Parses local .version manifest.
  2.  Queries the GitHub Releases API for the latest tag.
  3.  Executes a version comparison.
  4.  If an update exists: displays the changelog β†’ prompts Y/N.
  5.  Downloads release payload β†’ extracts β†’ overwrites core binaries.
  6.  PRESERVES: settings.json, Logs\, and your local configurations.
  7.  Updates local manifest β†’ relaunches automatically.

πŸ”§ Configuration Architecture

Core configuration files are auto-generated dynamically at runtime. Manual intervention is not required.

Artifact Generated By Function
settings.json Titan Engine (Sync/Restore) Persists your preferred base backup directory.
.version Master Control Center Tracks the active build for the Auto-Updater.
Logs\ Titan Engine (Sync/Restore) Archives comprehensive operation transcripts.
directory-ignore-list.ini Titan Engine (Initial Sync) Defines static paths to bypass during scans.

Modifying directory-ignore-list.ini β€” Append absolute Android paths to permanently exclude them from operations:

# One path per line. Lines prefixed with # are ignored.
# (Note: /sdcard/Android/data and /sdcard/Android/obb are ignored by the script automatically)
/sdcard/Telegram           # Media re-downloaded natively by the app
/sdcard/DCIM/.thumbnails   # Disposable thumbnail cache

⚠️ Troubleshooting Protocol

πŸ”΄ "No device found" / Connection Failure
  • Verify physical USB connection integrity.
  • Ensure USB Debugging is active: Settings β†’ Developer Options β†’ USB Debugging.
  • Acknowledge the RSA fingerprint prompt on the device (tap ALLOW).
  • Confirm the USB mode is set to File Transfer (MTP), not Charging Only.
  • Attempt a different physical USB port or cable.
  • Execute option [5] Exit to terminate the ADB daemon, then restart the toolkit.
🟑 Permission Denied / Read-Only Errors

This is expected behavior for protected system directories. The Titan Engine automatically logs these and proceeds without interruption. Your personal payload (media, documents, downloads) will sync flawlessly. For absolute system access, root your device via Magisk and enforce a Global Mount Namespace.

🟑 Sub-Optimal Transfer Velocity
  • Ensure you are utilizing a certified USB 3.0+ cable (USB 2.0 is the primary bottleneck).
  • Connect directly to the motherboard; bypass external USB hubs.
  • Temporarily disable Windows Defender Real-Time Protection for your target backup directory.
  • Disable battery saver modes on the Android device.
  • Ensure the device screen remains active and unlocked.
🟑 Operation Interrupted Mid-Transfer

Simply re-initiate the operation. The Delta Sync engine will automatically compare file sizes and existence, bypassing already transferred data and seamlessly resuming from the point of failure.

πŸ”΅ PowerShell Execution Policy Restrictions

Execute Jigar_Tools_Setup.bat with Administrator privileges. The Master Control Center natively bypasses execution policies via -ExecutionPolicy Bypass, neutralizing this error under normal conditions.


πŸ“Š Performance Matrix

Operation Profile Bandwidth Expected Duration
Initial Full Sync (50 GB) 80–150 MB/s 5–10 min
Delta Sync (5 GB modified) 120–180 MB/s ~2 min
Full Snapshot Restore (50 GB) 60–120 MB/s 8–15 min
Surgical Restore (Targeted) 120–180 MB/s Variable based on payload

Real-world throughput is contingent upon USB cable specifications, NAND flash write speeds, host PC disk I/O, and ambient system overhead.


πŸ“‹ System Prerequisites

Prerequisite Specification
Host OS Windows 10 / Windows 11
Environment PowerShell 5.1+ (Native to Windows 10/11)
ADB Binary Auto-detected globally or executed locally via bin\adb.exe
Device State USB Debugging authorized and active
Root Access Optional β€” unlocks the 3rd-stage system fallback

For Rooted Hardware: Enforce the Mount Namespace Mode to Global via Magisk Manager β†’ Superuser β†’ Shell. This activates the APatch Global Mount fallback, granting the Titan Engine absolute /sdcard dominance within the root namespace.


🀝 Join the Builder Crew

Jigar Tools is forged by the community. Every validated contribution permanently etches your name into this repository.

# 1. Fork the repository
# 2. Spin up a feature branch
git checkout -b feature/QuantumOptimization

# 3. Commit your enhancements
git commit -m "✨ Implement Quantum Optimization"

# 4. Push to origin
git push origin feature/QuantumOptimization

# 5. Open a PR β€” Arvind Ji personally reviews all submissions.

Consult the CONTRIBUTING.md manifesto for advanced guidelines.


πŸ’° Fuel the Project

If Jigar Tools salvaged your data or optimized your workflow, consider fueling further development:

UPI ID: arvindji@fam (Compatible with GPay, PhonePe, Paytm, and all UPI clients)


πŸ“œ FriendlySource License v1.0

Jigar Tools is free and will permanently remain so.

  • βœ… Deploy it for personal operations without restriction.
  • βœ… Integrate it into your free software (attribution and repo link required).
  • βœ… Contribute and elevate the project.
  • 🚫 Do not monetize or sell this codebase. That is the only non-negotiable rule.

Review the complete manifesto β†’ LICENSE.md


Β© 2026 Arvind Ji Β· GitHub Β· Official Repo

About

The world's most aggressive, high-performance Android backup & restore suite. Engineered for power users who refuse to wait. Free forever.

Topics

Resources

License

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors