fix: build names

Author: vinitkumar

.goreleaser.yml

@@ -3,49 +3,34 @@ before:
     - go mod tidy
 
 builds:
-  - id: linux-amd64
+  - id: pdf-joiner
+    main: .
+    binary: pdf-joiner
     env:
       - CGO_ENABLED=0
     goos:
       - linux
-    goarch:
-      - amd64
-    binary: "pdf-joiner-linux-amd64"
-    ldflags:
-      - -s -w
-
-  - id: linux-arm64
-    env:
-      - CGO_ENABLED=0
-    goos:
-      - linux
-    goarch:
-      - arm64
-    binary: "pdf-joiner-linux-arm64"
-    ldflags:
-      - -s -w
-
-  - id: darwin-amd64
-    env:
-      - CGO_ENABLED=0
-    goos:
       - darwin
     goarch:
       - amd64
-    binary: "pdf-joiner-darwin-amd64"
-    ldflags:
-      - -s -w
-
-  - id: darwin-arm64
-    env:
-      - CGO_ENABLED=0
-    goos:
-      - darwin
-    goarch:
       - arm64
-    binary: "pdf-joiner-darwin-arm64"
     ldflags:
       - -s -w
+    mod_timestamp: "{{ .CommitTimestamp }}"
+    no_unique_dist_dir: false
+    overrides:
+      - goos: linux
+        goarch: amd64
+        binary: pdf-joiner-linux-amd64
+      - goos: linux
+        goarch: arm64
+        binary: pdf-joiner-linux-arm64
+      - goos: darwin
+        goarch: amd64
+        binary: pdf-joiner-darwin-amd64
+      - goos: darwin
+        goarch: arm64
+        binary: pdf-joiner-darwin-arm64
 
 archives:
   - format: tar.gz
@@ -61,4 +46,4 @@ snapshot:
 
 release:
   draft: false
-  prerelease: false 
+  prerelease: false

BLOG_POST_LINUX_SUPPORT.md

