Smart Repository Manager GUI

Every session begins with an 8-step mandatory system checkup:

1. Directory Structure — Creates and verifies workspace organization
2. Internet Connection — Validates network connectivity
3. User Management — Select or add GitHub account
4. User Data — Fetches GitHub profile information
5. Repository Loading — Retrieves complete repository list
6. Local Copy Check — Scans for existing local repositories
7. Update Detection — Identifies repositories needing updates

• Synchronize All (Ctrl+S) — Complete bidirectional sync
• Update Needed Only (Ctrl+U) — Smart update detection
• Clone Missing Only (Ctrl+M) — Selective cloning
• Sync with Repair (Ctrl+R) — Advanced recovery
• Re-clone All — Complete refresh
• Download All As Zip — Complete parallel download

Live Console: Every sync operation displays real-time logs with timestamp, status, and duration for each repository.

Repository Table:

• Lazy Loading — Loads 20 repositories at a time for optimal performance
• Smart Filtering — Filter by Local/Remote, Needs Update, Private/Public, Forks, Archived
• Instant Search — Real-time filtering by name, description, or language
• Visual Indicators — Status icons for local presence and update requirements
• Context Menu — Right-click actions for quick operations

Status Panels:

File:

Synchronization:

Repositories:

Tools & Help:

Prerequisites: Python 3.8+, Git installed and configured, GitHub Personal Access Token (with repo scope), PyQt6

# Clone repository
git clone https://github.com/smartlegionlab/smart-repository-manager-gui.git

# Go to project folder
cd smart-repository-manager-gui/

# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

sudo apt install libxcb-cursor0

# Launch application
python app.py

Generate GitHub Token:

1. Visit GitHub Tokens
2. Select repo (full repository access)
3. Generate and copy token

• Add Users — Quick token validation and GitHub profile fetch
• Switch Users — Instant context switching with visual feedback
• Delete Users — Complete removal of user data and tokens
• Avatar Support — Automatic avatar download and circular display
• Persistent Storage — Token storage per user

~/smart_repository_manager/
├── config.json              # Multi-user configuration
├── username_1/             # User-specific directories
│   ├── repositories/       # Local Git repositories
│   ├── archives/          # ZIP backups
│   ├── downloads/          # Downloaded repositories as ZIP archives
│   ├── logs/             # Operation logs
│   ├── backups/          # Manual backups
│   ├── temp/             # Temporary files
│   └── avatar.png        # GitHub profile picture
└── username_2/            # Additional users

• Smart Repository Manager Core — Python library for managing Git repositories with intelligent synchronization, SSH configuration validation, and GitHub integration
• Smart Repository Manager CLI — Comprehensive command-line tool for users who prefer terminal-based workflows

ACTIVE DEVELOPMENT — This project is under continuous development. While we strive for stability, you may encounter: Interface changes between versions · New features in active testing · Performance optimizations in progress · Documentation updates pending

Recommended for: Development environments, personal use, testing
Not recommended for: Critical production systems without thorough testing

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md

License: BSD 3-Clause License