{"id":30746264,"url":"https://github.com/adamhl8/inspectarr","last_synced_at":"2025-10-24T11:37:17.404Z","repository":{"id":311668012,"uuid":"1044523904","full_name":"adamhl8/inspectarr","owner":"adamhl8","description":"A CLI tool for querying and inspecting the media in your Radarr and Sonarr instances","archived":false,"fork":false,"pushed_at":"2025-09-29T16:35:42.000Z","size":342,"stargazers_count":43,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-29T18:35:07.748Z","etag":null,"topics":["data","inspect","query","radarr","servarr","sonarr"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamhl8.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-25T20:17:40.000Z","updated_at":"2025-09-29T16:35:45.000Z","dependencies_parsed_at":"2025-08-25T22:15:35.306Z","dependency_job_id":"27c2d887-13ae-44d9-8f81-52baa4ee2a63","html_url":"https://github.com/adamhl8/inspectarr","commit_stats":null,"previous_names":["adamhl8/inspectarr"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/adamhl8/inspectarr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamhl8%2Finspectarr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamhl8%2Finspectarr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamhl8%2Finspectarr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamhl8%2Finspectarr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamhl8","download_url":"https://codeload.github.com/adamhl8/inspectarr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamhl8%2Finspectarr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278308618,"owners_count":25965654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","inspect","query","radarr","servarr","sonarr"],"created_at":"2025-09-04T04:01:48.534Z","updated_at":"2025-10-04T12:00:00.336Z","avatar_url":"https://github.com/adamhl8.png","language":"TypeScript","funding_links":[],"categories":["data"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003cimg align=\"top\" style=\"color:#36BCF7; width:38px; height:38px;\" src=\"https://raw.githubusercontent.com/adamhl8/inspectarr/refs/heads/main/assets/logo.svg\"\u003e Inspectarr\u003c/h1\u003e\n\nA CLI tool for querying and inspecting the media in your Radarr and Sonarr instances\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"demo\" src=\"https://github.com/adamhl8/inspectarr/blob/main/assets/demo.gif\"\u003e\n\u003c/p\u003e\n\n---\n\n\u003c!-- toc --\u003e\n\n- [Installation](#installation)\n  - [Homebrew (macOS/Linux)](#homebrew-macoslinux)\n  - [Scoop (Windows)](#scoop-windows)\n  - [Manual](#manual)\n- [Usage](#usage)\n  - [Setup](#setup)\n  - [Basic Usage](#basic-usage)\n  - [Queries](#queries)\n  - [Inspectarr Options](#inspectarr-options)\n\n\u003c!-- tocstop --\u003e\n\nIf you're looking for a more general tool to manage/change your \\*arrs, check out [managarr](https://github.com/Dark-Alex-17/managarr).\n\n## Installation\n\n### Homebrew (macOS/Linux)\n\n```sh\nbrew install adamhl8/inspectarr/inspectarr\n```\n\n### Scoop (Windows)\n\n```sh\nscoop bucket add inspectarr https://github.com/adamhl8/scoop-inspectarr.git\nscoop install inspectarr\n```\n\n### Manual\n\nBinaries are available on the [releases](https://github.com/adamhl8/inspectarr/releases) page.\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003ci\u003eWhy are the binaries so big?\u003c/i\u003e\u003c/summary\u003e\n  This project is written in TypeScript and the binaries are generated via \u003ca href=\"https://bun.com/docs/bundler/executables\"\u003eBun's compile feature\u003c/a\u003e. The Bun runtime itself is included in the binary, hence the size.\n\u003c/details\u003e\n\n## Usage\n\n### Setup\n\nInspectarr requires your Radarr/Sonarr URL and API key to connect to your instances. You can provide these via:\n\n- Environment variables: `RADARR_URL`, `RADARR_API_KEY`, `SONARR_URL`, `SONARR_API_KEY`\n- Or directly when running Inspectarr:\n  - e.g. `inspectarr radarr --url 'your-radarr-url' --api-key 'your-api-key'`\n\n### Basic Usage\n\n`inspectarr \u003cradarr|sonarr\u003e [options]... [query]`\n\n- Use `inspectarr \u003ccommand\u003e --help` to see more detailed usage info for a specific command.\n\nRunning Inspectarr without a query will display _all_ of your downloaded media:\n\n```sh\ninspectarr radarr\n```\n\n- By default, Inspectarr outputs a markdown table of the results.\n\nYou can also output the results as JSON if you want to do some further processing (pipe it to another command, etc.):\n\n```sh\ninspectarr sonarr --output json | json_pp\n```\n\n### Queries\n\nInspectarr uses [FilterQL](https://github.com/adamhl8/filterql) to filter/transform the results. See the [FilterQL readme](https://github.com/adamhl8/filterql#queries) for all of the available features.\n\n**Examples:**\n\n```sh\n# display media with a bluray source and 1080p (resolution starts with 1920)\ninspectarr radarr 'source == bluray \u0026\u0026 resolution ^= 1920'\n\n# display media from specific release groups\ninspectarr sonarr 'releaseGroup == NTb || releaseGroup == FLUX'\n\n# display media where the title contains 'star wars' (case-insensitive)\ninspectarr sonarr 'title i*= \"star wars\"'\n\n# display media where the title does *not* contain 'star wars'\ninspectarr sonarr '!title i*= \"star wars\"'\n\n# display media released after 1990, then sort by title\ninspectarr radarr 'year \u003e 1990 | SORT title'\n\n# display media where monitored is true and where the video codec is x265 (contains '265')\ninspectarr radarr 'monitored \u0026\u0026 videoCodec *= 265'\n```\n\n#### Fields\n\n\u003e [!TIP]\n\u003e Some fields are hidden by default to prevent the markdown table from being too wide.\n\u003e\n\u003e - To display hidden fields, use the `--all` option.\n\u003e\n\u003e You don't have to display hidden fields to use them in queries.\n\n\u003e [!TIP]\n\u003e If the markdown table is too wide, use the `EXCLUDE` operation to exclude specific fields/columns.\n\u003e\n\u003e For example: `inspectarr sonarr --all '* | EXCLUDE audioLanguage subtitleLanguage'`\n\n**General fields:**\n\n- `title` (alias: `t`) - Media title\n- `year` (alias: `y`) - Release year\n- `monitored` (alias: `m`) - Whether the media is monitored\n- `releaseGroup` (alias: `rg`) - Release group name\n- `source` (alias: `src`) - Media source (bluray, webdl, etc.)\n- `qualityProfile` (alias: `qp`) - Quality profile name\n- `videoCodec` (alias: `vc`) - Video codec (x264, x265, etc.)\n- `audioCodec` (alias: `ac`) - Audio codec (AAC, EAC3, etc.)\n- `audioChannels` (alias: `ach`) - Audio channels (2, 5.1, etc.)\n- `audioLanguage` (alias: `al`) - List of audio languages (eng, jpn, etc.)\n- `subtitleLanguage` (alias: `sl`) - List of subtitle languages (eng, spa, etc.)\n- `resolution` (alias: `rs`) - Video resolution\n- `size` (alias: `sz`) - File size\n\n**Sonarr-specific fields:**\n\n- `type` - Series type (standard, anime, daily)\n- `season` (alias: `s`) - Season number\n- `episode` (alias: `e`) - Episode number\n\n#### Internal Fields\n\nThese fields are used internally and are never displayed in the markdown table. The JSON output will always include all fields.\n\n- `rawResolution` - Total pixel count\n- `rawSize` - File size in bytes\n\n#### Operations\n\nIn addition to the [built-in FilterQL operations](https://github.com/adamhl8/filterql#operations), the following operations are available:\n\n- `EXCLUDE`: Exclude the given fields/columns from the output\n  - `EXCLUDE [field]...`\n\n```sh\n# display media with a bluray source and exclude the 'resolution' and 'size' columns\ninspectarr radarr 'source == bluray | EXCLUDE resolution size'\n```\n\n### Inspectarr Options\n\n**Service options:**\n\n- `--url`: The URL of the instance (default: \"\\\u003cSERVICE\\\u003e\\_URL\" environment variable)\n- `--api-key`: The API key for the instance (default: \"\\\u003cSERVICE\\\u003e\\_API_KEY\" environment variable)\n\n**Output options:**\n\n- `--all`: Show fields that are hidden by default in the markdown table\n- `--output md|json`: The type of output to generate (`json` implies `--quiet`) (default: `md`)\n- `--quiet`: Suppress all output except the markdown/JSON\n- `--short-headers`: Use the field aliases as the markdown table headers (can help reduce the width of the table)\n\n**Sonarr-specific options:**\n\nBy default, media from Sonarr is displayed by series.\n\n- `--by-season`: Display media by individual season\n- `--by-episode`: Display media by individual episode\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamhl8%2Finspectarr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamhl8%2Finspectarr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamhl8%2Finspectarr/lists"}