How jamesyc/timecapsulesmb works
TimeCapsuleSMB installs and manages a Samba server on Apple Time Capsule devices so newer Macs can use their disks over SMB, including for Time Machine. The main workflow is to discover and configure a device, enable SSH, deploy Samba, and run a checkup; users can also activate, repair, flash a boot hook, maintain, or uninstall the installation. The repository contains both a macOS GUI and a Python CLI/API backed by shared device operations. Relationships among unsampled operation implementations are omitted; README-documented workflows and indexed imports support the links shown.
Main entry points: ops Operation handlers · deploy Samba deployment · ssh.py SSH transport · main.swift macOS app
Components 20
macOS app
- macOS app
macos/TimeCapsuleSMB/Sources/TimeCapsuleSMBExecutable/main.swift - Device profiles
macos/TimeCapsuleSMB/Sources/TimeCapsuleSMBApp/Profiles/DeviceProfile.swift - Device workflows
macos/TimeCapsuleSMB/Sources/TimeCapsuleSMBApp/Workflows/DeviceDashboardSession.swift - Helper backend
macos/TimeCapsuleSMB/Sources/TimeCapsuleSMBApp/Backend/BackendClient.swift
Python interface
- Command line
src/timecapsulesmb/cli/main.py - Operation API
src/timecapsulesmb/app/service.py
Device operations
- Operation handlers
src/timecapsulesmb/app/ops - Samba deployment
src/timecapsulesmb/deploy - Firmware flash
src/timecapsulesmb/flash.py - Device maintenance
src/timecapsulesmb/services
Discovery and diagnostics
- Bonjour discovery
src/timecapsulesmb/discovery - Health checkup
src/timecapsulesmb/checks/doctor_steps.py - Device probes
src/timecapsulesmb/device
Shared runtime
- Configuration and policy
src/timecapsulesmb/core/config.py - Network utilities
src/timecapsulesmb/core/net.py - SSH transport
src/timecapsulesmb/transport/ssh.py - Remote storage
src/timecapsulesmb/device/storage.py
Other components
- Device administrator
- Time Capsule
- macOS SMB client
Connections 28
- Device administrator → macOS app: manages device
README.md - macOS app → Device profiles: stores profiles
- macOS app → Device workflows: runs workflows
- Device workflows → Helper backend: requests operations
- Device administrator → Command line: runs commands
README.md - Command line → Operation handlers: dispatches commands
src/timecapsulesmb/cli/main.py - Operation API → Operation handlers: dispatches operations
src/timecapsulesmb/app/service.py - Device administrator → Bonjour discovery: finds devices
README.md - Device administrator → Samba deployment: installs Samba
README.md - Device administrator → Health checkup: checks installation
README.md - Device administrator → Firmware flash: patches boot hook
README.md - Device administrator → Device maintenance: maintains device
README.md - Operation handlers → Operation API: uses operation context
src/timecapsulesmb/app/service.py - Operation handlers → Samba deployment: deploys files
- Operation handlers → Firmware flash: runs flash workflow
- Operation handlers → Health checkup: runs diagnostics
- Operation handlers → Bonjour discovery: discovers devices
- Operation handlers → Device maintenance: runs maintenance
src/timecapsulesmb/app/ops/__init__.py - Samba deployment → Time Capsule: installs on
README.md - Firmware flash → Time Capsule: patches firmware
README.md - Health checkup → Time Capsule: checks services
- Samba deployment → SSH transport: uses SSH
src/timecapsulesmb/deploy/migration.py - Device maintenance → SSH transport: uses SSH
src/timecapsulesmb/services/storage.py - SSH transport → Network utilities: uses network utilities
src/timecapsulesmb/transport/ssh.py - Remote storage → SSH transport: uses SSH
src/timecapsulesmb/device/storage.py - Device probes → Time Capsule: probes remotely
- Configuration and policy → Network utilities: uses network helpers
src/timecapsulesmb/core/config.py - Time Capsule → macOS SMB client: serves SMB
README.md