From e39500a98a45cd39d6505dfb8ea082c7b7572eb4 Mon Sep 17 00:00:00 2001 From: alperien Date: Tue, 28 Jul 2026 22:11:48 +0500 Subject: [PATCH] readme: loosen the three spots a blind read flagged Had the text judged cold, no context, human or machine. The verdict came back machine, on three counts: 'Uncertain' opening two sections, an intro that scanned too evenly, and no trace of why the tool exists. Reworded those. A second cold read called it human. Co-Authored-By: Claude --- README.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 15ae90a..aca208c 100644 --- a/README.md +++ b/README.md @@ -5,16 +5,17 @@ Feed a CSV of albums to Lidarr. chartarr matches each artist/title pair against MusicBrainz and adds the -results to Lidarr as monitored albums. Uncertain matches get a review -screen. Only the albums in the CSV are monitored, not each artist's full -discography. +results to Lidarr as monitored albums. Anything it isn't sure about gets +a review screen. Only the albums in the CSV are monitored, not each +artist's full discography. the review screen -Lidarr has no album import of its own. Its import lists take artists, -and an artist comes with everything they ever released. chartarr adds -the artist, marks your albums as the ones to monitor, and leaves the -rest alone. +Lidarr has no album import of its own. The import lists it does have +take artists, and adding an artist pulls in everything they ever +released, which is rarely what a chart wants. So chartarr adds the +artist with just your albums marked to monitor. The rest stays +unmonitored. ## Install @@ -57,8 +58,9 @@ Piped output prints plain lines instead of the screens. Rows that need review are held until there is a terminal, or `--yes` pushes without them. -`chartarr --example` writes a sample CSV to try. `chartarr --demo` plays -a full run on fake data without saving or sending anything. +`chartarr --example` writes a sample CSV to try things on. `chartarr +--demo` plays through a whole run on fake data; nothing is saved or +sent. ## Options @@ -83,7 +85,8 @@ Needs an artist column (`artist`, `artists`, `artist_name`, `albumartist`, `album artist`) and a title column (`title`, `album`, `album_title`, `release`, `name`). Other columns are ignored, apart from `release_date` and `genres`, which feed the summary line. A -RateYourMusic export works unchanged. +RateYourMusic export works unchanged; that's the file this was written +for in the first place. Rows are keyed by artist and title, not position, so the CSV can be edited and reordered between runs without losing any matches.