Dark-Alex-17/managarr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(README): Updated the README to include new features that are available in the Sonarr CLI release

Browse Source
This commit is contained in:
Alex Clarke
2024-11-25 16:52:08 -07:00
parent 80787d1187
commit 3ef5c1911d
1 changed files with 52 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+52 -28
View File
@@ -60,6 +60,7 @@ Key:
|--------------------|-----------| |--------------------|-----------|
| :white_check_mark: | Supported | | :white_check_mark: | Supported |
| :x: | Missing | | :x: | Missing |
| :clock3: | Planned |
| :no_entry_sign: | Won't Add | | :no_entry_sign: | Won't Add |
### Radarr ### Radarr
@@ -84,7 +85,25 @@ Key:
| :white_check_mark: | :white_check_mark: | Manually trigger scheduled tasks | | :white_check_mark: | :white_check_mark: | Manually trigger scheduled tasks |
### Sonarr ### Sonarr
- [ ] Support for Sonarr
| TUI | CLI | Feature |
|----------|--------------------|--------------------------------------------------------------------------------------------------------------------|
| :clock3: | :white_check_mark: | View your library, downloads, blocklist, episodes |
| :clock3: | :white_check_mark: | View details of a specific series, or episode including description, history, downloaded file info, or the credits |
| :clock3: | :white_check_mark: | View your host and security configs from the CLI to programmatically fetch the API token, among other settings |
| :clock3: | :white_check_mark: | Search your library |
| :clock3: | :white_check_mark: | Add series to your library |
| :clock3: | :white_check_mark: | Delete series, downloads, indexers, root folders, and episode files |
| :clock3: | :white_check_mark: | Mark history events as failed |
| :clock3: | :white_check_mark: | Trigger automatic searches for series, seasons, or episodes |
| :clock3: | :white_check_mark: | Trigger refresh and disk scan for series and downloads |
| :clock3: | :white_check_mark: | Manually search for series, seasons, or episodes |
| :clock3: | :white_check_mark: | Edit your series and indexers |
| :clock3: | :white_check_mark: | Manage your tags |
| :clock3: | :white_check_mark: | Manage your root folders |
| :clock3: | :white_check_mark: | Manage your blocklist |
| :clock3: | :white_check_mark: | View and browse logs, tasks, events queues, and updates |
| :clock3: | :white_check_mark: | Manually trigger scheduled tasks |
### Readarr ### Readarr
@@ -116,13 +135,13 @@ Managarr can be used in one of two ways: As a TUI, or as a CLI for managing your
All management features available in the TUI are also available in the CLI. However, the CLI is All management features available in the TUI are also available in the CLI. However, the CLI is
equipped with additional features to allow for more advanced usage and automation. equipped with additional features to allow for more advanced usage and automation.
The CLI can be helpful for automating tasks or for use in scripts. For example, you can use the CLI to trigger a search for a movie, or to add a movie to your library. The CLI can be helpful for automating tasks or for use in scripts. For example, you can use the CLI to trigger a search for a movie, or to add a movie to your Radarr library.
To see all available commands, simply run `managarr --help`: To see all available commands, simply run `managarr --help`:
```shell ```shell
$ managarr --help $ managarr --help
managarr 0.2.1 managarr 0.3.0
Alex Clarke <alex.j.tusa@gmail.com> Alex Clarke <alex.j.tusa@gmail.com>
A TUI and CLI to manage your Servarrs A TUI and CLI to manage your Servarrs
@@ -131,43 +150,48 @@ Usage: managarr [OPTIONS] [COMMAND]
Commands: Commands:
radarr Commands for manging your Radarr instance radarr Commands for manging your Radarr instance
sonarr Commands for manging your Sonarr instance
completions Generate shell completions for the Managarr CLI completions Generate shell completions for the Managarr CLI
tail-logs Tail Managarr logs
help Print this message or the help of the given subcommand(s) help Print this message or the help of the given subcommand(s)
Options: Options:
--config <CONFIG> The Managarr configuration file to use --disable-spinner Disable the spinner (can sometimes make parsing output challenging) [env: MANAGARR_DISABLE_SPINNER=]
-h, --help Print help --config <CONFIG> The Managarr configuration file to use [env: MANAGARR_CONFIG_FILE=]
-V, --version Print version -h, --help Print help
-V, --version Print version
``` ```
All subcommands also have detailed help menus to show you how to use them. For example, to see all available commands for Radarr, you would run: All subcommands also have detailed help menus to show you how to use them. For example, to see all available commands for Sonarr, you would run:
```shell ```shell
$ managarr radarr --help $ managarr sonarr --help
Commands for manging your Radarr instance Commands for manging your Sonarr instance
Usage: managarr radarr [OPTIONS] <COMMAND> Usage: managarr sonarr [OPTIONS] <COMMAND>
Commands: Commands:
add Commands to add or create new resources within your Radarr instance add Commands to add or create new resources within your Sonarr instance
delete Commands to delete resources from your Radarr instance delete Commands to delete resources from your Sonarr instance
edit Commands to edit resources in your Radarr instance edit Commands to edit resources in your Sonarr instance
get Commands to fetch details of the resources in your Radarr instance get Commands to fetch details of the resources in your Sonarr instance
list Commands to list attributes from your Radarr instance download Commands to download releases in your Sonarr instance
refresh Commands to refresh the data in your Radarr instance list Commands to list attributes from your Sonarr instance
clear-blocklist Clear the blocklist refresh Commands to refresh the data in your Sonarr instance
download-release Manually download the given release for the specified movie ID manual-search Commands to manually search for releases
manual-search Trigger a manual search of releases for the movie with the given ID trigger-automatic-search Commands to trigger automatic searches for releases of different resources in your Sonarr instance
search-new-movie Search for a new film to add to Radarr clear-blocklist Clear the blocklist
start-task Start the specified Radarr task mark-history-item-as-failed Mark the Sonarr history item with the given ID as 'failed'
test-indexer Test the indexer with the given ID. Note that a successful test returns an empty JSON body; i.e. '{}' search-new-series Search for a new series to add to Sonarr
test-all-indexers Test all indexers start-task Start the specified Sonarr task
trigger-automatic-search Trigger an automatic search for the movie with the specified ID test-indexer Test the indexer with the given ID. Note that a successful test returns an empty JSON body; i.e. '{}'
help Print this message or the help of the given subcommand(s) test-all-indexers Test all Sonarr indexers
help Print this message or the help of the given subcommand(s)
Options: Options:
--config <CONFIG> The Managarr configuration file to use --disable-spinner Disable the spinner (can sometimes make parsing output challenging) [env: MANAGARR_DISABLE_SPINNER=]
-h, --help Print help --config <CONFIG> The Managarr configuration file to use [env: MANAGARR_CONFIG_FILE=]
-h, --help Print help
``` ```
**Pro Tip:** The CLI is even more powerful and useful when used in conjunction with the `jq` CLI tool. This allows you to parse the JSON response from the Managarr CLI and use it in your scripts; For example, to extract the `movieId` of the movie "Ad Astra", you would run: **Pro Tip:** The CLI is even more powerful and useful when used in conjunction with the `jq` CLI tool. This allows you to parse the JSON response from the Managarr CLI and use it in your scripts; For example, to extract the `movieId` of the movie "Ad Astra", you would run:
@@ -181,7 +205,7 @@ $ managarr radarr list movies | jq '.[] | select(.title == "Ad Astra") | .id'
Managarr assumes reasonable defaults to connect to each service (i.e. Radarr is on localhost:7878), Managarr assumes reasonable defaults to connect to each service (i.e. Radarr is on localhost:7878),
but all servers will require you to input the API token. but all servers will require you to input the API token.
The configuration file is located somewhere different for each OS The configuration file is located somewhere different for each OS.
### Linux ### Linux
``` ```