emby-cli 0.1.1__tar.gz → 0.2.2__tar.gz

emby_cli-0.2.2/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## Unreleased
+
+## 0.2.2
+
+- `version`: show emby-cli version; with valid server credentials also show Emby `/System/Info` version.
+- `info`: session summary (user, url, server, version, os, id) plus library names and item counts from `GET /Items/Counts` (replaces draft `whoami`).
+- `--pick-best-item` is a flag (presence enables auto-select); no longer takes `0`/`1`.
+- `info` / `version` probe the server once (no retries); on failure show configured user/URL and mark server name/version as not validated.
+- Note: `/Items/Counts` may count multiple versions of the same title higher than UI “items” views.
+- `probe_session`: fall back to `/System/Info/Public` when full `/System/Info` is forbidden (non-admin users); still proceed with Views/Counts.
+- Avoid broken `/Users/Me` on some Emby servers (HTTP 500 Guid format): use `User` from authenticate or `/Users/{id}`.
+- `list`: library table is ID/Name/Type/Items (no Year/Res); gather all counts before printing; `list -l` keeps media table like `search`.
+
+## 0.2.0
+
+- API fixes: `get_item_info` Fields, `/Users/Me`, safer 416 resume, `api_key` on play URLs, client version from package, `/emby` base URL normalize, HLS without invalid `copy` codecs, paginated episodes.
+- Shared resolve for `play`/`batch` (strict by default; `--pick-best-item` flag).
+- Homogeneous CLI messages (`output.py`); shared library/download loops; non-zero exit on errors / batch not-found.
+- `search`: paginate Emby results (was capped at 25); `--count` / `-n` to limit how many to return (default: all).
+- More tests (`test_client`, `test_output`, parser coverage).

