Borderly GUI

A Python reimplementation of the Borderly image processing of Paul Bidwell's https://github.com/paulbidwell/Borderly application with a graphical user interface.

Features

• User-friendly interface for image processing
• Batch directory processing for multiple files
• Interactive controls with sliders and color pickers
• Live preview of image processing results
• Multiple profile support for different border and resize settings
• Options for handling original files (keep, delete, or move)
• Progress tracking for batch processing
• Settings persistence between sessions
• Recent files menu for quick access to previously processed images
• Multithreaded processing for improved performance

Requirements

• Python 3.7+
• Pillow (Python Imaging Library)
• Tkinter (usually comes with Python)

Installation

Quick Install (Recommended)

Use our automated installation script for a simple setup:

1. Clone or download this repository
2. Make the installation script executable:

   chmod +x install.sh

3. Run the installation script:

   ./install.sh

   This will:
   • Set proper permissions on all scripts
   • Detect your OS (macOS, Linux, etc.)
   • Let you choose installation method on macOS (Homebrew or pip)
   • Install all dependencies and run the application

Manual Installation Options

Option 1: Using pip (cross-platform)

1. Clone or download this repository
2. Make the script executable:

   chmod +x run.sh

3. Run the script to install dependencies and start the app:

   ./run.sh

Option 2: Using Homebrew (macOS only)

1. Clone or download this repository
2. Make the script executable:

   chmod +x run_brew.sh

3. Run the Homebrew installation script:

   ./run_brew.sh

   This will automatically:
   • Install Homebrew if not already installed
   • Install Python using Homebrew if needed
   • Install Pillow and Tkinter using Homebrew
   • Run the application

Usage

Run the application using the provided scripts:

On macOS:

# First make scripts executable
chmod +x run.sh run_brew.sh run_macos.sh

# Using pip with virtual environment
./run.sh

# Using Homebrew (recommended)
./run_brew.sh

On Windows:

run.bat

You can also run the application directly:

python borderly_gui.py

Batch Processing

You can process multiple image files at once:

1. Start the application
2. Select files using "Select Files" or an entire directory with "Select Directory"
3. Choose a profile or enable "Process with all profiles" checkbox
4. Click "Process Images" to begin

Main Features

1. Processing Images

   • Select files using the "Select Files" button
   • Choose a profile from the dropdown
   • See a live preview of how the selected profile will affect the image
   • Click "Process Images" to apply the selected profile to all images
   • Progress bar will show processing status

2. Configure Settings

   • Set the output directory for processed images
   • Choose what to do with original files:
     • Keep in the original location
     • Delete after processing
     • Move to a specified directory

3. Manage Profiles

   • Create multiple profiles with different settings
   • Each profile can specify:
     • Border width (fixed pixels or percentage)
     • Border color (with color picker)
     • Output quality (for JPEG images)
     • Optional resizing (width/height in pixels or percentage)
   • Preview results before processing

Profiles

Each profile defines how images will be processed:

• Name: Used to identify the profile and as a subfolder name
• Border Width: Thickness in pixels or as a percentage (e.g., "50px" or "5%")
• Border Color: Color for the border (with visual color picker)
• Quality: JPEG quality setting (1-100)
• Resize Width/Height: Optional resizing of images before adding borders