"Upon success, the response will contain a cookie with your SID. You must supply the cookie whenever you want to perform an operation that requires authentication.\n\nExample showing how to login and execute a command that requires authentication using `curl`:\n\n```sh\n$ curl -i --header 'Referer: http://localhost:8080' --data 'username=admin&password=adminadmin' http://localhost:8080/api/v2/auth/login\nHTTP/1.1 200 OK\nContent-Encoding:\nContent-Length: 3\nContent-Type: text/plain; charset=UTF-8\nSet-Cookie: SID=hBc7TxF76ERhvIw0jQQ4LZ7Z1jQUV0tQ; path=/\n$ curl http://localhost:8080/api/v2/torrents/info --cookie \"SID=hBc7TxF76ERhvIw0jQQ4LZ7Z1jQUV0tQ\"\n```\n\nNote: Set `Referer` or `Origin` header to the exact same domain and port as used in the HTTP query `Host` header.",
"Currently selected language (e.g. en_GB for English)",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "create_subfolder_enabled",
description: Some(
"True if a subfolder should be created when adding a torrent",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "start_paused_enabled",
description: Some(
"True if torrents should be added in a Paused state",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "auto_delete_mode",
description: Some(
"TODO",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "preallocate_all",
description: Some(
"True if disk space should be pre-allocated for all files",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "incomplete_files_ext",
description: Some(
"True if \".!qB\" should be appended to incomplete files",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "auto_tmm_enabled",
description: Some(
"True if Automatic Torrent Management is enabled by default",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "torrent_changed_tmm_enabled",
description: Some(
"True if torrent should be relocated when its Category changes",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "save_path_changed_tmm_enabled",
description: Some(
"True if torrent should be relocated when the default save path changes",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "category_changed_tmm_enabled",
description: Some(
"True if torrent should be relocated when its Category's save path changes",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "save_path",
description: Some(
"Default save path for torrents, separated by slashes",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "temp_path_enabled",
description: Some(
"True if folder for incomplete torrents is enabled",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "temp_path",
description: Some(
"Path for incomplete torrents, separated by slashes",
),
is_optional: true,
is_list: false,
},
),
Object(
Object {
type_info: TypeInfo {
name: "scan_dirs",
description: Some(
"scan_dirs object see table below. Property: directory to watch for torrent files, value: where torrents loaded from this directory should be downloaded to (see list of possible values below). Slashes are used as path separators; multiple key/value pairs can be specified",
),
is_optional: true,
is_list: false,
},
ref_type: String(
"ScanDirs",
),
},
),
String(
TypeInfo {
name: "export_dir",
description: Some(
"Path to directory to copy .torrent files to. Slashes are used as path separators",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "export_dir_fin",
description: Some(
"Path to directory to copy .torrent files of completed downloads to. Slashes are used as path separators",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "mail_notification_enabled",
description: Some(
"True if e-mail notification should be enabled",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "mail_notification_sender",
description: Some(
"e-mail where notifications should originate from",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "mail_notification_email",
description: Some(
"e-mail to send notifications to",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "mail_notification_smtp",
description: Some(
"smtp server for e-mail notifications",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "mail_notification_ssl_enabled",
description: Some(
"True if smtp server requires SSL connection",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "mail_notification_auth_enabled",
description: Some(
"True if smtp server requires authentication",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "mail_notification_username",
description: Some(
"Username for smtp authentication",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "mail_notification_password",
description: Some(
"Password for smtp authentication",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "autorun_enabled",
description: Some(
"True if external program should be run after torrent has finished downloading",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "autorun_program",
description: Some(
"Program path/name/arguments to run if autorun_enabled is enabled; path is separated by slashes; you can use %f and %n arguments, which will be expanded by qBittorent as path_to_torrent_file and torrent_name (from the GUI; not the .torrent file name) respectively",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "queueing_enabled",
description: Some(
"True if torrent queuing is enabled",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_active_downloads",
description: Some(
"Maximum number of active simultaneous downloads",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_active_torrents",
description: Some(
"Maximum number of active simultaneous downloads and uploads",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_active_uploads",
description: Some(
"Maximum number of active simultaneous uploads",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "dont_count_slow_torrents",
description: Some(
"If true torrents w/o any activity (stalled ones) will not be counted towards max_active_* limits; see [dont_count_slow_torrents](https://www.libtorrent.org/reference-Settings.html#dont_count_slow_torrents) for more information",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "slow_torrent_dl_rate_threshold",
description: Some(
"Download rate in KiB/s for a torrent to be considered \"slow\"",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "slow_torrent_ul_rate_threshold",
description: Some(
"Upload rate in KiB/s for a torrent to be considered \"slow\"",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "slow_torrent_inactive_timer",
description: Some(
"Seconds a torrent should be inactive before considered \"slow\"",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "max_ratio_enabled",
description: Some(
"True if share ratio limit is enabled",
),
is_optional: true,
is_list: false,
},
),
Float(
TypeInfo {
name: "max_ratio",
description: Some(
"Get the global share ratio limit",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_ratio_act",
description: Some(
"Action performed when a torrent reaches the maximum share ratio. See list of possible values here below.",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "listen_port",
description: Some(
"Port for incoming connections",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "upnp",
description: Some(
"True if UPnP/NAT-PMP is enabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "random_port",
description: Some(
"True if the port is randomly selected",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "dl_limit",
description: Some(
"Global download speed limit in KiB/s; -1 means no limit is applied",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "up_limit",
description: Some(
"Global upload speed limit in KiB/s; -1 means no limit is applied",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_connec",
description: Some(
"Maximum global number of simultaneous connections",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_connec_per_torrent",
description: Some(
"Maximum number of simultaneous connections per torrent",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_uploads",
description: Some(
"Maximum number of upload slots",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_uploads_per_torrent",
description: Some(
"Maximum number of upload slots per torrent",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "stop_tracker_timeout",
description: Some(
"Timeout in seconds for a stopped announce request to trackers",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "enable_piece_extent_affinity",
description: Some(
"True if the advanced libtorrent option piece_extent_affinity is enabled",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "bittorrent_protocol",
description: Some(
"Bittorrent Protocol to use (see list of possible values below)",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "limit_utp_rate",
description: Some(
"True if [du]l_limit should be applied to uTP connections; this option is only available in qBittorent built against libtorrent version 0.16.X and higher",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "limit_tcp_overhead",
description: Some(
"True if [du]l_limit should be applied to estimated TCP overhead (service data: e.g. packet headers)",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "limit_lan_peers",
description: Some(
"True if [du]l_limit should be applied to peers on the LAN",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "alt_dl_limit",
description: Some(
"Alternative global download speed limit in KiB/s",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "alt_up_limit",
description: Some(
"Alternative global upload speed limit in KiB/s",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "scheduler_enabled",
description: Some(
"True if alternative limits should be applied according to schedule",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "schedule_from_hour",
description: Some(
"Scheduler starting hour",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "schedule_from_min",
description: Some(
"Scheduler starting minute",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "schedule_to_hour",
description: Some(
"Scheduler ending hour",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "schedule_to_min",
description: Some(
"Scheduler ending minute",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "scheduler_days",
description: Some(
"Scheduler days. See possible values here below",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "dht",
description: Some(
"True if DHT is enabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "pex",
description: Some(
"True if PeX is enabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "lsd",
description: Some(
"True if LSD is enabled",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "encryption",
description: Some(
"See list of possible values here below",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "anonymous_mode",
description: Some(
"If true anonymous mode will be enabled; read more [here](Anonymous-Mode); this option is only available in qBittorent built against libtorrent version 0.16.X and higher",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "proxy_type",
description: Some(
"See list of possible values here below",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "proxy_ip",
description: Some(
"Proxy IP address or domain name",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "proxy_port",
description: Some(
"Proxy port",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "proxy_peer_connections",
description: Some(
"True if peer and web seed connections should be proxified; this option will have any effect only in qBittorent built against libtorrent version 0.16.X and higher",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "proxy_auth_enabled",
description: Some(
"True proxy requires authentication; doesn't apply to SOCKS4 proxies",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "proxy_username",
description: Some(
"Username for proxy authentication",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "proxy_password",
description: Some(
"Password for proxy authentication",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "proxy_torrents_only",
description: Some(
"True if proxy is only used for torrents",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "ip_filter_enabled",
description: Some(
"True if external IP filter should be enabled",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "ip_filter_path",
description: Some(
"Path to IP filter file (.dat, .p2p, .p2b files are supported); path is separated by slashes",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "ip_filter_trackers",
description: Some(
"True if IP filters are applied to trackers",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_domain_list",
description: Some(
"Comma-separated list of domains to accept when performing Host header validation",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_address",
description: Some(
"IP address to use for the WebUI",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "web_ui_port",
description: Some(
"WebUI port",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "web_ui_upnp",
description: Some(
"True if UPnP is used for the WebUI port",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_username",
description: Some(
"WebUI username",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_password",
description: Some(
"For API ≥ v2.3.0: Plaintext WebUI password, not readable, write-only. For API < v2.3.0: MD5 hash of WebUI password, hash is generated from the following string: username:Web UI Access:plain_text_web_ui_password",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "web_ui_csrf_protection_enabled",
description: Some(
"True if WebUI CSRF protection is enabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "web_ui_clickjacking_protection_enabled",
description: Some(
"True if WebUI clickjacking protection is enabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "web_ui_secure_cookie_enabled",
description: Some(
"True if WebUI cookie Secure flag is enabled",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "web_ui_max_auth_fail_count",
description: Some(
"Maximum number of authentication failures before WebUI access ban",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "web_ui_ban_duration",
description: Some(
"WebUI access ban duration in seconds",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "web_ui_session_timeout",
description: Some(
"Seconds until WebUI is automatically signed off",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "web_ui_host_header_validation_enabled",
description: Some(
"True if WebUI host header validation is enabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "bypass_local_auth",
description: Some(
"True if authentication challenge for loopback address (127.0.0.1) should be disabled",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "bypass_auth_subnet_whitelist_enabled",
description: Some(
"True if webui authentication should be bypassed for clients whose ip resides within (at least) one of the subnets on the whitelist",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "bypass_auth_subnet_whitelist",
description: Some(
"(White)list of ipv4/ipv6 subnets for which webui authentication should be bypassed; list entries are separated by commas",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "alternative_webui_enabled",
description: Some(
"True if an alternative WebUI should be used",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "alternative_webui_path",
description: Some(
"File path to the alternative WebUI",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "use_https",
description: Some(
"True if WebUI HTTPS access is enabled",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "ssl_key",
description: Some(
"For API < v2.0.1: SSL keyfile contents (this is a not a path)",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "ssl_cert",
description: Some(
"For API < v2.0.1: SSL certificate contents (this is a not a path)",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_https_key_path",
description: Some(
"For API ≥ v2.0.1: Path to SSL keyfile",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_https_cert_path",
description: Some(
"For API ≥ v2.0.1: Path to SSL certificate",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "dyndns_enabled",
description: Some(
"True if server DNS should be updated dynamically",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "dyndns_service",
description: Some(
"See list of possible values here below",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "dyndns_username",
description: Some(
"Username for DDNS service",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "dyndns_password",
description: Some(
"Password for DDNS service",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "dyndns_domain",
description: Some(
"Your DDNS domain name",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "rss_refresh_interval",
description: Some(
"RSS refresh interval",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "rss_max_articles_per_feed",
description: Some(
"Max stored articles per RSS feed",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "rss_processing_enabled",
description: Some(
"Enable processing of RSS feeds",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "rss_auto_downloading_enabled",
description: Some(
"Enable auto-downloading of torrents from the RSS feeds",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "rss_download_repack_proper_episodes",
description: Some(
"For API ≥ v2.5.1: Enable downloading of repack/proper Episodes",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "rss_smart_episode_filters",
description: Some(
"For API ≥ v2.5.1: List of RSS Smart Episode Filters",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "add_trackers_enabled",
description: Some(
"Enable automatic adding of trackers to new torrents",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "add_trackers",
description: Some(
"List of trackers to add to new torrent",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "web_ui_use_custom_http_headers_enabled",
description: Some(
"For API ≥ v2.5.1: Enable custom http headers",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "web_ui_custom_http_headers",
description: Some(
"For API ≥ v2.5.1: List of custom http headers",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "max_seeding_time_enabled",
description: Some(
"True enables max seeding time",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_seeding_time",
description: Some(
"Number of minutes to seed a torrent",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "announce_ip",
description: Some(
"TODO",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "announce_to_all_tiers",
description: Some(
"True always announce to all tiers",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "announce_to_all_trackers",
description: Some(
"True always announce to all trackers in a tier",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "async_io_threads",
description: Some(
"Number of asynchronous I/O threads",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "banned_IPs",
description: Some(
"List of banned IPs",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "checking_memory_use",
description: Some(
"Outstanding memory when checking torrents in MiB",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "current_interface_address",
description: Some(
"IP Address to bind to. Empty String means All addresses",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "current_network_interface",
description: Some(
"Network Interface used",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "disk_cache",
description: Some(
"Disk cache used in MiB",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "disk_cache_ttl",
description: Some(
"Disk cache expiry interval in seconds",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "embedded_tracker_port",
description: Some(
"Port used for embedded tracker",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "enable_coalesce_read_write",
description: Some(
"True enables coalesce reads & writes",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "enable_embedded_tracker",
description: Some(
"True enables embedded tracker",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "enable_multi_connections_from_same_ip",
description: Some(
"True allows multiple connections from the same IP address",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "enable_os_cache",
description: Some(
"True enables os cache",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "enable_upload_suggestions",
description: Some(
"True enables sending of upload piece suggestions",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "file_pool_size",
description: Some(
"File pool size",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "outgoing_ports_max",
description: Some(
"Maximal outgoing port (0: Disabled)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "outgoing_ports_min",
description: Some(
"Minimal outgoing port (0: Disabled)",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "recheck_completed_torrents",
description: Some(
"True rechecks torrents on completion",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "resolve_peer_countries",
description: Some(
"True resolves peer countries",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "save_resume_data_interval",
description: Some(
"Save resume data interval in min",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "send_buffer_low_watermark",
description: Some(
"Send buffer low watermark in KiB",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "send_buffer_watermark",
description: Some(
"Send buffer watermark in KiB",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "send_buffer_watermark_factor",
description: Some(
"Send buffer watermark factor in percent",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "socket_backlog_size",
description: Some(
"Socket backlog size",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "upload_choking_algorithm",
description: Some(
"Upload choking algorithm used (see list of possible values below)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "upload_slots_behavior",
description: Some(
"Upload slots behavior used (see list of possible values below)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "upnp_lease_duration",
description: Some(
"UPnP lease duration (0: Permanent lease)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "utp_tcp_mixed_mode",
description: Some(
"μTP-TCP mixed mode algorithm (see list of possible values below)",
"1. There is no need to pass all possible preferences' `token:value` pairs if you only want to change one option\n 1. Paths in `scan_dirs` must exist, otherwise this option will have no effect\n 1. String values must be quoted; integer and boolean values must never be quoted\n\nFor a list of possible preference options see [Get application preferences](#get-application-preferences)",
),
url: "setPreferences",
types: CompositeTypes {
composite_types: [],
},
},
ApiMethod {
name: "defaultSavePath",
description: Some(
"The response is a string with the default save path, e.g. `C:/Users/Dayman/Downloads`.",
),
url: "defaultSavePath",
types: CompositeTypes {
composite_types: [],
},
},
],
description: Some(
"All Application API methods are under \"app\", e.g.: `/api/v2/app/methodName`.",
),
url: "app",
},
ApiGroup {
name: "log",
methods: [
ApiMethod {
name: "main",
description: Some(
"The response is a JSON array in which each element is an entry of the log.\n\nEach element of the array has the following properties:\n\n\nExample:\n\n```JSON\n[\n {\n \"id\":0,\n \"message\":\"qBittorrent v3.4.0 started\",\n \"timestamp\":1507969127860,\n \"type\":1\n },\n {\n \"id\":1,\n \"message\":\"qBittorrent is trying to listen on any interface port: 19036\",\n \"timestamp\":1507969127869,\n \"type\":2\n },\n {\n \"id\":2,\n \"message\":\"Peer ID: -qB3400-\",\n \"timestamp\":1507969127870,\n \"type\":1\n },\n {\n \"id\":3,\n \"message\":\"HTTP User-Agent is 'qBittorrent/3.4.0'\",\n \"timestamp\":1507969127870,\n \"type\":1\n },\n {\n \"id\":4,\n \"message\":\"DHT support [ON]\",\n \"timestamp\":1507969127871,\n \"type\":2\n },\n {\n \"id\":5,\n \"message\":\"Local Peer Discovery support [ON]\",\n \"timestamp\":1507969127871,\n \"type\":2\n },\n {\n \"id\":6,\n \"message\":\"PeX support [ON]\",\n \"timestamp\":1507969127871,\n \"type\":2\n },\n {\n \"id\":7,\n \"message\":\"Anonymous mode [OFF]\",\n \"timestamp\":1507969127871,\n \"type\":2\n },\n {\n \"id\":8,\n \"message\":\"Encryption support [ON]\",\n \"timestamp\":1507969127871,\n \"type\":2\n },\n {\n \"id\":9,\n \"message\":\"Embedded Tracker [OFF]\",\n \"timestamp\":1507969127871,\n \"type\":2\n },\n {\n \"id\":10,\n \"message\":\"UPnP / NAT-PMP support [ON]\",\n \"timestamp\":1507969127873,\n \"type\":2\n },\n {\n \"id\":11,\n \"message\":\"Web UI: Now listening on port 8080\",\n \"timestamp\":1507969127883,\n \"type\":1\n },\n {\n \"id\":12,\n \"message\":\"Options were saved successfully.\",\n \"timestamp\":1507969128055,\n \"type\":1\n },\n {\n \"id\":13,\n \"message\":\"qBittorrent is successfully listening on interface :: port: TCP/19036\",\n \"timestamp\":1507969128270,\n \"type\":2\n },\n {\n \"id\":14,\n \"message\":\"qBittorrent is successfully listening on interface 0.0.0.0 port: TCP/19036\",\n \"timestamp\":1507969128271,\n \"type\":2\n },\n {\n \"id\":15,\n \"message\":\"qBittorrent is successfully listening on interface 0.0.0.0 port: UDP/19036\",\n \"timestamp\":1507969128272,\n \"type\":2\n }\n]\n```",
"All Log API methods are under \"log\", e.g.: `/api/v2/log/methodName`.",
),
url: "log",
},
ApiGroup {
name: "sync",
methods: [
ApiMethod {
name: "maindata",
description: Some(
"The response is a JSON object with the following possible fields\n\n\nExample:\n\n```JSON\n{\n \"rid\":15,\n \"torrents\":\n {\n \"8c212779b4abde7c6bc608063a0d008b7e40ce32\":\n {\n \"state\":\"pausedUP\"\n }\n }\n}\n```",
"Response ID. If not provided, rid=0 will be assumed. If the given rid is different from the one of last server reply, full_update will be true (see the server reply details for more info)",
),
is_optional: false,
is_list: false,
},
),
],
is_list: false,
},
),
Object(
TypeWithName {
name: "ServerState",
types: [
Number(
TypeInfo {
name: "average_time_queue",
description: Some(
"Average time queue",
),
is_optional: false,
is_list: false,
},
),
Number(
TypeInfo {
name: "dl_info_data",
description: Some(
"Download info data",
),
is_optional: false,
is_list: false,
},
),
Number(
TypeInfo {
name: "dl_info_speed",
description: Some(
"Download info speed",
),
is_optional: false,
is_list: false,
},
),
Number(
TypeInfo {
name: "queued_io_jobs",
description: Some(
"Queued io jobs",
),
is_optional: false,
is_list: false,
},
),
Number(
TypeInfo {
name: "total_buffers_size",
description: Some(
"Total buffers size",
),
is_optional: false,
is_list: false,
},
),
Number(
TypeInfo {
name: "total_peer_connections",
description: Some(
"Total peer connections",
),
is_optional: false,
is_list: false,
},
),
],
},
),
Response(
TypeWithoutName {
types: [
Number(
TypeInfo {
name: "rid",
description: Some(
"Response ID",
),
is_optional: false,
is_list: false,
},
),
Bool(
TypeInfo {
name: "full_update",
description: Some(
"Whether the response contains all the data or partial data",
),
is_optional: true,
is_list: false,
},
),
Object(
Object {
type_info: TypeInfo {
name: "torrents",
description: Some(
"Property: torrent hash, value: same as [torrent list](#get-torrent-list), map from string to torrents object",
),
is_optional: true,
is_list: false,
},
ref_type: Map(
"String",
"Torrents",
),
},
),
Object(
Object {
type_info: TypeInfo {
name: "torrents_removed",
description: Some(
"List of hashes of torrents removed since last request",
),
is_optional: true,
is_list: true,
},
ref_type: String(
"String",
),
},
),
Object(
Object {
type_info: TypeInfo {
name: "categories",
description: Some(
"Info for categories added since last request, map from string to categories object",
),
is_optional: true,
is_list: false,
},
ref_type: Map(
"String",
"Categories",
),
},
),
Object(
Object {
type_info: TypeInfo {
name: "categories_removed",
description: Some(
"List of categories removed since last request",
),
is_optional: true,
is_list: true,
},
ref_type: String(
"String",
),
},
),
Object(
Object {
type_info: TypeInfo {
name: "tags",
description: Some(
"List of tags added since last request",
),
is_optional: true,
is_list: true,
},
ref_type: String(
"String",
),
},
),
Object(
Object {
type_info: TypeInfo {
name: "tags_removed",
description: Some(
"List of tags removed since last request",
),
is_optional: true,
is_list: true,
},
ref_type: String(
"String",
),
},
),
Object(
Object {
type_info: TypeInfo {
name: "server_state",
description: Some(
"server_state object see table below",
),
is_optional: true,
is_list: false,
},
ref_type: String(
"ServerState",
),
},
),
],
is_list: false,
},
),
Object(
TypeWithName {
name: "Torrents",
types: [
Number(
TypeInfo {
name: "added_on",
description: Some(
"Time (Unix Epoch) when the torrent was added to the client",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "amount_left",
description: Some(
"Amount of data left to download (bytes)",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "auto_tmm",
description: Some(
"Whether this torrent is managed by Automatic Torrent Management",
),
is_optional: true,
is_list: false,
},
),
Float(
TypeInfo {
name: "availability",
description: Some(
"Percentage of file pieces currently available",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "category",
description: Some(
"Category of the torrent",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "completed",
description: Some(
"Amount of transfer data completed (bytes)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "completion_on",
description: Some(
"Time (Unix Epoch) when the torrent completed",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "content_path",
description: Some(
"Absolute path of torrent content (root path for multifile torrents, absolute file path for singlefile torrents)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "dl_limit",
description: Some(
"Torrent download speed limit (bytes/s). -1 if ulimited.",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "dlspeed",
description: Some(
"Torrent download speed (bytes/s)",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "downloaded",
description: Some(
"Amount of data downloaded",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "downloaded_session",
description: Some(
"Amount of data downloaded this session",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "eta",
description: Some(
"Torrent ETA (seconds)",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "f_l_piece_prio",
description: Some(
"True if first last piece are prioritized",
),
is_optional: true,
is_list: false,
},
),
Bool(
TypeInfo {
name: "force_start",
description: Some(
"True if force start is enabled for this torrent",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "hash",
description: Some(
"Torrent hash",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "last_activity",
description: Some(
"Last time (Unix Epoch) when a chunk was downloaded/uploaded",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "magnet_uri",
description: Some(
"Magnet URI corresponding to this torrent",
),
is_optional: true,
is_list: false,
},
),
Float(
TypeInfo {
name: "max_ratio",
description: Some(
"Maximum share ratio until torrent is stopped from seeding/uploading",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "max_seeding_time",
description: Some(
"Maximum seeding time (seconds) until torrent is stopped from seeding",
),
is_optional: true,
is_list: false,
},
),
String(
TypeInfo {
name: "name",
description: Some(
"Torrent name",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "num_complete",
description: Some(
"Number of seeds in the swarm",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "num_incomplete",
description: Some(
"Number of leechers in the swarm",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "num_leechs",
description: Some(
"Number of leechers connected to",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "num_seeds",
description: Some(
"Number of seeds connected to",
),
is_optional: true,
is_list: false,
},
),
Number(
TypeInfo {
name: "priority",
description: Some(
"Torrent priority. Returns -1 if queuing is disabled or torrent is in seed mode",
"TODO (what is different from max_seeding_time?) seeding_time_limit is a per torrent setting, when Automatic Torrent Management is disabled, furthermore then max_seeding_time is set to seeding_time_limit for this torrent. If Automatic Torrent Management is enabled, the value is -2. And if max_seeding_time is unset it have a default value -1.",
"Response ID. If not provided, rid=0 will be assumed. If the given rid is different from the one of last server reply, full_update will be true (see the server reply details for more info)",
"Sync API implements requests for obtaining changes since the last request.\nAll Sync API methods are under \"sync\", e.g.: `/api/v2/sync/methodName`.",
),
url: "sync",
},
ApiGroup {
name: "transfer_info",
methods: [
ApiMethod {
name: "info",
description: Some(
"The response is a JSON object with the following fields\n\n\nIn addition to the above in partial data requests (see [Get partial data](#get-partial-data) for more info):\n\n\nPossible values of `connection_status`:\n\nValue |\n\nExample:\n\n```JSON\n{\n \"connection_status\":\"connected\",\n \"dht_nodes\":386,\n \"dl_info_data\":681521119,\n \"dl_info_speed\":0,\n \"dl_rate_limit\":0,\n \"up_info_data\":10747904,\n \"up_info_speed\":0,\n \"up_rate_limit\":1048576\n}\n```",
"All Transfer info API methods are under \"transfer\", e.g.: `/api/v2/transfer/methodName`.",
),
url: "transfer",
},
ApiGroup {
name: "torrent_management",
methods: [
ApiMethod {
name: "info",
description: Some(
"The response is a JSON array with the following fields\n\n\nPossible values of `state`:\n\n\nExample:\n\n```JSON\n[\n {\n \"dlspeed\":9681262,\n \"eta\":87,\n \"f_l_piece_prio\":false,\n \"force_start\":false,\n \"hash\":\"8c212779b4abde7c6bc608063a0d008b7e40ce32\",\n \"category\":\"\",\n \"tags\": \"\",\n \"name\":\"debian-8.1.0-amd64-CD-1.iso\",\n \"num_complete\":-1,\n \"num_incomplete\":-1,\n \"num_leechs\":2,\n \"num_seeds\":54,\n \"priority\":1,\n \"progress\":0.16108787059783936,\n \"ratio\":0,\n \"seq_dl\":false,\n \"size\":657457152,\n \"state\":\"downloading\",\n \"super_seeding\":false,\n \"upspeed\":0\n },\n {\n another_torrent_info\n }\n]\n```",
),
url: "info",
types: CompositeTypes {
composite_types: [
Parameters(
TypeWithoutName {
types: [
String(
TypeInfo {
name: "filter",
description: Some(
"Filter torrent list by state. Allowed state filters: all, downloading, seeding, completed, paused, active, inactive, resumed, stalled, stalled_uploading, stalled_downloading, errored",
"Get torrents with the given category (empty string means \"without category\"; no \"category\" parameter means \"any category\" <- broken until [#11748](https://github.com/qbittorrent/qBittorrent/issues/11748) is resolved). Remember to URL-encode the category name. For example, My category becomes My%20category",
"Get torrents with the given tag (empty string means \"without tag\"; no \"tag\" parameter means \"any tag\". Remember to URL-encode the category name. For example, My tag becomes My%20tag",
"TODO (what is different from max_seeding_time?) seeding_time_limit is a per torrent setting, when Automatic Torrent Management is disabled, furthermore then max_seeding_time is set to seeding_time_limit for this torrent. If Automatic Torrent Management is enabled, the value is -2. And if max_seeding_time is unset it have a default value -1.",
"The response is a JSON of objects containing the following fields:\n\n\nNB: `-1` is returned if the type of the property is integer but its value is not known.\n\nExample:\n\n```JSON\n{\n \"addition_date\":1438429165,\n \"comment\":\"\\\"Debian CD from cdimage.debian.org\\\"\",\n \"completion_date\":1438429234,\n \"created_by\":\"\",\n \"creation_date\":1433605214,\n \"dl_limit\":-1,\n \"dl_speed\":0,\n \"dl_speed_avg\":9736015,\n \"eta\":8640000,\n \"last_seen\":1438430354,\n \"nb_connections\":3,\n \"nb_connections_limit\":250,\n \"peers\":1,\n \"peers_total\":89,\n \"piece_size\":524288,\n \"pieces_have\":1254,\n \"pieces_num\":1254,\n \"reannounce\":672,\n \"save_path\":\"/Downloads/debian-8.1.0-amd64-CD-1.iso\",\n \"seeding_time\":1128,\n \"seeds\":1,\n \"seeds_total\":254,\n \"share_ratio\":0.00072121022562178299,\n \"time_elapsed\":1197,\n \"total_downloaded\":681521119,\n \"total_downloaded_session\":681521119,\n \"total_size\":657457152,\n \"total_uploaded\":491520,\n \"total_uploaded_session\":491520,\n \"total_wasted\":23481724,\n \"up_limit\":-1,\n \"up_speed\":0,\n \"up_speed_avg\":410\n}\n```",
"The response is a JSON array, where each element contains info about one tracker, with the following fields\n\n\nPossible values of `status`:\n\n\nExample:\n\n```JSON\n[\n {\n \"msg\":\"\",\n \"num_peers\":100,\n \"status\":2,\n \"url\":\"http://bttracker.debian.org:6969/announce\"\n },\n {\n another_tracker_info\n }\n]\n```",
"Tracker priority tier. Lower tier trackers are tried before higher tiers. Tier numbers are valid when >= 0, < 0 is used as placeholder when tier does not exist for special entries (such as DHT).",
"The response is a JSON array, where each element is information about one webseed, with the following fields\n\n\nExample:\n\n```JSON\n[\n {\n \"url\":\"http://some_url/\"\n },\n {\n \"url\":\"http://some_other_url/\"\n }\n]\n```",
"The response is a JSON array of objects containing the following fields:\n\n\nPossible values of `priority`:\n\n\nExample:\n\n```JSON\n\n[\n {\n \"index\":0,\n \"is_seed\":false,\n \"name\":\"debian-8.1.0-amd64-CD-1.iso\",\n \"piece_range\":[0,1253],\n \"priority\":1,\n \"progress\":0,\n \"size\":657457152,\n \"availability\":0.5,\n }\n]\n```",
"The response is a JSON array of hashes (strings).\n\nExample:\n\n```JSON\n[\"54eddd830a5b58480a6143d616a97e3a6c23c439\",\"f8a99d225aa4241db100f88407fc3bdaead583ab\",\"928fb615b9bd4dd8f9e9022552c8f8f37ef76f58\"]\n```",
"The response is a JSON array of objects containing the following fields\n\n\nExample:\n\n```JSON\n[\n {\n \"id\": 12345,\n \"status\": \"Running\",\n \"total\": 170\n }\n]\n```",
"Url or file path of the plugin to install (e.g. \"[https://raw.githubusercontent.com/qbittorrent/search-plugins/master/nova3/engines/legittorrents.py](https://raw.githubusercontent.com/qbittorrent/search-plugins/master/nova3/engines/legittorrents.py)\"). Supports multiple sources separated by \\",
