Smart Repository Manager GUI v1.2.9

A powerful desktop application for managing GitHub repositories

Intelligent synchronization, and comprehensive visual management tools.

Python PyQt6 GUI GitHub Repository Manager

Smart Repository Manager GUI — a powerful desktop application for managing GitHub repositories with intelligent synchronization, and comprehensive visual management tools.

Key Benefits: Visual Management — Full graphical interface for all operations · Smart Table — Lazy-loading repository list with filtering and search · Multi-User Support — Switching between GitHub accounts · Keyboard-Driven — Complete keyboard shortcuts for power users.

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:

PanelInformation Displayed
TokenToken validity, API limits (remaining/total), reset time
RepositoriesTotal count, local copies, pending updates
UserDisplay name, public repos, followers count
NetworkConnection status, external IP, GitHub accessibility

File:

ShortcutAction
Ctrl+BCreate Archive
F5Refresh
Ctrl+QExit

Synchronization:

ShortcutAction
Ctrl+SSynchronize All
Ctrl+UUpdate Needed Only
Ctrl+MClone Missing Only
Ctrl+Shift+RSync with Repair
Ctrl+Alt+RRe-clone All Repositories
Ctrl+Shift+DDownload all repositories

Repositories:

ShortcutAction
Ctrl+Shift+BOpen in Browser
Ctrl+LOpen Local Folder
Ctrl+DShow Details
Ctrl+RRefresh List
Ctrl+DelDelete Local Copy

Tools & Help:

ShortcutAction
Ctrl+IUser Information
Ctrl+TToken Information
Ctrl+Shift+NNetwork Information
Ctrl+Shift+MStorage Management
F1Documentation
Ctrl+/Keyboard shortcuts
Ctrl+Shift+AAbout

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

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