Add files via upload

Author: rogers-cyber

README.md

@@ -0,0 +1,255 @@
+# TAR CONVERTER LITE – Lightweight Offline TAR Archive Converter v1.0.0
+
+TAR CONVERTER LITE v1.0.0 is a lightweight desktop application designed to convert **.TAR archives into ZIP, 7Z, TAR.GZ, and TAR.BZ2 formats** in a fast, fully offline workflow. It supports batch processing, drag-and-drop input (optional), real-time progress tracking, pause/resume/stop controls, and a modern GUI built with ttkbootstrap.
+
+Built with Python, Tkinter, ttkbootstrap, py7zr, and 7-Zip extraction tools, this utility is ideal for users who need a reliable offline TAR archive conversion workflow without relying on cloud services or external APIs.
+
+------------------------------------------------------------
+WINDOWS DOWNLOAD (EXE)
+------------------------------------------------------------
+
+Download the latest Windows executable from:
+
+https://matetools.gumroad.com
+
+- No Python installation required  
+- Standalone Windows application  
+- Fully offline TAR converter  
+- Lightweight and fast performance  
+- Drag-and-drop workflow support (optional)  
+- Beginner-friendly interface  
+
+------------------------------------------------------------
+FEATURES
+------------------------------------------------------------
+
+CORE CAPABILITIES
+
+- 📦 Convert .TAR archives into ZIP format  
+- 📦 Convert .TAR archives into 7Z format  
+- 📦 Convert .TAR archives into TAR.GZ format  
+- 📦 Convert .TAR archives into TAR.BZ2 format  
+- ⚡ Fully offline processing (no internet required)  
+- 📂 Batch file conversion support  
+- 🖱 Drag & drop TAR import system (optional tkinterdnd2 support)  
+- 📊 Real-time progress tracking  
+- 🧾 Live processing logs  
+- 🖥 Modern ttkbootstrap-based interface  
+- 🚀 Lightweight and fast startup  
+- ⏸ Pause / Resume / Stop conversion control  
+- 📂 Auto-open output folder option  
+- 🔒 Safe temporary extraction handling  
+- 🎯 Simple and beginner-friendly workflow  
+
+SUPPORTED INPUT FORMATS
+
+- .TAR
+
+OUTPUT FORMATS
+
+- .ZIP
+- .7Z
+- .TAR.GZ
+- .TAR.BZ2
+
+------------------------------------------------------------
+CONVERSION ENGINE
+------------------------------------------------------------
+
+TAR CONVERTER LITE uses reliable Python libraries and a threaded processing architecture:
+
+- 7-Zip (`7z.exe`) for TAR extraction  
+- zipfile for ZIP archive creation  
+- tarfile for TAR.GZ/TAR.BZ2 archive creation  
+- py7zr support for 7Z workflows  
+- Threaded worker system for responsive UI  
+- Queue-based UI update system (thread-safe)  
+- Safe temporary extraction per file  
+- Pause/Resume via threading events  
+- Stop-safe cancellation handling  
+- Real-time progress reporting system  
+
+------------------------------------------------------------
+USAGE GUIDE
+------------------------------------------------------------
+
+1. Add TAR Files  
+Drag and drop .TAR files into the application or click "Select TAR Files".
+
+2. Choose Output Folder  
+Select where converted archives will be saved.
+
+3. Configure Settings  
+Choose output format and filename prefix.
+
+4. Start Conversion  
+Click "Start Conversion" to begin processing.
+
+5. Monitor Progress  
+Watch real-time logs and progress bar updates.
+
+6. Access Output  
+Optionally auto-open output folder after completion.
+
+------------------------------------------------------------
+CONVERSION WORKFLOW
+------------------------------------------------------------
+
+1. User selects .TAR files  
+2. Application validates input format  
+3. Output folder is selected  
+4. Each TAR archive is extracted to a temporary directory  
+5. Data is re-packaged into selected archive format  
+6. Output file is saved with timestamp naming  
+7. Progress bar updates in real time  
+8. Logs display processing status  
+9. Temporary files are cleaned automatically  
+10. Completion summary is shown  
+
+------------------------------------------------------------
+PERFORMANCE DESIGN
+------------------------------------------------------------
+
+- Multithreaded worker-based architecture  
+- Queue-driven UI updates (thread-safe)  
+- Non-blocking Tkinter interface  
+- Efficient temporary file handling  
+- Low memory footprint design  
+- Batch processing optimization  
+- Safe cancellation with stop events  
+- Continuous progress feedback loop  
+
+------------------------------------------------------------
+SAFETY & RELIABILITY
+------------------------------------------------------------
+
+TAR CONVERTER LITE ensures safe and stable operation:
+
+- Original TAR archives are never modified  
+- Temporary extraction folders are isolated  
+- Automatic cleanup of temp data  
+- Thread-safe UI communication system  
+- Input validation for supported formats  
+- Graceful error handling system  
+- Fully offline execution  
+- Safe pause/resume state management  
+
+------------------------------------------------------------
+ERROR HANDLING
+------------------------------------------------------------
+
+- Detects invalid or unsupported files  
+- Prevents empty conversion tasks  
+- Handles corrupted TAR archives  
+- Displays user-friendly error messages  
+- Supports safe stop/cancel operations  
+- Prevents UI freezing during processing  
+- Automatically cleans failed temp directories  
+
+------------------------------------------------------------
+LIMITATIONS (LITE VERSION)
+------------------------------------------------------------
+
+- Only supports .TAR as input format  
+- No ISO/CAB/RAR support  
+- No compression level tuning  
+- No encryption/decryption tools  
+- No cloud integration  
+- No archive repair tools  
+- No advanced preview system  
+
+------------------------------------------------------------
+INTENDED USE
+------------------------------------------------------------
+
+TAR CONVERTER LITE is ideal for:
+
+- Converting TAR files into ZIP/7Z/TAR formats  
+- Archive migration workflows  
+- Offline file processing  
+- Lightweight desktop utilities  
+- Educational and personal use  
+- Batch extraction + re-compression tasks  
+- Windows archive compatibility workflows  
+
+------------------------------------------------------------
+SYSTEM REQUIREMENTS
+------------------------------------------------------------
+
+- Windows 10 / Windows 11  
+- Minimum 2GB RAM recommended  
+- Fully offline operation supported  
+- Python 3.8+ (for source version)  
+- 7-Zip installed or bundled `7z.exe`  
+- No external API or internet dependency  
+- Lightweight desktop environment  
+
+------------------------------------------------------------
+BUILT WITH
+------------------------------------------------------------
+
+Technologies used in TAR CONVERTER LITE:
+
+- Python  
+- Tkinter  
+- ttkbootstrap  
+- tkinterdnd2 (optional)  
+- py7zr  
+- zipfile / tarfile (standard library)  
+- 7-Zip (`7z.exe`)  
+
+------------------------------------------------------------
+UPGRADE TO PRO
+------------------------------------------------------------
+
+Upgrade to TAR CONVERTER PRO for advanced features:
+
+- Multi-format archive support  
+- Advanced compression controls  
+- Multi-threaded accelerated processing  
+- Archive repair tools  
+- File preview before extraction  
+- Compression tuning options  
+- Smart batch automation presets  
+- Advanced logging dashboard  
+
+Website:
+
+https://matetools.gumroad.com
+
+------------------------------------------------------------
+ABOUT
+------------------------------------------------------------
+
+TAR CONVERTER LITE is developed by Mate Technologies, focused on building lightweight, offline desktop utilities for archive processing, conversion, and productivity workflows.
+
+© 2026 Mate Technologies  
+All rights reserved.
+
+------------------------------------------------------------
+LICENSE
+------------------------------------------------------------
+
+TAR CONVERTER LITE is distributed as commercial software.
+
+License terms:
+
+- Personal and commercial usage allowed  
+- Redistribution or resale as a competing product is prohibited  
+- Rebranding or repackaging for resale is prohibited  
+- Source modification allowed for internal/private use  
+- Compiled executable usage permitted under license  
+
+For commercial licensing or enterprise deployment, contact the developer.
+
+------------------------------------------------------------
+📷 PREVIEW
+------------------------------------------------------------
+
+<!-- Add screenshots here -->
+
+<img alt="TAR CONVERTER LITE Main Interface" src="https://github.com/rogers-cyber/TAR-CONVERTER-LITE/blob/main/TARCONVERTERLITE%20-%20Main%20Interface.png" />
+
+<img alt="TAR CONVERTER LITE Batch Processing" src="https://github.com/rogers-cyber/TAR-CONVERTER-LITE/blob/main/TARCONVERTERLITE%20-%20Batch%20Processing.png" />
+
+<img alt="TAR CONVERTER LITE Conversion Result" src="https://github.com/rogers-cyber/TAR-CONVERTER-LITE/blob/main/TARCONVERTERLITE%20-%20Result%20Conversion.png" />