Skip to content
rhoopr edited this page Apr 13, 2026 · 5 revisions

list

List available albums or libraries from your iCloud account.

Replaces the deprecated --list-albums and --list-libraries flags.

Usage

# List all albums in your personal library
kei list albums -u my@email.address

# List albums across all libraries (including shared)
kei list albums -u my@email.address --library all

# List available libraries
kei list libraries -u my@email.address

Subcommands

Subcommand Description
albums List album names. Useful for finding exact names to pass to --album.
libraries List library zone names. Useful for finding names to pass to --library.

Flags

Global flags (--username, --config, --data-dir, --domain, --log-level) apply to this command.

Flag Description
--library Scope album listing to a specific library (default: PrimarySync, use all for all)
-p, --password iCloud password
--password-file Read password from a file
--password-command Run a command to get the password

Related

Clone this wiki locally