{emby_cli-0.1.1 → emby_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: emby-cli
-Version: 0.1.1
+Version: 0.2.2
 Summary: CLI to list, search, play, and download/backup original media from an Emby server via its REST API.
 Project-URL: Homepage, https://github.com/soukron/emby-cli
 Project-URL: Repository, https://github.com/soukron/emby-cli
@@ -70,14 +70,23 @@ See `.env.example`. The app does not load `.env` itself — `source` it or expor
 ## Usage
 
 ```bash
+emby-cli version
+emby-cli info
 emby-cli list
 emby-cli search "Title"
+emby-cli search "Title" --count 50
 emby-cli download -i <itemId> -o ./downloads
 emby-cli sync -l "Movies"
 emby-cli batch -F titles.txt -n
+emby-cli batch -F titles.txt --pick-best-item
 emby-cli play "Movie (2010)"
+emby-cli play "Show S01E01" --pick-best-item
 ```
 
+`info` reports libraries and totals from `GET /Items/Counts` (totals may include multiple versions of the same title).
+
+Title resolution (`play` / `batch`) is **strict** by default (year mismatch or multiple matches fail that line). Pass `--pick-best-item` to auto-select the best ≤1080p version. In `batch`, a season line like `Show S01` downloads the whole season (with the same pick-best rule per episode version).
+
 Download methods (`-m` / `EMBY_METHOD`):
 
 - `download` — `GET /Items/{id}/Download`

{emby_cli-0.1.1 → emby_cli-0.2.2}/README.md

@@ -36,14 +36,23 @@ See `.env.example`. The app does not load `.env` itself — `source` it or expor
 ## Usage
 
 ```bash
+emby-cli version
+emby-cli info
 emby-cli list
 emby-cli search "Title"
+emby-cli search "Title" --count 50
 emby-cli download -i <itemId> -o ./downloads
 emby-cli sync -l "Movies"
 emby-cli batch -F titles.txt -n
+emby-cli batch -F titles.txt --pick-best-item
 emby-cli play "Movie (2010)"
+emby-cli play "Show S01E01" --pick-best-item
 ```
 
+`info` reports libraries and totals from `GET /Items/Counts` (totals may include multiple versions of the same title).
+
+Title resolution (`play` / `batch`) is **strict** by default (year mismatch or multiple matches fail that line). Pass `--pick-best-item` to auto-select the best ≤1080p version. In `batch`, a season line like `Show S01` downloads the whole season (with the same pick-best rule per episode version).
+
 Download methods (`-m` / `EMBY_METHOD`):
 
 - `download` — `GET /Items/{id}/Download`

{emby_cli-0.1.1 → emby_cli-0.2.2}/src/emby_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.1'
-__version_tuple__ = version_tuple = (0, 1, 1)
+__version__ = version = '0.2.2'
+__version_tuple__ = version_tuple = (0, 2, 2)
 
 __commit_id__ = commit_id = None

{emby_cli-0.1.1 → emby_cli-0.2.2}/src/emby_cli/cli.py

@@ -15,13 +15,21 @@ import requests
 from emby_cli.client import EmbyClient
 from emby_cli.commands.batch import cmd_batch
 from emby_cli.commands.download import cmd_download
+from emby_cli.commands.info import cmd_info
 from emby_cli.commands.list import cmd_list
 from emby_cli.commands.play import cmd_play
 from emby_cli.commands.search import cmd_search
 from emby_cli.commands.sync import cmd_sync
+from emby_cli.commands.version import cmd_version
 from emby_cli.constants import DEFAULT_OUTPUT
 
 
+_FORCE_HELP = (
+    "Re-download even if local file matches remote size "
+    "(or HLS .mkv + .done marker exists)"
+)
+
+
 def build_parser() -> argparse.ArgumentParser:
     env = os.environ.get
 
@@ -44,7 +52,7 @@ def build_parser() -> argparse.ArgumentParser:
     dl.add_argument("--item-id", "-i", default=env("EMBY_ITEM_ID"), help="Specific item ID to download (env: EMBY_ITEM_ID)")
     dl.add_argument("--output", "-o", default=env("EMBY_OUTPUT", DEFAULT_OUTPUT),
                     help=f"Output directory (env: EMBY_OUTPUT, default: {DEFAULT_OUTPUT})")
-    dl.add_argument("--force", "-f", action="store_true", help="Re-download even if file exists with matching size")
+    dl.add_argument("--force", "-f", action="store_true", help=_FORCE_HELP)
     dl.add_argument("--throttle", "-t", type=float, nargs="?", const=1.0, default=0,
                     help="Limit speed to playback rate. Optional multiplier: 1=realtime, 1.5=50%% faster (default: off)")
     dl.add_argument("--method", "-m", default=env("EMBY_METHOD", "download"),
@@ -54,6 +62,13 @@ def build_parser() -> argparse.ArgumentParser:
 
     sr = sub.add_parser("search", help="Search for items by name")
     sr.add_argument("query", help="Search query")
+    sr.add_argument(
+        "--count", "-n",
+        type=int,
+        default=None,
+        metavar="N",
+        help="Max results to return (default: all, paginated)",
+    )
 
     pl = sub.add_parser("play", help="Play an item via DirectStreamUrl in an external player")
     pl.add_argument("query", nargs="?",
@@ -65,15 +80,15 @@ def build_parser() -> argparse.ArgumentParser:
                          "/Applications/VLC.app/Contents/MacOS/VLC")
     pl.add_argument("--wait", action="store_true",
                     help="Block until the player process exits (default: detach and return)")
-    pl.add_argument("--pick-best-item", type=int, choices=[0, 1], default=0,
-                    help="On ambiguous search results: 0=list and require --item-id (default), "
-                         "1=auto-select best ≤1080p like batch")
+    pl.add_argument("--pick-best-item", action="store_true",
+                    help="On ambiguous search results, auto-select best ≤1080p "
+                         "(default: list matches and fail)")
 
     sy = sub.add_parser("sync", help="Sync all libraries (or one with --library)")
     sy.add_argument("--library", "-l", default=env("EMBY_LIBRARY"), help="Specific library to sync (env: EMBY_LIBRARY)")
     sy.add_argument("--output", "-o", default=env("EMBY_OUTPUT", DEFAULT_OUTPUT),
                     help=f"Output directory (env: EMBY_OUTPUT, default: {DEFAULT_OUTPUT})")
-    sy.add_argument("--force", "-f", action="store_true", help="Re-download even if file exists with matching size")
+    sy.add_argument("--force", "-f", action="store_true", help=_FORCE_HELP)
     sy.add_argument("--throttle", "-t", type=float, nargs="?", const=1.0, default=0,
                     help="Limit speed to playback rate. Optional multiplier: 1=realtime, 1.5=50%% faster (default: off)")
     sy.add_argument("--method", "-m", default=env("EMBY_METHOD", "download"),
@@ -86,13 +101,23 @@ def build_parser() -> argparse.ArgumentParser:
     ba.add_argument("--dry-run", "-n", action="store_true", help="Search and select only, do not download")
     ba.add_argument("--output", "-o", default=env("EMBY_OUTPUT", DEFAULT_OUTPUT),
                     help=f"Output directory (env: EMBY_OUTPUT, default: {DEFAULT_OUTPUT})")
-    ba.add_argument("--force", "-f", action="store_true", help="Re-download even if file exists with matching size")
+    ba.add_argument("--force", "-f", action="store_true", help=_FORCE_HELP)
     ba.add_argument("--throttle", "-t", type=float, nargs="?", const=1.0, default=0,
                     help="Limit speed to playback rate. Optional multiplier: 1=realtime, 1.5=50%% faster (default: off)")
     ba.add_argument("--method", "-m", default=env("EMBY_METHOD", "download"),
                     choices=["download", "stream", "hls"],
                     help="Download method: 'download' (API Download), 'stream' (browser-like original.*), "
                          "or 'hls' (stream chunks + remux) (env: EMBY_METHOD)")
+    ba.add_argument("--pick-best-item", action="store_true",
+                    help="On ambiguous search results, auto-select best ≤1080p "
+                         "(also per episode version in a season; default: fail the line)")
+
+    sub.add_parser("version", help="Show emby-cli version (and Emby server version if credentials work)")
+    sub.add_parser(
+        "info",
+        help="Show session user, server details, libraries, and item counts "
+             "(via /Items/Counts; versions may inflate totals)",
+    )
 
     return p
 
@@ -101,6 +126,14 @@ def main() -> None:
     parser = build_parser()
     args = parser.parse_args()
 
+    if args.command == "version":
+        cmd_version(args)
+        return
+
+    if args.command == "info":
+        cmd_info(args)
+        return
+
     if not args.server:
         parser.error("Provide --server or set EMBY_SERVER")