Features • Installation • Usage • Project Structure • Dependencies • Contributing • License
A powerful yet simple tool to sync your files and folders securely from your PC to FolderFort Cloud. Built with Python and CustomTkinter, it provides a sleek dark-themed interface for effortless file management and synchronization.
| 1. 🔑 Secure Authentication | Save and securely store API credentials for quick access |
| 2. 📂 Intuitive File Selection | Browse and select local folders with a familiar interface |
| 3. ☁️ Cloud Integration | Seamlessly connect to your FolderFort Cloud storage |
| 4. ⏯️ Complete Sync Controls | Start, pause, resume, and stop uploads with visual animations |
| 5. 🔄 Auto-Retry | Automatically retry failed transfers with detailed error reporting |
| 6. 📊 Real-time Tracking | Monitor progress with detailed logs and animated progress bar |
| 7. 🌙 Modern Dark UI | Sleek, eye-friendly interface designed for extended use |
- Python 3.9 or higher
- Internet connection for API access
- FolderFort account with API token
Download and Run the Application
-
Download the latest release:
- Visit the Releases page
- Download the latest ZIP file (
FolderFortSync-v1.1.zip)
-
Extract the downloaded ZIP file to a location of your choice
-
Install required packages:
pip install customtkinter requests humanize keyring
-
Launch the application:
python sync_app.py
For Developers and Contributors
-
Clone the repository:
git clone https://github.com/MridulParth/FolderFortSync.git
-
Navigate to the project directory:
cd FolderFortSync -
Install required packages:
pip install customtkinter requests humanize keyring
-
Launch the application:
python sync_app.py
-
Authentication:
- Enter your API Token in the designated field
- Click "Save Token" to securely store it for future sessions
-
Select Source:
- Click "Browse" to select the local folder containing files you want to upload
- All files and subfolders will be included in the sync
-
Choose Destination:
- Click "Refresh" to load available cloud folders
- Select your destination folder from the dropdown menu
-
Start Sync Process:
- Click "Start" to begin uploading your files
- The progress bar will show real-time status
-
Control Options:
- Pause: Temporarily halt uploads (in-progress transfers will complete)
- Resume: Continue paused uploads
- Stop: Cancel the entire sync operation
- Retry Failed: Attempt to re-upload any failed files
-
Monitor Progress:
- View detailed logs in the bottom panel
- Check upload speed and estimated time remaining
📁 FolderFortSync/
├── sync_app.py # Main application entry point
├── file_uploader.py # File upload and transfer management
├── folder_manager.py # Cloud folder operations and structure
├── ui_components.py # UI elements and visual component
69CC
s
├── icon.ico # Application icon
└── README.md # Documentation
- CustomTkinter: Modern UI toolkit for building the interface
- Requests: HTTP library for API communication
- Humanize: Human-readable file sizes and timestamps
- Keyring: Secure credential storage for API tokens
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add some amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
Please ensure your code follows the project's style guidelines and includes appropriate tests.
This project is licensed under the MIT License - see the LICENSE file for details.
If you encounter any issues or have questions, please open an issue on GitHub.
Made with ❤️ by Kizzieee