familylink 0.1.5

Add your description here

Family Link

A non-official Python package to interact with Google Family Link, to manage your kids' screen time.

Installation

pip install familylink

Usage as a CLI

Create a config.csv file with the following format:

App,Max Duration,Days,Time Ranges
Calculator,,,                       # always allowed
Youtube,0:10,Mon-Fri,               # 10 minutes per day during weekdays
Youtube,0:30,Sat-Sun,               # 30 minutes per day on weekends
Fortnite,1:00,Wed,13:00-18:00       # 1 hour on Wednesday, between 13:00 and 18:00
Fortnite,1:00,Sat-Sun,09:30-18:00   # 1 hour on weekends, between 09:30 and 18:00
Google Photos,0:10,,                # 10 minutes everyday

The apps that are not in the list will be blocked.

python -m familylink.cli config.csv --dry-run  # Remove --dry-run to apply changes
# or with uv
uvx familylink config.csv --dry-run

Usage as a library

Create a client

from familylink import FamilyLink

client = FamilyLink()

Set an app limit

client.set_app_limit("Spotify", 30)  # in minutes

Block an app

client.block_app("Youtube")

Always allow an app

client.always_allow_app("Calculator")

Remove an app limit

client.remove_app_limit("Youtube")

List apps and usage

client.print_usage()
# ------------------------------
# Limited apps
# ------------------------------
# Spotify: Music and Podcasts: 30 minutes
# 
# ------------------------------
# Blocked apps
# ------------------------------
# YouTube
# 
# ------------------------------
# Always allowed apps
# ------------------------------
# Calculator
# 
# ------------------------------
# Usage per app (today)
# ------------------------------
# Spotify: Music and Podcasts: 00:30:09