What
The help text for playback, play, list and search came over from spotify-tui. Its examples still use the old spt binary name, so they fail when pasted. There are typos ("specied", "ten second forwards"), and lowercase spotify/url/uri should read Spotify/URL/URI. The --format help leaves out %u (URI) and %r (progress), though the defaults use both, and --volume says "(1 - 100)" but 0 works.
Where to look
- Every help string in
src/cli/clap.rs (device_arg, format_arg and the four *_subcommand fns)
- The placeholders:
Format::get_placeholder in src/cli/util.rs
Possible solution
pb is still an alias, so spt pb -nnn becomes spotatui pb -nnn.
- Edit only the text, never the
Arg::new("...") ids or --long names. Other code looks those up by string.
- A
\ at a line end also skips the next line's leading spaces, so keep the space before each \.
--help (not -h) prints the long text and exits before any config or login, so no Spotify account is needed.
Done when
cargo run --no-default-features --features telemetry,tui -- playback --help shows no spt and lists %u and %r.
grep -n '\bspt\b\|specied\|(1 - 100)' src/cli/clap.rs prints nothing.
cargo fmt --all -- --check, cargo clippy --no-default-features --features telemetry,tui -- -D warnings and cargo test --no-default-features --features telemetry,tui pass.
What
The help text for
playback,play,listandsearchcame over from spotify-tui. Its examples still use the oldsptbinary name, so they fail when pasted. There are typos ("specied", "ten second forwards"), and lowercase spotify/url/uri should read Spotify/URL/URI. The--formathelp leaves out%u(URI) and%r(progress), though the defaults use both, and--volumesays "(1 - 100)" but 0 works.Where to look
src/cli/clap.rs(device_arg,format_argand the four*_subcommandfns)Format::get_placeholderinsrc/cli/util.rsPossible solution
pbis still an alias, sospt pb -nnnbecomesspotatui pb -nnn.Arg::new("...")ids or--longnames. Other code looks those up by string.\at a line end also skips the next line's leading spaces, so keep the space before each\.--help(not-h) prints the long text and exits before any config or login, so no Spotify account is needed.Done when
cargo run --no-default-features --features telemetry,tui -- playback --helpshows nosptand lists%uand%r.grep -n '\bspt\b\|specied\|(1 - 100)' src/cli/clap.rsprints nothing.cargo fmt --all -- --check,cargo clippy --no-default-features --features telemetry,tui -- -D warningsandcargo test --no-default-features --features telemetry,tuipass.