Quick Start

This guide will walk you through authenticating and running your first pipeline with the CLI.

Authentication

Before running pipelines, authenticate with Spotify:

plpl auth login

This will open a browser window for Spotify authentication. Your credentials are stored locally.

To check your authentication status:

plpl auth status

Create a Pipeline

Create a pipeline definition file in YAML format:

my-pipeline.yaml

name: My First Pipeline
tasks:
  - type: getPlaylistTracks
    playlistId: "37i9dQZF1DXcBWIGoYBM5M"  # Today's Top Hits
  - type: shuffleTracks
  - type: limitTracks
    limit: 25
  - type: saveToPlaylist
    playlistId: "your-playlist-id"

Run the Pipeline

plpl run my-pipeline.yaml

Dry Run

Preview what the pipeline would do without making changes:

plpl run my-pipeline.yaml --dry-run

Verbose Output

See detailed output for debugging:

plpl run my-pipeline.yaml --verbose

Next Steps

• Learn about Tasks to understand what operations are available
• Explore Providers to see where you can source tracks from