Warning
🚧 Heavy Work in Progress 🚧
This project is currently under active development and is not yet functional. Features may be broken, incomplete, or subject to major changes. Please check back in a few weeks for a more stable version.
SnapDogSitter is a cross-platform mobile and desktop companion app for SnapDog2, providing remote control capabilities for your multi-room audio system. Built with .NET MAUI, it offers a native experience across all major platforms while leveraging the same SignalR and REST API patterns used in the SnapDog2 ecosystem.
SnapDogSitter serves as a remote control for your SnapDog2 multi-room audio system, allowing you to:
- 🎵 Control audio playback across multiple rooms
- 🔊 Adjust volume and manage audio zones
- 📱 Monitor client status in real-time
- 🏠 Manage your smart home audio from anywhere
- 🔄 Receive live updates via SignalR integration
- .NET 9 - Latest stable .NET framework
- .NET MAUI - Cross-platform UI framework for native apps
- SignalR Client - Real-time communication with SnapDog2
- C# 12 - Modern language features and performance
- GitVersion - Semantic versioning automation
- Husky.NET - Git hooks for code quality
- StyleCop - Code style analysis
- xUnit - Unit testing framework
| Platform | Status | Architecture | Notes |
|---|---|---|---|
| iOS | ✅ Planned | ARM64 | iPhone & iPad support |
| iPadOS | ✅ Planned | ARM64 | Optimized tablet experience |
| macOS | ✅ Planned | ARM64 & x64 | Mac Catalyst |
| Windows | ✅ Planned | ARM64 & x64 | Windows 10/11 |
| Android | ✅ Planned | ARM64 & x64 | Phone & Tablet |
- .NET 9 SDK (9.0.301 or later)
- Visual Studio Code with C# extension
- Xcode (for iOS development on macOS)
- Android SDK (for Android development)
# Clone the repository
git clone https://github.com/metaneutrons/SnapDogSitter.git
cd SnapDogSitter
# Restore dependencies
dotnet restore
# Build the solution
dotnet build
# Run tests
dotnet test
# Install MAUI workload (if not already installed)
dotnet workload install mauiThe project is configured for full iOS Simulator integration in VS Code:
- Open the project in VS Code
- Install the C# extension
- Use
Cmd+Shift+P→ "Debug: Select and Start Debugging" - Choose "MAUI iOS Simulator"
SnapDogSitter/
├── SnapDogSitter/ # Main MAUI application
├── SnapDogSitter.Core/ # Shared business logic
├── SnapDogSitter.Api/ # SignalR & HTTP API client
├── SnapDogSitter.Tests/ # Unit tests
├── .github/workflows/ # CI/CD pipelines
├── .vscode/ # VS Code configuration
└── platforms/ # Platform-specific resources
- SnapDog2 - Main multi-room audio server
This project follows the same contribution guidelines as SnapDog2. Please see the main repository for detailed contribution instructions.
This project is licensed under the GNU Lesser General Public License v3.0 - see the LICENSE file for details.
"SnapDogSitter" plays on the idea of a pet sitter - someone who takes care of your "SnapDog" when you're not around. This companion app "sits" with your SnapDog2 system, keeping an eye on it and allowing you to control it remotely.
Made with ❤️ in Hannover for SnapDog lovers