Skip to content

BangoCat v1.0.0

Choose a tag to compare

@Gamma-Software Gamma-Software released this 26 Jul 13:00
· 223 commits to main since this release

[1.0.0] - 2025-07-26

Added

  • ๐ŸŽฏ Keyboard Layout-Based Paw Mapping - Intelligent paw assignment based on physical keyboard layout for realistic typing animations
  • ๐Ÿ› Enhanced Bug Reporting - Improved error reporting and debugging features
  • ๐Ÿ“ฑ Per-App Positioning - Revolutionary feature that remembers different cat positions for each application
  • ๐Ÿ“Š Comprehensive Stroke Counter - Tracks keystrokes and mouse clicks with persistent statistics
  • ๐ŸŽจ Visual Customization System:
    • Multiple scale presets (Small 65%, Medium 75%, Big 100%)
    • Scale pulse animation on keystroke/click
    • Cat rotation (13ยฐ tilt) with smart direction adjustment
    • Horizontal flip for left-handed users or preferences
  • ๐Ÿ“ Advanced Positioning Features:
    • Drag & drop positioning anywhere on screen
    • Corner snapping (Top/Bottom ร— Left/Right combinations)
    • Position memory across app restarts
    • Multi-monitor support
  • ๐ŸŽ›๏ธ Complete Menu System:
    • Status bar menu with all settings
    • Right-click context menu on cat overlay
    • "Visit Website" and "About BangoCat" menu items
  • ๐Ÿšซ Input Control Options:
    • Ignore clicks mode to disable mouse reactions
    • Smart input filtering for key repeats
  • ๐Ÿ”„ Factory Reset - Reset all settings to defaults functionality
  • ๐Ÿ–ฑ๏ธ Mouse Integration - Left and right click detection with paw responses
  • ๐ŸŽฎ System Integration:
    • Proper accessibility permissions handling
    • Always-on-top overlay window
    • Multi-space and full-screen app support
  • ๐Ÿ“ฆ Distribution & Packaging:
    • Professional DMG creation with custom background
    • App icon integration (.icns format)
    • Automated build and packaging scripts
  • ๐Ÿฑ Core Animation System:
    • Transparent borderless overlay window
    • Real-time input response with smooth animations
    • Proper paw up/down state management
    • Consistent key-to-paw mapping
  • ๐ŸŽจ Sprite System - Complete cat sprite images (base, left/right paw up/down states)

Technical Improvements

  • ๐Ÿ—๏ธ Project Structure Refactoring - Organized codebase with proper Swift/SwiftUI architecture
  • ๐Ÿ“ Version Management - Automated version bumping across Info.plist and source files
  • ๐Ÿ”ง Build System - Comprehensive build scripts and Swift Package Manager integration
  • ๐Ÿงช Testing Infrastructure - Unit tests for core functionality
  • ๐Ÿ“š Documentation - Extensive README with features, installation, and usage instructions
  • ๐Ÿ—‚๏ธ Resource Management - Optimized image loading with fallback mechanisms
  • ๐Ÿ’พ Settings Persistence - Proper storage and retrieval of user preferences
  • ๐Ÿ–ฅ๏ธ Window Management - Advanced overlay window handling with transparency support
  • โšก Performance Optimization - Efficient input monitoring and animation rendering

Development Features

  • ๐Ÿ› ๏ธ Developer Scripts:
    • build.sh - Quick build and test script
    • package_app.sh - Create distributable DMG packages
    • bump_version.sh - Automated version management
    • test.sh - Run unit tests
  • ๐Ÿ“– Script Documentation - Comprehensive documentation in Scripts/README.md
  • ๐Ÿท๏ธ Version Tracking - Current version 1.0.0 (build 2025.07)
  • ๐Ÿ” Enhanced Debugging - Improved error handling and logging

Fixed

  • ๐Ÿ–ผ๏ธ Image Loading - Robust sprite loading with proper error handling
  • ๐Ÿ“ Position Management - Reliable position saving and restoration
  • ๐Ÿ”„ State Management - Proper handling of app switching and window focus
  • ๐ŸŽจ UI Responsiveness - Smooth animations and consistent visual states
  • โš™๏ธ Settings Synchronization - Reliable preference storage and retrieval

Infrastructure

  • ๐Ÿ“ฆ Swift Package Manager - Modern dependency management
  • ๐ŸŽ macOS Native Integration - Proper Cocoa and SwiftUI implementation
  • ๐ŸŽฏ Accessibility Compliance - Standard macOS accessibility permission handling
  • ๐Ÿ”’ Security - Proper sandboxing and permission management
  • ๐Ÿ“ฑ Compatibility - Support for macOS 13.0 (Ventura) and later

[Initial Development] - 2025-01-18 to 2025-01-20

Development Timeline

  • Day 1 (Jan 18): Initial commit and project foundation
  • Day 1-2: Core sprite system implementation
  • Day 2 (Jan 19): Major feature development burst:
    • Input handling and animation logic
    • Scale management and UI responsiveness
    • Position management features
    • Status bar integration
    • Advanced customization options
  • Day 2-3: Polish and enhancement phase:
    • Menu system implementation
    • Professional packaging
    • Documentation and README
    • Bug fixes and optimizations
  • Day 3 (Jan 20): Final features and release preparation:
    • Per-app positioning (flagship feature)
    • Bug reporting enhancements
    • Keyboard layout-based paw mapping

Architecture Evolution

  1. Foundation Phase: Basic Swift project structure and sprite system
  2. Core Features Phase: Input monitoring, animations, and basic customization
  3. Advanced Features Phase: Position management, menus, and user experience
  4. Polish Phase: Professional packaging, documentation, and final optimizations
  5. Innovation Phase: Per-app positioning and intelligent paw mapping