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

README.md

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

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,