Skip to content

Repository files navigation

ReportBuddy

A macOS application designed to simplify calendar event reporting, perfect for managing monthly reports like meal vouchers or attendance tracking.

🌟 Key Features

🗓 Calendar Management

  • Multiple Calendar Support
    • Select multiple calendars from different sources (iCloud, Google, etc.)
    • Visual organization by source
    • Calendar color display in event list
    • Quick calendar selection/deselection

🔍 Advanced Filtering System

  • Keyword Management

    • Dynamic keyword filtering
    • Quick edit with double-click
    • Real-time keyword addition/removal
    • Case-insensitive matching
  • Date Range Control

    • Automatic current month selection
    • Custom date range picker with intuitive interface
    • Dynamic date range display
    • Flexible period selection with toggle switch
  • Event Type Filtering

    • All-day events filter
    • Source and account information display
    • Automatic duplicate event removal

📧 Email Template System

  • Template Management
    • Multiple template support
    • Template duplication and customization
    • Quick template switching
  • Dynamic Variables
    • $month - Current month (localized)
    • $year - Current year
  • Customizable Fields
    • Default recipient
    • Subject line with variable support
    • Header and footer messages
    • Language-specific content (IT/EN)

🌍 Full Internationalization

  • Interface Languages
    • Complete English support
    • Complete Italian support
    • Dynamic language switching
  • Content Localization
    • Localized date formats
    • Localized email templates
    • Localized help documentation
    • Localized system messages

🔄 Automatic Updates

  • Update Management
    • Automatic update checking at startup
    • Manual update verification (⌘U)
    • Release notes display
    • Direct download through browser
    • Simplified update process

⌨️ Keyboard Shortcuts

  • ⌘, - Open Preferences
  • ⌘R - Refresh Events
  • ⌘E - Export via Email
  • ⌘U - Check for Updates

🔧 System Requirements

  • macOS 13.0 or later
  • Calendar access permissions
  • Configured email account
  • Internet connection for updates

📥 Installation

  1. Download the latest release from GitHub
  2. Open the .dmg file
  3. Drag ReportBuddy to Applications folder
  4. Launch the app and grant calendar access when prompted

🔒 Privacy & Security

  • Read-only calendar access
  • No data transmission to external servers
  • Local configuration storage
  • Secure update verification through GitHub

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Special thanks to @lorenzo-allevi for:

  • Valuable suggestions on UI/UX improvements
  • Testing and feedback on the update system
  • Input on the custom date range implementation

📝 License

MIT

📋 Copyright

© 2024 Filippo Saino. All rights reserved.
GitHub: @philsaino

📚 Documentation

For detailed documentation, please visit the ReportBuddy Wiki.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages