🌟 What is Affinity CLI?

Affinity CLI is a powerful, open-source command-line tool that automates the complete installation of Affinity Photo, Designer, and Publisher on Linux distributions. Version v1.0.0 is the first polished milestone—distilled from months of late-night Wine experiments, community streams, and field engagements.

📌 Everything visible here is served straight from release/v1.0.0-clean. To keep the release snapshot pristine, add future commits to that branch instead of master so the landing view stays tidy for everyone.

# One command to rule them all
affinity-cli install

No more manual Wine configuration. No more dependency hunting. Just professional creative tools on Linux. 🚀

🔥 Why creators are hyped about v1.0.0

• Battle-tested automation – the same playbook we ran internally is now a single affinity-cli install command.
• Cross-distro parity – Ubuntu, Fedora, Arch, SUSE, and more all follow the exact same installer story.
• Confidence-first UX – installer discovery, verbose status, and --dry-run show every step before touching a Wine prefix.

🎯 Features

🖼️ Supported Products

🚀 Quick Start

⚡ Installation (3 simple steps)

# 1️⃣ Clone the repository
git clone https://github.com/ind4skylivey/affinity-cli.git
cd affinity-cli

# 2️⃣ Install the CLI tool
pip install -e .

# 3️⃣ Check your system status
affinity-cli status

🎬 Launch Affinity Products

# Install Affinity products (interactive mode)
affinity-cli install

# Or specify installer location
affinity-cli install --installer-path ~/Downloads

🎉 That's it! Launch from:

# Terminal
affinity-photo          # Launch Affinity Photo
affinity-designer       # Launch Affinity Designer
affinity-publisher      # Launch Affinity Publisher

# Or from your application menu! 🎨

In under five minutes you can go from a clean Linux install to launching Affinity as if it shipped with your distro. That same moment of disbelief people share on streams and meetups? This workflow makes it repeatable.

🐧 Supported Distributions

Ubuntu 20.04 • 22.04 • 24.04	Debian 11 • 12 (Bookworm)	Fedora 38 • 39 • 40+	Arch Linux Rolling Release
Linux Mint 20.x • 21.x	Manjaro All versions	openSUSE Leap • Tumbleweed	More! Pop!_OS • Elementary

💎 Why Choose Affinity CLI?

📚 Documentation

git clone https://github.com/ind4skylivey/affinity-cli.git
cd affinity-cli
pip install -e .

pip install affinity-cli

yay -S affinity-cli

# Interactive installation
affinity-cli install

# Specify installer path
affinity-cli install --installer-path ~/Downloads

# Install specific products
affinity-cli install --products photo,designer

# Custom Wine prefix
affinity-cli install --prefix ~/.my-affinity

# Skip dependency check (advanced)
affinity-cli install --skip-dependencies

# Check system status
affinity-cli status
affinity-cli status --verbose

# Repair broken installation
affinity-cli repair
affinity-cli repair --product photo

# Uninstall products
affinity-cli uninstall
affinity-cli uninstall --purge  # Complete removal

# Generate system report
affinity-cli report
affinity-cli report --output report.json

# Show version
affinity-cli --version

# Show help
affinity-cli --help
affinity-cli install --help

# Welcome message
affinity-cli welcome

wine:
  version: "latest"
  prefix_path: "~/.wine-affinity"
  graphics_api: "vulkan"

affinity:
  products:
    - photo
    - designer
  auto_detect_installers: true

system:
  enable_multiarch: true
  install_dependencies: true

# Update package lists first
sudo apt update      # Ubuntu/Debian
sudo dnf update      # Fedora
sudo pacman -Sy      # Arch

# Rebuild desktop database
affinity-cli repair

# Kill wine processes and retry
pkill wine
affinity-cli repair

🛠️ How It Works

graph LR
    A[🚀 Start] --> B[🐧 Detect Distro]
    B --> C[📦 Install Dependencies]
    C --> D[🍷 Setup Wine]
    D --> E[⚙️ Create Prefix]
    E --> F[🎨 Install Affinity]
    F --> G[🖥️ Desktop Integration]
    G --> H[✅ Done!]
    
    style A fill:#4CAF50,stroke:#2E7D32,color:#fff
    style H fill:#4CAF50,stroke:#2E7D32,color:#fff
    style B fill:#2196F3,stroke:#1565C0,color:#fff
    style C fill:#FF9800,stroke:#E65100,color:#fff
    style D fill:#9C27B0,stroke:#6A1B9A,color:#fff
    style E fill:#F44336,stroke:#C62828,color:#fff
    style F fill:#E91E63,stroke:#AD1457,color:#fff
    style G fill:#00BCD4,stroke:#00838F,color:#fff

🔄 Installation Pipeline

1. 🐧 Detection Phase - Identifies your Linux distro and package manager
2. 📦 Preparation Phase - Installs system dependencies (wine, libraries, fonts)
3. 🍷 Wine Setup Phase - Downloads and configures optimized Wine build
4. ⚙️ Configuration Phase - Creates isolated Wine prefix with .NET Framework
5. 🎨 Installation Phase - Silently installs Affinity products
6. 🖥️ Integration Phase - Creates menu entries and bash aliases
7. ✅ Verification Phase - Tests installation and generates report

🎯 Requirements

🏗️ Project Architecture

affinity-cli/
├── 📦 affinity_cli/          # Main package
│   ├── 🧠 core/               # Core functionality
│   │   ├── distro_detector.py     # OS detection
│   │   ├── dependency_manager.py  # Package management
│   │   ├── wine_manager.py        # Wine setup
│   │   ├── prefix_manager.py      # Wine prefix config
│   │   ├── affinity_installer.py  # Product installation
│   │   └── desktop_integration.py # Desktop entries
│   │
│   ├── 🎮 commands/           # CLI commands
│   │   ├── install.py         # Install command
│   │   ├── status.py          # Status command
│   │   ├── uninstall.py       # Uninstall command
│   │   ├── repair.py          # Repair command
│   │   └── report.py          # Report command
│   │
│   └── 🛠️ utils/              # Utilities
│       └── logger.py          # Logging
│
├── 🧪 tests/                  # Unit tests (27 passing)
├── 🤖 .github/workflows/      # CI/CD automation
├── 📖 README.md               # This file
├── 📜 LICENSE                 # MIT License
└── 🤝 CONTRIBUTING.md         # Contribution guide

🤝 Contributing

We ❤️ contributions! This project thrives on community support.

🚀 Quick Contribution Setup

# Fork and clone
git clone https://github.com/yourusername/affinity-cli.git
cd affinity-cli

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install in dev mode
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Make changes and submit PR! 🎉

📊 Project Stats

📜 License

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

Important: This project is not affiliated with Serif Labs (makers of Affinity). It's a community-driven effort to enable Affinity products on Linux.

🙏 Acknowledgments

💬 Community & Support

📬 Get Help

• 💬 GitHub Discussions - Ask questions, share ideas
• 🐛 GitHub Issues - Report bugs, request features
• 📧 Email - For private inquiries
• 🌐 Reddit - r/linux, r/linuxgaming, r/AffinityPhoto

🎨 Vision & Mission

🎯 Our Goals

1. 🚀 Make Affinity installation effortless for Linux users
2. 📊 Demonstrate demand for official Linux support from Serif
3. 🤝 Build a community around professional Linux creative tools
4. 🌟 Inspire official Affinity Linux support

🗺️ Roadmap

🌈 Show Your Support