From 646d701816700182e9a80745846623a3af40a8aa Mon Sep 17 00:00:00 2001
From: Xoconoch <github@cordovault.com>
Date: Sat, 9 Aug 2025 14:37:44 -0600
Subject: [PATCH] Document #225

---
 spotizerr-ui/package.json                            |  2 +-
 spotizerr-ui/src/components/config/FormattingTab.tsx | 12 ++++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/spotizerr-ui/package.json b/spotizerr-ui/package.json
index 2916fb0..38a2f5d 100644
--- a/spotizerr-ui/package.json
+++ b/spotizerr-ui/package.json
@@ -1,7 +1,7 @@
 {
   "name": "spotizerr-ui",
   "private": true,
-  "version": "3.0.0",
+  "version": "3.0.5",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/spotizerr-ui/src/components/config/FormattingTab.tsx b/spotizerr-ui/src/components/config/FormattingTab.tsx
index 48f51f9..6c5b798 100644
--- a/spotizerr-ui/src/components/config/FormattingTab.tsx
+++ b/spotizerr-ui/src/components/config/FormattingTab.tsx
@@ -45,6 +45,12 @@ const placeholders = {
     "%explicit%": "Explicit flag",
     "%duration%": "Track duration (s)",
   },
+  Indexed: {
+    "%ar_album_1%": "Album artist #1 (use _2, _3, ...)",
+    "%artist_1%": "Track artist #1 (use _2, _3, ...)",
+    "%ar_album_2%": "Album artist #2",
+    "%artist_2%": "Track artist #2",
+  },
 };
 
 const PlaceholderSelector = ({ onSelect }: { onSelect: (value: string) => void }) => (
@@ -139,6 +145,12 @@ export function FormattingTab({ config, isLoading }: FormattingTabProps) {
           />
           <PlaceholderSelector onSelect={handlePlaceholderSelect("customTrackFormat", trackInputRef)} />
         </div>
+        <div className="text-sm text-content-muted dark:text-content-muted-dark">
+          Tip: You can select specific artists using indexed placeholders like <code>%ar_album_1%</code> or
+          <code> %artist_1%</code>. Append <code>_2</code>, <code>_3</code>, etc. to target later artists. If the index
+          exceeds available artists (e.g. <code>%artist_3%</code> but a track only has two artists), the first artist is
+          used as a fallback.
+        </div>
         <div className="flex items-center justify-between">
           <label htmlFor="tracknumPaddingToggle" className="text-content-primary dark:text-content-primary-dark">Track Number Padding</label>
           <input