Skip to content

Microsoft Family Safety v0.5.0 - Initial Release

Choose a tag to compare

View all tags
@noiwid noiwid released this 09 Nov 04:19
v0.5.0
bc17d79
This commit was signed with the committer’s verified signature.
claude Claude
SSH Key Fingerprint: 32dP45eSMmVSt/G/CGvcxl/P+MO3Nwj9xeTh/GSA2wc
Verified
Learn about vigilant mode.

🎉 Microsoft Family Safety v0.5.0 - Initial Release

First public release of the Microsoft Family Safety integration for Home Assistant!

🌟 Features

📊 Account Monitoring

  • Daily screen time tracking - Monitor daily usage for each child account
  • Average screen time statistics - Analyze usage trends over multiple days
  • Account balance - Track account balance when enabled in Family Safety
  • Profile information - Display first name, surname, and profile picture
  • Application tracking - Count and list all installed applications per account

📱 Device Management

  • Screen time per device - Detailed tracking for each registered device
  • Device information - Model, operating system, last seen timestamp
  • Remote lock/unlock - Control device access via switches
  • Real-time status - Monitor block status and device availability
  • Multiple device support - Manage all devices registered in Family Safety

🎯 Entities Created

Sensors (per child account):

  • sensor.<name>_screen_time - Daily screen time in minutes
  • sensor.<name>_account_info - Account details with profile picture
  • sensor.<name>_applications - Application count and complete list
  • sensor.<name>_balance - Account balance (if applicable)

Sensors (per device):

  • sensor.<device>_screen_time - Device-specific screen time
  • sensor.<device>_info - Detailed device information

Switches (per device):

  • switch.<device> - Device control (ON = unblocked, OFF = blocked)

⚙️ Services

  • microsoft_family_safety.block_device - Block a device (with optional duration)
  • microsoft_family_safety.unblock_device - Unblock a previously blocked device
  • microsoft_family_safety.approve_request - Approve screen time extension requests
  • microsoft_family_safety.deny_request - Deny screen time extension requests

🔐 Authentication

  • Secure OAuth 2.0 authentication flow with Microsoft
  • Refresh token storage for automatic re-authentication
  • Step-by-step authentication guide in documentation
  • Support for re-authentication when tokens expire

📦 Installation

HACS (Recommended)

  1. Add custom repository: https://github.com/noiwid/HAFamilySafety
  2. Search for "Microsoft Family Safety"
  3. Download and install
  4. Restart Home Assistant

Manual Installation

  1. Download and extract the latest release
  2. Copy custom_components/microsoft_family_safety to your Home Assistant config
  3. Restart Home Assistant

See INSTALL.md for detailed instructions.

📖 Documentation

  • README.md - Complete integration documentation with automation examples
  • INSTALL.md - Step-by-step installation and configuration guide
  • French and English translations - Full UI support for both languages

🔧 Technical Details

  • Home Assistant Core >= 2024.1.0 (recommended)
  • pyfamilysafety 1.1.2 (pinned for stability)
  • Cloud polling - 5-minute update interval (configurable)
  • Integration type - Hub (manages multiple devices/accounts)

🤝 Automation Examples

The integration supports powerful automations:

  • Automatic bedtime device locking
  • School day morning unlocks
  • Screen time limit alerts
  • Daily usage reports
  • Conditional access based on homework completion

See the README for complete automation examples.

⚖️ Important Notice

This integration uses unofficial APIs from Microsoft Family Safety. It is not affiliated with, endorsed, or sponsored by Microsoft Corporation.

  • Microsoft may modify or restrict API access at any time
  • Use at your own risk
  • Comply with Microsoft's terms of service

🙏 Credits

📝 Full Changelog

Initial release with complete Microsoft Family Safety integration support.

Install now: HACS Installation Guide

Need help? Create an issue

Assets 2
Loading