GitRepo

A graphical Git repository manager for BigCommunity development. GitRepo handles commits, synchronization, conflict resolution and package workflows, while Build ISO creates distribution images locally in containers or through remote workflows.

Included Tools

GitRepo

A GTK4/Libadwaita application for Git operations, package building, testing and deployment in BigCommunity repositories and the AUR.

Build ISO

A specialized tool for creating and managing Linux distribution ISO images in Docker or Podman containers, with optional GitHub Actions integration.

GitRepo

Overview

GitRepo simplifies repository and package maintenance for BigCommunity. It provides a graphical interface for common Git operations, automates package builds and integrates with GitHub Actions workflows.

Features

• Graphical and CLI Interfaces - GTK4/Libadwaita application and Rich terminal interface
• Enhanced Pull Operations - Smart pull with conflict resolution
  • Interactive choice to keep or discard uncommitted local changes
  • Clickable list and per-file diff of changes received from GitHub
  • Graphical conflict resolution with side-by-side comparison
  • Default Git-standard behavior (preserve local changes)
• Git Integration - Automated commit, push, and branch management
  • User-specific branch creation (dev-username)
  • Clickable per-file diff for uncommitted changes
  • Operation preview system with safety confirmations
• Package Building - Generate testing, stable and extra packages
  • Testing builds use the remote branch containing the most recent commit
  • Stable and extra builds merge changes and build exclusively from main
• AUR Support - Build packages directly from the Arch User Repository
• CI/CD Integration - Trigger GitHub Actions workflows automatically
• Repository Management - Clean up old branches, tags, and CI jobs
• Settings System - Persistent user preferences with safe/expert operation modes
• Multi-language Support - 30+ languages including Portuguese, Spanish, German, French, Russian, Japanese, Chinese

What's New in 3.1.8

• Added graphical per-file diffs for local changes and updates received from GitHub
• Improved automatic merge handling and graphical conflict resolution
• Fixed repository status refresh after Git operations
• Ensured stable and extra packages are always built from main
• Preserved newest-remote-branch selection for testing packages
• Updated application branding to GitRepo

Requirements

Core Dependencies:

• Python 3.9+
• Git
• curl
• Rich library for Python (python-rich)
• Arch Linux environment (or compatible)

GUI Dependencies:

• GTK4 (gtk4)
• Libadwaita (libadwaita)
• Python GTK bindings (python-gobject)

Installation

Using package (recommended)

Install the package using your package manager:

sudo pacman -U gitrepo-*-x86_64.pkg.tar.zst

Or build and install from source:

cd pkgbuild
makepkg -si

Usage

Graphical Interface

Open GitRepo from the application menu or run:

gitrepo

An optional directory argument opens the Git repository containing that directory:

gitrepo /path/to/repository

Terminal Interface

Use bpkg for terminal operations:

bpkg --help

Command Line Arguments

Usage: bpkg [options]

Options:
  -o, --org, --organization  Configure GitHub organization (default: big-comm)
  -b, --build                Commit/push and generate a development package
  -c, --commit               Just commit/push with the specified message
  -F, --commit-file          Read a multi-line commit message from a file
  -a, --aur                  Build AUR package
  --mode                     Operation mode (safe|quick|expert)
  --dry-run                  Simulate operations without executing
  -n, --nocolor              Suppress color printing
  -V, --version              Print application version
  -t, --tmate                Enable tmate for debugging
  -h, --help                 Show this help message and exit

Build ISO

Overview

Build ISO is a powerful tool designed to simplify the creation of Linux distribution ISO images. It features a plug-and-play architecture that allows anyone to easily add their organization and create custom ISOs without modifying the main code. The tool automates the entire process through GitHub Actions integration and dynamically fetches available options from ISO profile repositories.

Features

• Plug-and-Play Configuration - Add new organizations by simply editing the configuration file
• Dynamic Content Discovery - Automatically detects available build directories and desktop editions from ISO profile repositories via GitHub API
• Interactive Menu Interface - User-friendly navigation with colored terminal menus
• GitHub Actions Integration - Trigger ISO build workflows remotely with comprehensive status monitoring
• Multi-Organization Support - Pre-configured for BigCommunity, BigLinux, and community forks
• Distribution Customization - Support for various Manjaro-based distributions with flexible branching
• Desktop Editions - Automatically discovers available desktop environments from your ISO profiles
• Kernel Selection - Options for different kernel versions (latest, lts, oldlts, xanmod)
• Automatic Mode - Zero-interaction builds using organization-specific defaults
• Real-time Validation - All options are validated against live repository contents

Requirements

• Python 3.9+
• Git
• curl
• Rich library for Python
• GitHub API token with appropriate permissions

Installation

Build ISO is distributed as part of the GitRepo package:

sudo pacman -U gitrepo-*-x86_64.pkg.tar.zst

Usage

Interactive Mode

Run the graphical application:

build-iso

For the terminal interface, use:

biso

Both interfaces discover available build directories and editions from the selected ISO profiles repository.

Automatic Mode

Use automatic mode for quick builds with predefined settings:

# Build with organization defaults
biso -o talesam --auto

# Override specific settings
biso -o bigbruno --auto -e kde -k latest

Command Line Arguments

Usage: biso [options]

