OpenKarotz-Android

A modern Android application to control your Karotz smart rabbit

Control your OpenKarotz devices with this fully redesigned Android app. Change LED colors with a precise RGB picker, play your favorite radios, use text-to-speech, move ears, and more!

✨ Features

🎨 Color Picker

• RGB sliders for precise color selection
• Hex color input
• Quick color presets carousel
• Pulse effect toggle
• Real-time preview

🎤 Text-to-Speech

• 88 voices in multiple languages
• Text input with character counter
• Instant speech playback

📻 Radio

• Syncs with radios configured on your Karotz
• Simple list interface
• One-tap playback

🏠 Home

• Random Mood button
• Random Ears button
• Quick access to fun features

👂 Ears Control

• Individual left/right ear positioning
• Random ear positions
• Ears enable/disable toggle

🐰 System Info

• OpenKarotz version
• Storage space
• WiFi MAC address
• Moods, sounds, and tags count
• Sleep/Wake control

🐰 Multi-Karotz Support

• Multiple Device Management - Connect to several Karotz devices
• Device Switching - Easily switch between your Karotz collection
• Status Monitoring - Real-time online/offline status
• Device Discovery - Automatic network scanning (planned)

🛠️ Requirements

• Android 7.0+ (API 24)
• OpenKarotz firmware on your Karotz device(s)
• Network connection to reach your Karotz

📥 Installation

From Releases

1. Download the latest APK from Releases
2. Install on your Android device
3. Add your Karotz devices in Settings

Building from Source

git clone https://github.com/miniil/OpenKarotz-Android.git
cd OpenKarotz-Android
./gradlew assembleDebug

🚀 Quick Start

1. Add Your First Karotz

   • Open the app
   • Tap "Manage Devices"
   • Add your Karotz IP address and name
   • Test the connection

2. Explore Features

• Use the navigation drawer to access all features
• Try the Color Picker with RGB sliders
• Make your Karotz speak with TTS
• Play your favorite radio stations

🤝 Contributing

Contributions are welcome! Please feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Improve documentation

📚 OpenKarotz Resources

• miniil.be - Developer's website
• OpenKarotz Official Site
• OpenKarotz Documentation
• Original Project by Olivier Bagot

🏆 Credits

Original Author

Olivier Bagot (hobbe) - Created the original OpenKarotz-Android application in 2014

Modernization & Enhancement

Wulfaz (Wulfaz) - 2025 modernization with multi-device support and contemporary Android practices

Modernization & New Features

miniil (miniil) - 2025 modernization with new features:

• RGB Color Picker
• Text-to-Speech support
• Radio sync from Karotz
• Random Mood/Ears
• About page
• UI/UX improvements

Development Assistant

Claude AI (Anthropic) - Assisted with code development and debugging

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2014 Olivier Bagot (Original work)
Copyright (c) 2025 Wulfaz (Modernization and enhancements)
Copyright (c) 2025 miniil (Modernization and new features)

🐛 Issues & Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with details about your problem
3. Include your Android version and device model

---

Made with ❤️ for the Karotz community