🎨 MuseBinder - Advanced Media Asset Management for macOS

MuseBinder is a comprehensive media asset management application for macOS, designed to help creative professionals organize, search, and manage their digital assets with advanced AI-powered features and seamless cloud synchronization.

✨ Features

🎯 Core Features

• 📁 Comprehensive Asset Management: Support for images, videos, audio, fonts, documents, and archives
• 🔍 Advanced Search & Filtering: Text search, tag filtering, color-based search, and visual similarity search
• 🏷️ Smart Tagging: AI-powered automatic tagging and content recognition
• ☁️ CloudKit Synchronization: Seamless sync across all your Apple devices
• ⚙️ Batch Operations: Powerful batch rename, move, copy, delete, and tag operations
• 📊 Metadata Extraction: Comprehensive metadata extraction for all supported file types

🤖 AI-Powered Features

• Auto Tagging: Content recognition and automatic tag generation
• Face Detection: Face recognition and group detection
• Text Recognition (OCR): Extract text from images and documents
• Color Analysis: Dominant color extraction and color-based search
• Style Recognition: Artistic style detection and classification
• Visual Similarity: Find visually similar assets using AI

🎨 Media Support

• Images: JPEG, PNG, GIF, BMP, TIFF, WebP, HEIC, HEIF
• Videos: MP4, MOV, AVI, MKV, WMV, FLV, WebM, M4V, 3GP
• Audio: MP3, WAV, AAC, FLAC, OGG, WMA, M4A, AIFF
• Fonts: TTF, OTF, WOFF, WOFF2, EOT
• Documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, RTF
• Archives: ZIP, RAR, 7Z, TAR, GZ, BZ2

📋 Metadata Extraction

• EXIF Data: Camera settings, GPS location, creation date
• IPTC Data: Copyright, keywords, creator information
• ID3 Tags: Audio metadata, artist, album, genre
• Font Information: Family name, style, designer, copyright
• Technical Data: Dimensions, bitrate, codec, duration

🚀 Getting Started

Prerequisites

• macOS 13.0 or later
• Xcode 15.0 or later
• Swift 5.9 or later

Installation

1. Clone the repository

   git clone https://github.com/aucus/MuseBinder.git
   cd MuseBinder

2. Open in Xcode

   open MuseBinder.xcodeproj

3. Build and Run

   • Select your target device (Mac)
   • Press Cmd + R to build and run

Demo Testing

Run the demo test to verify all features:

cd MuseBinder
swift test_compile.swift

📁 Project Structure

MuseBinder/
├── MuseBinder/                    # Main app source code
│   ├── Services/                  # Business logic services
│   │   ├── SettingsManager.swift           # Settings management
│   │   ├── MetadataExtractor.swift         # Metadata extraction
│   │   ├── BatchOperationsManager.swift    # Batch operations
│   │   ├── SyncManager.swift               # CloudKit sync
│   │   ├── AIIntegrationService.swift      # AI integration
│   │   └── ...                            # 20+ other services
│   │
│   ├── Views/                     # SwiftUI views
│   │   ├── Settings/              # Settings views
│   │   ├── Media/                 # Media-related views
│   │   ├── Library/               # Library management views
│   │   ├── Search/                # Search and filter views
│   │   ├── AI/                    # AI feature views
│   │   └── ...                    # 12+ view categories
│   │
│   └── Models/                    # Data models
│       ├── Asset+CoreDataClass.swift
│       ├── Collection+CoreDataClass.swift
│       └── Tag+CoreDataClass.swift
│
├── MuseBinderTests/               # Test suite
│   ├── SettingsTests.swift
│   ├── MetadataExtractionTests.swift
│   ├── BatchOperationsTests.swift
│   └── ...                        # 16+ test files
│
├── MuseBinderDemo/                # Demo application
└── MuseBinderExtension/           # Safari extension

🧪 Testing

The project includes comprehensive test coverage:

# Run all tests
swift test

# Run specific test categories
swift test --filter SettingsTests
swift test --filter MetadataExtractionTests
swift test --filter BatchOperationsTests

🔧 Configuration

Settings Categories

• General: Auto-save, file extensions, view modes
• Import: Import location, file processing, duplicate handling
• CloudKit: Sync settings, account management
• AI: AI features, service providers, confidence thresholds
• Performance: Cache sizes, background processing
• UI: Theme, accent colors, layout preferences
• Advanced: Debug mode, analytics, logging

Supported File Types

• Images: 10+ formats with EXIF/IPTC metadata
• Videos: 9+ formats with technical metadata
• Audio: 8+ formats with ID3 tag support
• Fonts: 5+ formats with font information
• Documents: 8+ formats with document metadata
• Archives: 6+ formats with archive information

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add 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.

🗺️ Roadmap

Completed Features ✅

• Comprehensive Settings System
• Advanced Metadata Extraction
• Batch Operations & Asset Management
• CloudKit Synchronization
• AI Integration & Auto-tagging
• Search & Filter Capabilities
• Performance Optimization
• File Management & Import

Upcoming Features 🚧

• Advanced AI Features (Background removal, upscaling)
• Plugin System Foundation
• Licensing & Trial System
• Advanced Export Options
• Collaboration Features
• Mobile Companion App

📞 Support

• Documentation: Wiki
• Issues: GitHub Issues
• Discussions: GitHub Discussions

🙏 Acknowledgments

• Apple for SwiftUI, Core Data, and CloudKit
• Core ML and Vision frameworks for AI capabilities
• The Swift community for inspiration and support

---

Made with ❤️ for creative professionals