@@ -0,0 +1,226 @@
+# 🐧 PDF Joiner Now Supports Linux: A Cross-Platform Success Story
+
+*Published on June 25, 2025*
+
+## Introduction
+
+The PDF Joiner tool has just received a major update that brings full Linux support to this previously macOS-only utility. This enhancement transforms a simple PDF joining tool into a truly cross-platform solution, making it accessible to a much broader user base.
+
+## What Changed?
+
+The latest commit (`f6f5e17`) introduces comprehensive Linux support with intelligent tool detection and automatic installation capabilities. Here's what was added:
+
+### 🎯 Key Features Added
+
+1. **Automatic Linux Distribution Detection**
+   - Detects Ubuntu, Debian, Fedora, RHEL/CentOS, and Arch Linux
+   - Reads `/etc/os-release` and other distribution-specific files
+   - Falls back to Debian-based systems if detection fails
+
+2. **Multiple PDF Tool Backends**
+   - **pdfunite** (poppler-utils) - Primary choice, fastest and most reliable
+   - **ghostscript (gs)** - Widely available fallback option
+   - **qpdf** - Alternative modern PDF tool
+
+3. **Automatic Tool Installation**
+   - Detects missing PDF tools and offers to install them
+   - Uses appropriate package managers for each distribution
+   - Provides clear feedback during installation process
+
+## How It Works
+
+### Smart Backend Selection
+
+The tool now implements a priority-based approach for Linux PDF joining:
+
+```go
+// Priority order of backends to try
+backends := []string{"pdfunite", "gs", "qpdf"}
+
+for _, backend := range backends {
+    if _, err := exec.LookPath(backend); err == nil {
+        return &LinuxJoiner{backend: backend, command: backend}, nil
+    }
+}
+```
+
+### Distribution-Aware Installation
+
+When no PDF tools are found, the tool automatically detects your Linux distribution and installs the necessary packages:
+
+```bash
+# Ubuntu/Debian
+sudo apt-get install poppler-utils ghostscript
+
+# Fedora
+sudo dnf install poppler-utils ghostscript
+
+# RHEL/CentOS
+sudo yum install poppler-utils ghostscript
+
+# Arch Linux
+sudo pacman -S poppler ghostscript
+```
+
+## Usage Examples
+
+### Basic Usage (Same Across Platforms)
+
+```bash
+# Join multiple PDFs with automatic output naming
+./pdf-joiner file1.pdf file2.pdf file3.pdf
+
+# Specify custom output filename
+./pdf-joiner -o combined_document.pdf file1.pdf file2.pdf file3.pdf
+```
+
+### Linux-Specific Features
+
+The tool now provides helpful feedback when setting up on Linux:
+
+```bash
+$ ./pdf-joiner file1.pdf file2.pdf
+No PDF joining tools found. Attempting to install them...
+Detected Linux distribution: debian
+Installing PDF tools for Debian/Ubuntu...
+PDF tools installed successfully!
+Successfully joined PDFs into: combined_20250625_143812.pdf
+```
+
+## Technical Implementation
+
+### Cross-Platform Architecture
+
+The implementation uses a clean interface-based design:
+
+```go
+type PDFJoiner interface {
+    Join(inputFiles []string, outputPath string) error
+    IsAvailable() bool
+    GetName() string
+}
+
+type MacOSJoiner struct{}
+type LinuxJoiner struct {
+    backend string
+    command string
+}
+```
+
+### OS Detection and Backend Selection
+
+```go
+func NewPDFJoiner() (PDFJoiner, error) {
+    switch runtime.GOOS {
+    case "darwin":
+        return &MacOSJoiner{}, nil
+    case "linux":
+        return NewLinuxJoiner()
+    default:
+        return nil, fmt.Errorf("unsupported operating system: %s", runtime.GOOS)
+    }
+}
+```
+
+## Benefits for Users
+
+### 🔄 Seamless Cross-Platform Experience
+- Same command-line interface on macOS and Linux
+- Automatic platform detection
+- Consistent output formatting
+
+### 🚀 Zero-Configuration Setup
+- Automatically detects available PDF tools
+- Installs missing dependencies when needed
+- Provides clear error messages and solutions
+
+### 🛡️ Robust Fallback System
+- Multiple PDF tool options ensure compatibility
+- Graceful degradation if preferred tools aren't available
+- Clear feedback about which backend is being used
+
+## Supported Linux Distributions
+
+The tool now supports all major Linux distributions:
+
+| Distribution | Package Manager | PDF Tools |
+|--------------|----------------|-----------|
+| Ubuntu/Debian | apt-get | poppler-utils, ghostscript |
+| Fedora | dnf | poppler-utils, ghostscript |
+| RHEL/CentOS | yum | poppler-utils, ghostscript |
+| Arch Linux | pacman | poppler, ghostscript |
+
+## Installation and Setup
+
+### Quick Start
+
+1. **Download the latest release** from the [GitHub releases page](https://github.com/vinitkumar/pdf-joiner/releases)
+2. **Make it executable**: `chmod +x pdf-joiner`
+3. **Run it**: The tool will automatically detect your system and install any missing dependencies
+
+### From Source
+
+```bash
+git clone https://github.com/vinitkumar/pdf-joiner.git
+cd pdf-joiner
+go build -o pdf-joiner
+./pdf-joiner file1.pdf file2.pdf
+```
+
+## Testing and Quality Assurance
+
+The implementation includes comprehensive tests that verify:
+
+- ✅ Cross-platform compatibility
+- ✅ Backend detection and selection
+- ✅ Error handling for missing tools
+- ✅ Distribution detection accuracy
+- ✅ Installation process reliability
+
+## Performance Comparison
+
+| Backend | Speed | Reliability | Availability |
+|---------|-------|-------------|--------------|
+| pdfunite | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
+| ghostscript | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
+| qpdf | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
+
+## Future Roadmap
+
+This Linux support addition opens up several exciting possibilities:
+
+- **Windows Support**: Extend to Windows using tools like PDFtk or Ghostscript
+- **Docker Support**: Containerized versions for CI/CD pipelines
+- **GUI Interface**: Web-based or native GUI for non-technical users
+- **Batch Processing**: Support for processing multiple PDF sets
+- **Cloud Integration**: Direct integration with cloud storage services
+
+## Community Impact
+
+This enhancement demonstrates the power of open-source collaboration:
+
+- **Increased Accessibility**: Linux users can now benefit from this tool
+- **Cross-Platform Standards**: Sets a precedent for Go-based cross-platform tools
+- **Community-Driven**: Built based on community feedback and requirements
+
+## Conclusion
+
+The addition of Linux support to PDF Joiner represents a significant milestone in making this tool truly cross-platform. The intelligent detection, automatic installation, and robust fallback system ensure that users across different Linux distributions can seamlessly join PDF files without worrying about dependencies or compatibility issues.
+
+This implementation serves as an excellent example of how to build cross-platform Go applications that provide a consistent user experience while leveraging platform-specific optimizations.
+
+### Get Started Today
+
+```bash
+# Download and try it out
+curl -L https://github.com/vinitkumar/pdf-joiner/releases/latest/download/pdf-joiner-linux-amd64 -o pdf-joiner
+chmod +x pdf-joiner
+./pdf-joiner your-file1.pdf your-file2.pdf
+```
+
+---
+
+*The PDF Joiner tool is now truly cross-platform, bringing the same reliable PDF joining capabilities to Linux users that macOS users have enjoyed. This update exemplifies the best practices in cross-platform Go development and user experience design.*
+
+**GitHub Repository**: [vinitkumar/pdf-joiner](https://github.com/vinitkumar/pdf-joiner)  
+**Latest Release**: [v1.2.3](https://github.com/vinitkumar/pdf-joiner/releases/tag/v1.2.3)