TRMNL Buddy

TRMNL Android Buddy is the essential companion app for managing your TRMNL e-ink display devices. Monitor device health, track battery life, stay updated with TRMNL announcements and blog posts, and manage your displays—all from your Android phone.

⚠️ Note: TRMNL Buddy currently requires TRMNL API keys. At least one device in your TRMNL account must have a developer edition or BYOD license to enable User API Keys.

📰 STAY INFORMED
• Unified content feed with announcements and blog posts
• Auto-rotating carousel showing latest updates
• Smart visibility: only displays unread content
• Filter by category, read/unread status
• Multi-image blog post previews
• Mark favorites for quick access
• Background sync every 2 days (battery optimized)
• Optional notifications for new content

📊 DEVICE MONITORING
• View all your TRMNL devices in one place
• Real-time battery level and WiFi signal strength
• Animated progress indicators for quick status checks
• Device preview showing current screen content
• Refresh rate tracking for each device

🔋 BATTERY HEALTH TRACKING
• Automatic weekly battery data collection
• Historical battery charts with trajectory visualization
• Manual battery recording when needed
• Low battery notifications with configurable threshold
• Opt-out option for privacy-conscious users

📱 DEVICE DETAILS
• Comprehensive device information screen
• Current voltage readings (when available)
• WiFi signal strength in dBm
• Device ID and MAC address management
• Privacy-first design with obfuscated sensitive data

🎨 MODERN DESIGN
• Material You support with dynamic theming (Android 12+)
• Automatic dark mode based on system preferences
• Edge-to-edge display for modern aesthetics
• Smooth animations and haptic feedback
• Material Design 3 components throughout

🔐 PRIVACY & SECURITY
• Encrypted storage for API tokens
• Device IDs and MAC addresses obfuscated by default
• Toggle privacy mode to show/hide sensitive information
• Secure DataStore for all preferences
• No data shared with third parties
• Offline-first architecture

📱 REQUIREMENTS
• Android 9.0 (API 28) or higher
• TRMNL account with API key (developer edition or BYOD license)
• Internet connection for device data sync

🔗 USEFUL LINKS
• TRMNL Website: https://trmnl.com/
• Report Issues: https://github.com/hossain-khan/trmnl-android-buddy/issues

Perfect for TRMNL device owners who want to keep their e-ink displays running smoothly, monitor battery health, and stay updated with the latest TRMNL news!