A Homebrew tap for AirConnect - Use AirPlay to stream to UPnP/Sonos & Chromecast devices.
- 🔄 Auto-updating: Automatically tracks the latest AirConnect releases
- 🛠️ Unified Service Management: Control both AirCast and AirUPnP with a single command
- 📊 Health Monitoring: Automatic service restart on failure
- 📝 Comprehensive Logging: Detailed logs for troubleshooting
- ⚙️ Configurable: Easy configuration management
- 🎯 macOS Optimized: Native macOS service integration
# Add the tap
brew tap dmego/airconnect
# Install AirConnect (Formula - recommended for command line usage)
brew install airconnect# Start AirConnect (both AirCast and AirUPnP)
brew services start airconnect
# Check status
airconnect status# Start services
brew services start airconnect
# Stop services
brew services stop airconnect
# Restart services
brew services restart airconnect
# Check all Homebrew services
brew services listThe tap includes a powerful management tool accessible via the airconnect command:
# Show comprehensive status
airconnect status
# View logs
airconnect logs # All logs
airconnect logs aircast # AirCast only
airconnect logs airupnp # AirUPnP only
airconnect logs service # Service manager only
# Follow logs in real-time
airconnect follow # All logs
airconnect follow aircast # AirCast only
# Configuration management
airconnect config # Edit configuration
airconnect config show # Show current config
airconnect config reset # Reset to defaults
# System diagnostics
airconnect diagnostics # Run system checks
# Version and updates
airconnect version # Show version info
airconnect update-check # Check for updates
# Help
airconnect help # Show detailed helpYou can also use the individual components directly:
# Start AirCast manually (for Chromecast devices)
aircast -d all=info
# Start AirUPnP manually (for UPnP/Sonos devices)
airupnp -d all=infoAirConnect uses a configuration file located at ~/.config/airconnect/airconnect.conf:
# Edit configuration
airconnect config
# Show current configuration
airconnect config show# Service arguments
AIRCAST_ARGS="-d all=info"
AIRUPNP_ARGS="-d all=info"
# Health monitoring
HEALTH_CHECK_INTERVAL="30"
RESTART_DELAY="5"
MAX_RESTART_ATTEMPTS="3"
# Debug mode
DEBUG="0"| Option | Description | Default |
|---|---|---|
AIRCAST_ARGS |
Arguments for AirCast service | -d all=info |
AIRUPNP_ARGS |
Arguments for AirUPnP service | -d all=info |
HEALTH_CHECK_INTERVAL |
Health check frequency (seconds) | 30 |
RESTART_DELAY |
Delay before restart (seconds) | 5 |
MAX_RESTART_ATTEMPTS |
Max restart attempts | 3 |
DEBUG |
Enable debug logging | 0 |
| Service | Log File |
|---|---|
| Service Manager | /opt/homebrew/var/log/airconnect-service.log |
| AirCast | /opt/homebrew/var/log/aircast.log |
| AirUPnP | /opt/homebrew/var/log/airupnp.log |
# Quick log view
airconnect logs
# Follow logs in real-time
airconnect follow
# View specific service logs
airconnect logs aircast
airconnect logs airupnp
airconnect logs service
# View more lines
airconnect logs all 100# Detailed status information
airconnect status
# Quick Homebrew service status
brew services list | grep airconnectThis tap automatically tracks upstream AirConnect releases.
# Check for updates
airconnect update-check
# Update to latest version
brew upgrade airconnect- GitHub Actions monitors the upstream repository daily
- When a new release is detected, an automatic PR is created
- The PR includes version updates and verification
- After review and merge, users can update with
brew upgrade
# Check system diagnostics
airconnect diagnostics
# Check service logs
airconnect logs service
# Verify binaries are working
aircast --help
airupnp --help# Check network connectivity
ping 8.8.8.8
# Check if ports are available
airconnect diagnostics
# Try manual discovery
aircast -d all=info -v
airupnp -d all=info -v# Check file permissions
airconnect diagnostics
# Reset configuration
airconnect config reset
# Reinstall if needed
brew uninstall airconnect
brew install airconnectEnable debug mode for detailed logging:
# Edit config and set DEBUG="1"
airconnect config
# Restart services
brew services restart airconnect
# Check debug logs
airconnect follow- Check logs:
airconnect logs - Run diagnostics:
airconnect diagnostics - Check configuration:
airconnect config show - Review documentation: This README and upstream docs
- Create an issue: GitHub Issues
# Stop services
brew services stop airconnect
# Uninstall
brew uninstall airconnect
# Remove tap (optional)
brew untap dmego/airconnecthomebrew-airconnect/
├── .github/workflows/ # GitHub Actions automation workflows
│ └── update-airconnect.yml # Workflow for automatic version update and release
├── Formula/ # Homebrew Formula definitions
│ └── airconnect.rb # Main AirConnect Formula file
├── scripts/ # Helper scripts
│ ├── airconnect-service.sh # Service startup and management script
│ └── airconnect-manager.sh # Main CLI management tool script
├── configs/ # Configuration file templates
│ └── airconnect.conf # Default configuration file template
├── CHANGELOG.md # Changelog and release notes
├── LICENSE # MIT open source license
├── README.md # English project documentation
└── README_zh.md # Chinese project documentation- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
# Install from local tap
brew install --formula ./Formula/airconnect.rb
# Test service functionality
brew services start airconnect
airconnect status
airconnect logsThis project is licensed under the MIT License - see the LICENSE file for details.
- philippe44 - Creator of AirConnect
- Homebrew - Package manager for macOS
- The AirConnect community
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Upstream: AirConnect Repository