Technical Documentation

Welcome to the Bach technical documentation. This guide covers installation instructions, troubleshooting, and technical details for all supported platforms.

System Requirements

Before installing Bach, ensure your system meets these minimum requirements:

Windows: Windows 10 or later (64-bit)
macOS: macOS 11 (Big Sur) or later
Linux: Ubuntu 20.04+, Debian 11+, Fedora 34+, or equivalent

Installation Guides

Windows Installation

Bach for Windows is distributed as an MSIX package with a self-signed certificate. Follow these steps for a successful installation:

Why Self-Signed Certificate?

Bach uses a self-signed certificate for distribution outside the Microsoft Store. This allows us to provide faster updates and more flexibility. The certificate ensures the installer hasn't been tampered with, but requires a one-time trust setup.

Installation Steps

Download Bach for Windows
- Download the ZIP file containing both Bach_installer.msix and Bach_certificate.cer
- Extract the ZIP file to a folder on your computer
Install the Certificate
- Locate the Bach_certificate.cer file in the extracted folder
- Right-click on Bach_certificate.cer and select Install Certificate
- In the Certificate Import Wizard:
  - Select Local Machine (you may need administrator privileges)
  - Click Next
- Choose Place all certificates in the following store
  - Click Browse
  - Select Trusted Root Certification Authorities
  - Click OK, then Next, then Finish
- You should see a success message
Install Bach
- Double-click on Bach_installer.msix
- Windows will open the installer
- Click Install and wait for the installation to complete
- Bach will appear in your Start Menu

macOS Installation

Bach for macOS is distributed as a DMG (disk image) file.

Installation Steps

Download Bach for macOS
- Download the .dmg file from the Bach website
Open the DMG
- Double-click the downloaded .dmg file
- A new window will open showing the Bach application icon
Install Bach
- Drag the Bach icon to your Applications folder
- Wait for the copy operation to complete
- Eject the DMG by clicking the eject button in Finder

Linux Installation

Bach for Linux is distributed as DEB (Debian/Ubuntu) and RPM (Fedora/RHEL) packages.

Ubuntu/Debian Installation

Download Bach
- Download the .deb package for your distribution
Install via Command Line
```
sudo dpkg -i bach-installer.deb
```
Install Dependencies (if needed)
- If you see dependency errors, run:
```
sudo apt-get install -f
```
Launch Bach
- Launch from your application menu or run bach in terminal

Frequently Asked Questions

Is Bach safe to install?

Yes, Bach is completely safe. The self-signed certificate on Windows and the Gatekeeper warning on macOS are standard security measures for apps distributed outside official app stores. We use these distribution methods to provide faster updates and more flexibility for our users.

Why doesn't Bach use the Microsoft Store or Mac App Store?

While we may distribute through official app stores in the future, direct distribution allows us to:

Provide updates faster without waiting for store approval
Offer more flexible pricing and licensing options
Include features that may have restrictions in official app stores

What data does Bach collect?

Bach respects your privacy. Please refer to our Privacy Policy for detailed information about data collection and usage.

How do I update Bach?

You will have to uninstall Bach, then download and install the new version.

How do I uninstall Bach?

Windows: Settings → Apps → Bach → Uninstall
macOS: Drag Bach from Applications to Trash
Linux:
- Ubuntu/Debian: sudo apt-get remove bach
- Fedora/RHEL: sudo rpm -e bach

Where are my Bach project files stored?

By default, Bach stores project files in:

Windows: C:\Users\<YourUsername>\Documents\Bach
macOS: ~/Documents/Bach
Linux: ~/Documents/Bach

Technical Details

File Formats Supported

Bach supports the following image formats:

Import: JPEG, PNG, WEBP, TIFF, BMP, GIF
Export: JPEG, PNG, WEBP, TIFF

Performance Optimization

Bach uses on-device AI processing for maximum privacy and performance. For best results:

Ensure your system has at least 8GB of RAM
Use an SSD for faster file operations
Close unnecessary background applications when processing large images

Need More Help?

If you're experiencing issues not covered in this documentation, please contact our support team at [email protected].

Last updated: December 21, 2025