Options:
  -o, --org, --organization  Configure GitHub organization (default: talesam)
  -d, --distro, --distroname Set the distribution name
  -e, --edition              Set the edition (desktop environment)
  -k, --kernel               Set the kernel type
  -a, --auto, --automatic    Automatic mode using default values
  -n, --nocolor              Suppress color printing
  -V, --version              Print application version
  -t, --tmate                Enable tmate for debugging
  -l, --local                Build locally in a container
  --output-dir               Set the local ISO output directory
  --clean                    Clean the local build cache after completion

Adding Your Organization

The tool is designed to be completely plug-and-play. To add your organization:

1. Add your organization to the valid list in config.py:

VALID_ORGANIZATIONS = [
    "big-comm",
    "biglinux", 
    "talesam",
    "leoberbert",
    "your-organization"  # Add here
]

2. Configure your ISO profiles repository (if you have one):

ISO_PROFILES = [
    "https://github.com/big-comm/iso-profiles",
    "https://github.com/biglinux/iso-profiles",
    "https://github.com/leoberbert/iso-profiles",
    "https://github.com/your-organization/iso-profiles"  # Add here
]

DEFAULT_ISO_PROFILES = {
    "big-comm": "https://github.com/big-comm/iso-profiles",
    "biglinux": "https://github.com/biglinux/iso-profiles", 
    "leoberbert": "https://github.com/leoberbert/iso-profiles",
    "your-organization": "https://github.com/your-organization/iso-profiles"
}

API_PROFILES = {
    "https://github.com/big-comm/iso-profiles": "https://api.github.com/repos/big-comm/iso-profiles/contents/",
    "https://github.com/biglinux/iso-profiles": "https://api.github.com/repos/biglinux/iso-profiles/contents/",
    "https://github.com/leoberbert/iso-profiles": "https://api.github.com/repos/leoberbert/iso-profiles/contents/",
    "https://github.com/your-organization/iso-profiles": "https://api.github.com/repos/your-organization/iso-profiles/contents/"
}

3. Set your default configuration in the ORG_DEFAULT_CONFIGS section:

ORG_DEFAULT_CONFIGS = {
    # ... existing configurations ...
    
    "your-organization": {
        "distroname": "bigcommunity",  # or "biglinux" or your own distro
        "iso_profiles_repo": "https://github.com/your-organization/iso-profiles", 
        "branches": {
            "manjaro": "stable",     # stable, testing, unstable
            "community": "stable",   # stable, testing, unstable (leave "" if not used)
            "biglinux": "stable"     # stable, testing, unstable (leave "" if not used)
        },
        "kernel": "latest",          # latest, lts, oldlts, xanmod
        "build_dir": "bigcommunity", # directory name in your iso-profiles repository
        "edition": "xfce"            # your preferred default desktop environment
    }
}

That's it! Your organization is now fully integrated. The tool will:

• ✅ Automatically discover your available build directories via GitHub API
• ✅ Dynamically fetch your available desktop editions
• ✅ Work in both interactive and automatic modes
• ✅ Use your custom defaults when running --auto mode

Configuration Fields Explained

• distroname: Base distribution ("bigcommunity" or "biglinux")
• iso_profiles_repo: URL to your ISO profiles repository
• branches: Version branches for each component:
  • manjaro: Manjaro base system branch (stable/testing/unstable)
  • community: BigCommunity customizations branch (leave "" if not used)
  • biglinux: BigLinux customizations branch (leave "" if not used)
• kernel: Default kernel type (latest, lts, oldlts, xanmod)
• build_dir: Directory name in your iso-profiles repository (validated via API)
• edition: Default desktop environment (validated via API)

GitHub Token Configuration

Both tools require a GitHub Personal Access Token with specific permissions.

Creating a GitHub Token

1. Go to GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)

2. Click "Generate new token" > "Generate new token (classic)"

3. Add a descriptive note (e.g. "CD/CI Community - Big-Comm")

4. Configure the token with these required permissions:

   • repo - Full control of repositories (for commit, branch, and PR operations)
   • workflow - Update GitHub Action workflows (for triggering builds)
   • write:packages - Upload packages to GitHub Package Registry
   • delete:packages - Delete packages from GitHub Package Registry (for cleanup)

5. Click "Generate token" and copy the token value

Saving the Token

GitRepo stores its token at ~/.config/gitrepo/github_token and migrates the legacy ~/.GITHUB_TOKEN file automatically. You can use either supported format:

# Single token
ghp_your_token_here

# OR multiple tokens for different organizations
big-comm=ghp_your_token_here
biglinux=ghp_your_different_token_here
talesam=ghp_another_token_here

Project Structure

/
├── LICENSE
├── pkgbuild/
│   ├── PKGBUILD              # Package build script
│   └── pkgbuild.install      # Install script
├── README.md
└── usr/
    ├── bin/
    │   ├── gitrepo           # GitRepo graphical interface
    │   ├── bpkg              # GitRepo terminal interface
    │   ├── build-iso         # Build ISO graphical interface
    │   └── biso              # Build ISO terminal interface
    └── share/
        ├── build-package/    # GitRepo core, CLI and GUI
        └── build-iso/        # Build ISO core, CLI and GUI

Troubleshooting

• Permission issues: Ensure the script has execution permissions.
• Token errors: Verify that your GitHub token is correctly configured.
• Git errors: Make sure you're inside a valid Git repository.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• BigCommunity
• Arch Linux
• Rich library for Python