mm-pymac 0.0.2

macOS native utilities for Python

mm-pymac

macOS native utilities for Python.

Installation

uv add mm-pymac

Usage

Tray / Status Bar

from mm_pymac import TrayApp, MenuItem, MenuSeparator

app = TrayApp(title="My App")
app.set_menu([
    MenuItem("Status: running", enabled=False),
    MenuSeparator(),
    MenuItem("Quit", callback=lambda _: app.quit()),
])
app.start_timer(1.0, lambda: print("tick"))
app.run()

Alerts

from mm_pymac import show_alert

result = show_alert(
    "Your task is complete.",
    title="Done",
    buttons=("Cancel", "OK"),
    default_button="OK",
)
if result == "OK":
    print("User confirmed")

Lock Screen

from mm_pymac import is_screen_locked

locked = is_screen_locked()
if locked is None:
    print("Cannot determine lock state")
elif locked:
    print("Screen is locked")
else:
    print("Screen is unlocked")

Clipboard

from mm_pymac import set_clipboard, get_clipboard, clear_clipboard

# Copy text
set_clipboard("Hello, world!")

# Read text (returns None if clipboard has no text)
text = get_clipboard()

# Clear clipboard
clear_clipboard()

# Clear only if clipboard still contains the expected value
clear_clipboard(expected="Hello, world!")

Event subscription

Subscribe to lock/unlock events (requires a running run loop, e.g. TrayApp.run()):

from mm_pymac import on_screen_locked, on_screen_unlocked

unsub_lock = on_screen_locked(lambda: print("Screen locked"))
unsub_unlock = on_screen_unlocked(lambda: print("Screen unlocked"))

# Later, to stop listening:
unsub_lock()
unsub_unlock()