CLI Guide
The command-line interface provides an easy way to manage your podcast syncing.
Available Commands
create-settings-file
Creates or updates the configuration file through an interactive wizard.
This command guides you through:
- TonieCloud authentication
- Tonie selection
- Podcast feed configuration
- Episode sorting, filtering, and pinning options
list-tonies
Lists all your creative tonies with their IDs and status.
Example output:
╭─────────────────────────────────────────────╮
│ Your Creative Tonies │
├─────────────────┬───────────────────────────┤
│ Name │ ID │
├─────────────────┼───────────────────────────┤
│ Green Tonie │ 12345678-1234-1234-... │
│ Orange Tonie │ 87654321-4321-4321-... │
│ Grey Tonie │ ABCDEF01-ABCD-ABCD-... │
╰─────────────────┴───────────────────────────╯
update-tonies
Syncs podcast episodes to your configured tonies.
This command:
- Fetches the latest episodes from your configured podcasts
- Applies filters (duration, title exclusions, etc.)
- Sorts episodes according to your settings
- Uploads episodes to your tonies (respecting duration limits)
Options:
# Dry run - show what would be synced without actually syncing
tonie-podcast-sync update-tonies --dry-run
# Verbose output
tonie-podcast-sync update-tonies --verbose
--help
Display help information for any command.
# General help
tonie-podcast-sync --help
# Command-specific help
tonie-podcast-sync update-tonies --help
Global Options
--version # Show version and exit
--config PATH # Use custom config file location
--log-level LEVEL # Set logging level (DEBUG, INFO, WARNING, ERROR)
Environment Variables
TPS_SOFT_WRAP
Controls console output soft-wrapping behavior for better log readability.
Values:
- true - Enable soft-wrap (long lines wrap to next line)
- false - Disable soft-wrap (long lines are truncated)
Default: true (enabled by default in normal environments, automatically disabled in containers)
# Disable soft-wrap for cleaner log output
export TPS_SOFT_WRAP=false
tonie-podcast-sync update-tonies
Container Environments
When running in Docker, Podman, Kubernetes, or other containers, soft-wrap is automatically disabled.
Common Workflows
Initial Setup
# 1. Install
pip install tonie-podcast-sync
# 2. Configure
tonie-podcast-sync create-settings-file
# 3. Verify
tonie-podcast-sync list-tonies
# 4. Sync
tonie-podcast-sync update-tonies
Regular Maintenance
# Check your tonies
tonie-podcast-sync list-tonies
# Update with new episodes
tonie-podcast-sync update-tonies
# Edit settings if needed
open ~/.toniepodcastsync/settings.toml
Troubleshooting
# Enable debug logging
tonie-podcast-sync --log-level DEBUG update-tonies
# Validate configuration
tonie-podcast-sync create-settings-file
# Check version
tonie-podcast-sync --version
Tips
Scheduling Updates
Use cron, systemd timers, or launchd to automatically run update-tonies daily or weekly.
Multiple Configurations
Use the --config option to maintain separate configurations for different scenarios.
Testing Changes
Always use --dry-run first when testing new configuration changes.