From 16f3e6c38edf4a93f6166ca53368d14f3bc8f69a Mon Sep 17 00:00:00 2001
From: DraftKinner <196864209+DraftKinner@users.noreply.github.com>
Date: Sat, 22 Mar 2025 13:38:09 -0400
Subject: [PATCH] Update -m flag details

---
 CHANGELOG.md | 3 ++-
 README.md    | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b75a066..3653af9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,7 +10,8 @@
 
 - Added `--download-real-time` feature back.
 - Added implementation for `--skip-previous` as it was included as a config parameter but was unimplemented.
-- Added implementation for `--skip-duplicates` as it was included as a config parameter but was unimplemented. Note that tracks must have the trackid metadata for this to work. TBA: Procedure to add trackid metadata for tracks without it
+- Added implementation for `--skip-duplicates` as it was included as a config parameter but was unimplemented. Note that tracks must have the trackid metadata for this to work.
+- Added `-m` or `--match` flag to match output track filenames to files already existing in the same playlist/album folder and write their corresponding trackid metadata
 
 ### Removals
 
diff --git a/README.md b/README.md
index 0069ee3..fadd0eb 100644
--- a/README.md
+++ b/README.md
@@ -74,7 +74,7 @@ Downloads specified items. Accepts any combination of track, album, playlist, ep
 
 ### Compatibility with official version
 
-Do note that `--skip-previous` and `--skip-duplicates` won't immediately work with playlists and albums downloaded using the official version (both dev and main branches). To make the playlist/album compatible with this fork such that `--skip-previous` and `--skip-duplicates` will both work, simply add the `-m` or `--match` flag to the download command.
+Do note that `--skip-previous` and `--skip-duplicates` won't immediately work with playlists and albums downloaded using the official version (both dev and main branches). To make the playlist/album compatible with this fork such that `--skip-previous` and `--skip-duplicates` will both work, simply add the `-m` or `--match` flag to the download command. This will try to match filenames present in the library to ones that are to be downloaded. Note that output formats should match between the current download command and the existing files.
 
 For example:
 ```