feat: 'search' command no longer requires 'title' param

README.md

@@ -18,20 +18,40 @@ Lyrics are fetched using a fallback pipeline (first synced result wins):
 
 See `lrcfetch --help` for full command reference. Common use cases:
 
+- Fetch lyrics for the currently playing track:
+
   ```bash
-# Fetch lyrics for the currently playing track
   lrcfetch fetch
+  ```
 
-# Search by metadata (bypasses MPRIS)
-lrcfetch search -t "Song Title" -a "Artist"
+  using a specific player or source to fetch from:
 
-# Export to .lrc file
+  ```bash
+  lrcfetch --player mpd fetch --method lrclib-search
+  ```
+
+- Search by metadata (bypasses MPRIS):
+
+  ```bash
+  lrcfetch search -t "My Love" -a "Westlife"
+  lrcfetch search --trackid "5p0ietGkLNEqx1Z7ijkw5g"
+  ```
+
+- Export to sidecar `.lrc` file:
+
+  ```bash
   lrcfetch export
+  ```
 
-# Force a specific source
-lrcfetch fetch --method spotify
+  or to a custom path:
 
-# Cache management
+  ```bash
+  lrcfetch export --output /path/to/lyrics.lrc
+  ```
+
+- Cache management:
+
+  ```bash
   lrcfetch cache stats        # show cache statistics
   lrcfetch cache query        # query cache for current track
   lrcfetch cache clear        # clears cache of current track

lrcfetch/cli.py

@@ -108,8 +108,8 @@ def fetch(
 def search(
     *,
     title: Annotated[
-        str, cyclopts.Parameter(name=["--title", "-t"], help="Track title.")
-    ],
+        str | None, cyclopts.Parameter(name=["--title", "-t"], help="Track title.")
+    ] = None,
     artist: Annotated[
         str | None, cyclopts.Parameter(name=["--artist", "-a"], help="Artist name.")
     ] = None,