Enum Commands

pub enum Commands {
    Edit {
        artist: String,
        track: Option<String>,
        album: Option<String>,
        album_artist: Option<String>,
        new_track: Option<String>,
        new_album: Option<String>,
        new_artist: Option<String>,
        new_album_artist: Option<String>,
        timestamp: Option<u64>,
        edit_all: bool,
        apply: bool,
        dry_run: bool,
    },
    Delete {
        recent_pages: Option<String>,
        timestamp_range: Option<String>,
        recent_offset: Option<String>,
        apply: bool,
        dry_run: bool,
    },
    Show {
        offsets: Vec<u64>,
    },
}

Variants

Edit

Edit scrobble metadata

This command allows you to edit scrobble metadata by specifying what to search for and what to change it to. You can specify any combination of fields to search for, and any combination of new values to change them to.

Usage examples:

Discover variations for an artist (dry run by default)

lastfm-edit edit –artist “Jimi Hendrix”

Discover variations with optional track name

lastfm-edit edit –artist “Radiohead” –track “Creep”

Actually apply edits (change artist name)

lastfm-edit edit –artist “The Beatles” –new-artist “Beatles, The” –apply

Change track name for specific track

lastfm-edit edit –artist “Jimi Hendrix” –track “Lover Man” –new-track “Lover Man (Live)” –apply

Fields

artist: String

Artist name (required)

track: Option<String>

Track name (optional)

album: Option<String>

Album name (optional)

album_artist: Option<String>

Album artist name (optional)

new_track: Option<String>

New track name (optional)

new_album: Option<String>

New album name (optional)

new_artist: Option<String>

New artist name (optional)

new_album_artist: Option<String>

New album artist name (optional)

timestamp: Option<u64>

Timestamp for specific scrobble (optional)

edit_all: bool

Whether to edit all instances (optional, defaults to false)

apply: bool

Actually apply the edits (default is dry-run mode)

dry_run: bool

Perform a dry run without actually submitting edits (default behavior)

Delete

Delete scrobbles in a range

This command allows you to delete scrobbles from your library. You can specify timestamp ranges, delete recent scrobbles from specific pages, or use offsets from the most recent scrobble.

Usage examples:

Show recent scrobbles that would be deleted (dry run)

lastfm-edit delete –recent-pages 1-3

Delete scrobbles from timestamp range

lastfm-edit delete –timestamp-range 1640995200-1641000000 –apply

Delete scrobbles by offset from most recent (0-indexed)

lastfm-edit delete –recent-offset 0-4 –apply

Fields

recent_pages: Option<String>

Delete scrobbles from recent pages (format: start-end, 0-indexed)

timestamp_range: Option<String>

Delete scrobbles from timestamp range (format: start_ts-end_ts)

recent_offset: Option<String>

Delete scrobbles by offset from most recent (format: start-end, 0-indexed)

apply: bool

Actually perform the deletions (default is dry-run mode)

dry_run: bool

Perform a dry run without actually deleting (default behavior)

Show

Show scrobble details for specific offsets

This command displays detailed information for scrobbles at the specified offsets from your most recent scrobbles.

Usage examples:

Show details for the most recent scrobble (offset 0)

lastfm-edit show 0

Show details for multiple scrobbles (0-indexed)

lastfm-edit show 0 1 2 5 10

Fields

offsets: Vec<u64>

Offsets of scrobbles to show (0-indexed, 0 = most recent)

Trait Implementations

impl FromArgMatches for Commands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Commands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand