Document #225

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",

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