Torrents¶
-
class
qbittorrentapi.torrents.
TorrentsAPIMixIn
(host='', port=None, username=None, password=None, **kwargs)¶ Bases:
qbittorrentapi.request.Request
Implementation of all Torrents API methods.
Usage: >>> from qbittorrentapi import Client >>> client = Client(host='localhost:8080', username='admin', password='adminadmin') >>> client.torrents_add(urls='...') >>> client.torrents_reannounce()
-
torrents_add
(urls=None, torrent_files=None, save_path=None, cookie=None, category=None, is_skip_checking=None, is_paused=None, is_root_folder=None, rename=None, upload_limit=None, download_limit=None, use_auto_torrent_management=None, is_sequential_download=None, is_first_last_piece_priority=None, tags=None, content_layout=None, ratio_limit=None, seeding_time_limit=None, download_path=None, use_download_path=None, **kwargs)¶ Add one or more torrents by URLs and/or torrent files.
Raises: - UnsupportedMediaType415Error – if file is not a valid torrent file
- TorrentFileNotFoundError – if a torrent file doesn’t exist
- TorrentFilePermissionError – if read permission is denied to torrent file
Parameters: - urls – single instance or an iterable of URLs (http://, https://, magnet: and bc://bt/)
- torrent_files – several options are available to send torrent files to qBittorrent: 1) single instance of bytes: useful if torrent file already read from disk or downloaded from internet. 2) single instance of file handle to torrent file: use open(<filepath>, ‘rb’) to open the torrent file. 3) single instance of a filepath to torrent file: e.g. ‘/home/user/torrent_filename.torrent’ 4) an iterable of the single instances above to send more than one torrent file 5) dictionary with key/value pairs of torrent name and single instance of above object Note: The torrent name in a dictionary is useful to identify which torrent file errored. qBittorrent provides back that name in the error text. If a torrent name is not provided, then the name of the file will be used. And in the case of bytes (or if filename cannot be determined), the value ‘torrent__n’ will be used
- save_path – location to save the torrent data
- cookie – cookie to retrieve torrents by URL
- category – category to assign to torrent(s)
- is_skip_checking – skip hash checking
- is_paused – True to start torrent(s) paused
- is_root_folder – True or False to create root folder (superseded by content_layout with v4.3.2)
- rename – new name for torrent(s)
- upload_limit – upload limit in bytes/second
- download_limit – download limit in bytes/second
- use_auto_torrent_management – True or False to use automatic torrent management
- is_sequential_download – True or False for sequential download
- is_first_last_piece_priority – True or False for first and last piece download priority
- tags – tag(s) to assign to torrent(s) (added in Web API v2.6.2)
- content_layout – Original, Subfolder, or NoSubfolder to control filesystem structure for content (added in Web API v2.7)
- ratio_limit – share limit as ratio of upload amt over download amt; e.g. 0.5 or 2.0 (added in Web API v2.8.1)
- seeding_time_limit – number of minutes to seed torrent (added in Web API v2.8.1)
- download_path – location to download torrent content before moving to save_path (added in Web API v2.8.4)
- use_download_path – whether the download_path should be used…defaults to True if download_path is specified (added in Web API v2.8.4)
Returns: “Ok.” for success and “Fails.” for failure
-
torrents_add_peers
(peers=None, torrent_hashes=None, **kwargs)¶ Add one or more peers to one or more torrents. (alias: torrents_addPeers)
Raises: InvalidRequest400Error – for invalid peers
Parameters: - peers – one or more peers to add. each peer should take the form ‘host:port’
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
Returns: TorrentsAddPeersDictionary
- {<hash>: {‘added’: #, ‘failed’: #}}
Add one or more tags to one or more torrents. (alias: torrents_addTags) Note: Tags that do not exist will be created on-the-fly.
Parameters: - tags – tag name or list of tags
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
Returns: None
-
torrents_add_trackers
(torrent_hash=None, urls=None, **kwargs)¶ Add trackers to a torrent. (alias: torrents_addTrackers)
Raises: Parameters: - torrent_hash – hash for torrent
- urls – tracker urls to add to torrent
Returns: None
-
torrents_bottom_priority
(torrent_hashes=None, **kwargs)¶ Set torrent as highest priority. Torrent Queuing must be enabled. (alias: torrents_bottomPrio)
Raises: Conflict409Error – Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_categories
(**kwargs)¶ Retrieve all category definitions
Note: torrents/categories is not available until v2.1.0 :return:
TorrentCategoriesDictionary
-
torrents_create_category
(name=None, save_path=None, download_path=None, enable_download_path=None, **kwargs)¶ Create a new torrent category. (alias: torrents_createCategory)
Note: save_path is not available until web API version 2.1.0
Raises: Conflict409Error – if category name is not valid or unable to create
Parameters: - name – name for new category
- save_path – location to save torrents for this category
- download_path – download location for torrents with this category
- enable_download_path – True or False to enable or disable download path
Returns: None
Create one or more tags. (alias: torrents_createTags)
Parameters: tags – tag name or list of tags Returns: None
-
torrents_decrease_priority
(torrent_hashes=None, **kwargs)¶ Decrease the priority of a torrent. Torrent Queuing must be enabled. (alias: torrents_decreasePrio)
Raises: Conflict409Error – Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_delete
(delete_files=False, torrent_hashes=None, **kwargs)¶ Remove a torrent from qBittorrent and optionally delete its files.
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- delete_files – True to delete the torrent’s files
Returns: None
Delete one or more tags. (alias: torrents_deleteTags)
Parameters: tags – tag name or list of tags Returns: None
-
torrents_download_limit
(torrent_hashes=None, **kwargs)¶ Retrieve the download limit for one or more torrents. (alias: torrents_downloadLimit)
Returns: TorrentLimitsDictionary
- {hash: limit} (-1 represents no limit)
-
torrents_edit_category
(name=None, save_path=None, download_path=None, enable_download_path=None, **kwargs)¶ Edit an existing category. (alias: torrents_editCategory)
Note: torrents/editCategory not available until web API version 2.1.0
Raises: Conflict409Error – if category name is not valid or unable to create
Parameters: - name – category to edit
- save_path – new location to save files for this category
- download_path – download location for torrents with this category
- enable_download_path – True or False to enable or disable download path
Returns: None
-
torrents_edit_tracker
(torrent_hash=None, original_url=None, new_url=None, **kwargs)¶ Replace a torrent’s tracker with a different one. (alias: torrents_editTrackers)
Raises: - InvalidRequest400 –
- NotFound404Error –
- Conflict409Error –
Parameters: - torrent_hash – hash for torrent
- original_url – URL for existing tracker
- new_url – new URL to replace
Returns: None
-
torrents_file_priority
(torrent_hash=None, file_ids=None, priority=None, **kwargs)¶ Set priority for one or more files. (alias: torrents_filePrio)
Raises: - InvalidRequest400 – if priority is invalid or at least one file ID is not an integer
- NotFound404Error –
- Conflict409Error – if torrent metadata has not finished downloading or at least one file was not found
Parameters: - torrent_hash – hash for torrent
- file_ids – single file ID or a list.
- priority – priority for file(s) - https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)#set-file-priority
Returns: None
-
torrents_files
(torrent_hash=None, **kwargs)¶ Retrieve individual torrent’s files.
Raises: NotFound404Error – Parameters: torrent_hash – hash for torrent Returns: TorrentFilesList
- https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)#get-torrent-contents
-
torrents_increase_priority
(torrent_hashes=None, **kwargs)¶ Increase the priority of a torrent. Torrent Queuing must be enabled. (alias: torrents_increasePrio)
Raises: Conflict409Error – Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_info
(status_filter=None, category=None, sort=None, reverse=None, limit=None, offset=None, torrent_hashes=None, tag=None, **kwargs)¶ Retrieves list of info for torrents. Note: hashes is available starting web API version 2.0.1
Parameters: - status_filter – Filter list by all, downloading, completed, paused, active, inactive, resumed stalled, stalled_uploading and stalled_downloading added in Web API v2.4.1
- category – Filter list by category
- sort – Sort list by any property returned
- reverse – Reverse sorting
- limit – Limit length of list
- offset – Start of list (if < 0, offset from end of list)
- torrent_hashes – Filter list by hash (separate multiple hashes with a ‘|’)
- tag – Filter list by tag (empty string means “untagged”; no “tag” param means “any tag”; added in Web API v2.8.3)
Returns: TorrentInfoList
- https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)#get-torrent-list
-
torrents_pause
(torrent_hashes=None, **kwargs)¶ Pause one or more torrents in qBittorrent.
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_piece_hashes
(torrent_hash=None, **kwargs)¶ Retrieve individual torrent’s pieces’ hashes. (alias: torrents_pieceHashes)
Raises: NotFound404Error – Parameters: torrent_hash – hash for torrent Returns: TorrentPieceInfoList
-
torrents_piece_states
(torrent_hash=None, **kwargs)¶ Retrieve individual torrent’s pieces’ states. (alias: torrents_pieceStates)
Raises: NotFound404Error – Parameters: torrent_hash – hash for torrent Returns: TorrentPieceInfoList
-
torrents_properties
(torrent_hash=None, **kwargs)¶ Retrieve individual torrent’s properties.
Raises: NotFound404Error – Parameters: torrent_hash – hash for torrent Returns: TorrentPropertiesDictionary
- https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)#get-torrent-generic-properties
-
torrents_reannounce
(torrent_hashes=None, **kwargs)¶ Reannounce a torrent.
Note: torrents/reannounce not available web API version 2.0.2
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_recheck
(torrent_hashes=None, **kwargs)¶ Recheck a torrent in qBittorrent.
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_remove_categories
(categories=None, **kwargs)¶ Delete one or more categories. (alias: torrents_removeCategories)
Parameters: categories – categories to delete Returns: None
Add one or more tags to one or more torrents. (alias: torrents_removeTags)
Parameters: - tags – tag name or list of tags
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
Returns: None
-
torrents_remove_trackers
(torrent_hash=None, urls=None, **kwargs)¶ Remove trackers from a torrent. (alias: torrents_removeTrackers)
Raises: Parameters: - torrent_hash – hash for torrent
- urls – tracker urls to removed from torrent
Returns: None
-
torrents_rename
(torrent_hash=None, new_torrent_name=None, **kwargs)¶ Rename a torrent.
Raises: Parameters: - torrent_hash – hash for torrent
- new_torrent_name – new name for torrent
Returns: None
-
torrents_rename_file
(torrent_hash=None, file_id=None, new_file_name=None, old_path=None, new_path=None, **kwargs)¶ Rename a torrent file.
Raises: Parameters: - torrent_hash – hash for torrent
- file_id – id for file (removed in Web API v2.7)
- new_file_name – new name for file (removed in Web API v2.7)
- old_path – path of file to rename (added in Web API v2.7)
- new_path – new path of file to rename (added in Web API v2.7)
Returns: None
-
torrents_rename_folder
(torrent_hash=None, old_path=None, new_path=None, **kwargs)¶ Rename a torrent folder.
Raises: Parameters: - torrent_hash – hash for torrent
- old_path – path of file to rename (added in Web API v2.7)
- new_path – new path of file to rename (added in Web API v2.7)
Returns: None
-
torrents_resume
(torrent_hashes=None, **kwargs)¶ Resume one or more torrents in qBittorrent.
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_setDownloadPath
(download_path=None, torrent_hashes=None, **kwargs)¶ Set the Download Path for one or more torrents. (alias: torrents_setDownloadPath)
Raises: - Forbidden403Error – cannot write to directory
- Conflict409Error – directory cannot be created
Parameters: - download_path – file path to save torrent contents before torrent finishes downloading
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
-
torrents_setSavePath
(save_path=None, torrent_hashes=None, **kwargs)¶ Set the Save Path for one or more torrents. (alias: torrents_setSavePath)
Raises: - Forbidden403Error – cannot write to directory
- Conflict409Error – directory cannot be created
Parameters: - save_path – file path to save torrent contents
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
-
torrents_set_auto_management
(enable=None, torrent_hashes=None, **kwargs)¶ Enable or disable automatic torrent management for one or more torrents. (alias: torrents_setAutoManagement)
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- enable – True or False
Returns: None
-
torrents_set_category
(category=None, torrent_hashes=None, **kwargs)¶ Set a category for one or more torrents. (alias: torrents_setCategory)
Raises: Conflict409Error – for bad category
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- category – category to assign to torrent
Returns: None
-
torrents_set_download_limit
(limit=None, torrent_hashes=None, **kwargs)¶ Set the download limit for one or more torrents. (alias: torrents_setDownloadLimit)
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- limit – bytes/second (-1 sets the limit to infinity)
Returns: None
-
torrents_set_download_path
(download_path=None, torrent_hashes=None, **kwargs)¶ Set the Download Path for one or more torrents. (alias: torrents_setDownloadPath)
Raises: - Forbidden403Error – cannot write to directory
- Conflict409Error – directory cannot be created
Parameters: - download_path – file path to save torrent contents before torrent finishes downloading
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
-
torrents_set_force_start
(enable=None, torrent_hashes=None, **kwargs)¶ Force start one or more torrents. (alias: torrents_setForceStart)
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- enable – True or False (False makes this equivalent to torrents_resume())
Returns: None
-
torrents_set_location
(location=None, torrent_hashes=None, **kwargs)¶ Set location for torrents’s files. (alias: torrents_setLocation)
Raises: - Forbidden403Error – if the user doesn’t have permissions to write to the location
- Conflict409Error – if the directory cannot be created at the location
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- location – disk location to move torrent’s files
Returns: None
-
torrents_set_save_path
(save_path=None, torrent_hashes=None, **kwargs)¶ Set the Save Path for one or more torrents. (alias: torrents_setSavePath)
Raises: - Forbidden403Error – cannot write to directory
- Conflict409Error – directory cannot be created
Parameters: - save_path – file path to save torrent contents
- torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
Set share limits for one or more torrents.
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- ratio_limit – max ratio to seed a torrent. (-2 means use the global value and -1 is no limit)
- seeding_time_limit – minutes (-2 means use the global value and -1 is no limit)
Returns: None
-
torrents_set_super_seeding
(enable=None, torrent_hashes=None, **kwargs)¶ Set one or more torrents as super seeding. (alias: torrents_setSuperSeeding)
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- enable – True or False
Returns:
-
torrents_set_upload_limit
(limit=None, torrent_hashes=None, **kwargs)¶ Set the upload limit for one or more torrents. (alias: torrents_setUploadLimit)
Parameters: - torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents.
- limit – bytes/second (-1 sets the limit to infinity)
Returns: None
Retrieve all tag definitions.
Returns: TagList
-
torrents_toggle_first_last_piece_priority
(torrent_hashes=None, **kwargs)¶ Toggle priority of first/last piece downloading. (alias: torrents_toggleFirstLastPiecePrio)
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_toggle_sequential_download
(torrent_hashes=None, **kwargs)¶ Toggle sequential download for one or more torrents. (alias: torrents_toggleSequentialDownload)
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_top_priority
(torrent_hashes=None, **kwargs)¶ Set torrent as highest priority. Torrent Queuing must be enabled. (alias: torrents_topPrio)
Raises: Conflict409Error – Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: None
-
torrents_trackers
(torrent_hash=None, **kwargs)¶ Retrieve individual torrent’s trackers.
Raises: NotFound404Error – Parameters: torrent_hash – hash for torrent Returns: TrackersList
- https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)#get-torrent-trackers
-
torrents_upload_limit
(torrent_hashes=None, **kwargs)¶ Retrieve the upload limit for one or more torrents. (alias: torrents_uploadLimit)
Parameters: torrent_hashes – single torrent hash or list of torrent hashes. Or ‘all’ for all torrents. Returns: TorrentLimitsDictionary
-
torrents_webseeds
(torrent_hash=None, **kwargs)¶ Retrieve individual torrent’s web seeds.
Raises: NotFound404Error – Parameters: torrent_hash – hash for torrent Returns: WebSeedsList
- https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1)#get-torrent-web-seeds
-
-
class
qbittorrentapi.torrents.
Torrents
(client)¶ Allows interaction with the “Torrents” API endpoints.
Usage: >>> from qbittorrentapi import Client >>> client = Client(host='localhost:8080', username='admin', password='adminadmin') >>> # this are all the same attributes that are available as named in the >>> # endpoints or the more pythonic names in Client (with or without 'torrents_' prepended) >>> torrent_list = client.torrents.info() >>> torrent_list_active = client.torrents.info.active() >>> torrent_list_active_partial = client.torrents.info.active(limit=100, offset=200) >>> torrent_list_downloading = client.torrents.info.downloading() >>> # torrent looping >>> for torrent in client.torrents.info.completed() >>> # all torrents endpoints with a 'hashes' parameters support all method to apply action to all torrents >>> client.torrents.pause.all() >>> client.torrents.resume.all() >>> # or specify the individual hashes >>> client.torrents.downloadLimit(torrent_hashes=['...', '...'])
-
add
(urls=None, torrent_files=None, save_path=None, cookie=None, category=None, is_skip_checking=None, is_paused=None, is_root_folder=None, rename=None, upload_limit=None, download_limit=None, use_auto_torrent_management=None, is_sequential_download=None, is_first_last_piece_priority=None, tags=None, content_layout=None, ratio_limit=None, seeding_time_limit=None, download_path=None, use_download_path=None, **kwargs)¶
-
-
class
qbittorrentapi.torrents.
TorrentDictionary
(data, client)¶ Bases:
qbittorrentapi.definitions.Dictionary
Item in
TorrentInfoList
. Alows interaction with individual torrents via the “Torrents” API endpoints.Usage: >>> from qbittorrentapi import Client >>> client = Client(host='localhost:8080', username='admin', password='adminadmin') >>> # these are all the same attributes that are available as named in the >>> # endpoints or the more pythonic names in Client (with or without 'transfer_' prepended) >>> torrent = client.torrents.info()[0] >>> torrent_hash = torrent.info.hash >>> # Attributes without inputs and a return value are properties >>> properties = torrent.properties >>> trackers = torrent.trackers >>> files = torrent.files >>> # Action methods >>> torrent.edit_tracker(original_url="...", new_url="...") >>> torrent.remove_trackers(urls='http://127.0.0.2/') >>> torrent.rename(new_torrent_name="...") >>> torrent.resume() >>> torrent.pause() >>> torrent.recheck() >>> torrent.torrents_top_priority() >>> torrent.setLocation(location='/home/user/torrents/') >>> torrent.setCategory(category='video')
Implements
torrents_add_tags()
-
add_trackers
(urls=None, **kwargs)¶ Implements
torrents_add_trackers()
-
bottom_priority
(**kwargs)¶ Implements
torrents_bottom_priority()
-
decrease_priority
(**kwargs)¶ Implements
torrents_decrease_priority()
-
delete
(delete_files=None, **kwargs)¶ Implements
torrents_delete()
-
download_limit
¶ Implements
set_download_limit()
-
edit_tracker
(orig_url=None, new_url=None, **kwargs)¶ Implements
torrents_edit_tracker()
-
file_priority
(file_ids=None, priority=None, **kwargs)¶ Implements
torrents_file_priority()
-
files
¶ Implements
torrents_files()
-
increase_priority
(**kwargs)¶ Implements
torrents_increase_priority()
-
info
¶ Implements
torrents_info()
-
pause
(**kwargs)¶ Implements
torrents_pause()
-
piece_hashes
¶ Implements
torrents_piece_hashes()
-
piece_states
¶ Implements
torrents_piece_states()
-
properties
¶ Implements
torrents_properties()
-
reannounce
(**kwargs)¶ Implements
torrents_reannounce()
-
recheck
(**kwargs)¶ Implements
torrents_recheck()
Implements
torrents_remove_tags()
-
remove_trackers
(urls=None, **kwargs)¶ Implements
torrents_remove_trackers()
-
rename
(new_name=None, **kwargs)¶ Implements
torrents_rename()
-
rename_file
(file_id=None, new_file_name=None, old_path=None, new_path=None, **kwargs)¶ Implements
torrents_rename_file()
-
rename_folder
(old_path=None, new_path=None, **kwargs)¶ Implements
torrents_rename_folder()
-
resume
(**kwargs)¶ Implements
torrents_resume()
-
setDownloadPath
(download_path=None, **kwargs)¶ Implements
torrents_set_download_path()
-
setSavePath
(save_path=None, **kwargs)¶ Implements
torrents_set_save_path()
-
set_auto_management
(enable=None, **kwargs)¶ Implements
torrents_set_auto_management()
-
set_category
(category=None, **kwargs)¶ Implements
torrents_set_category()
-
set_download_limit
(limit=None, **kwargs)¶ Implements
torrents_set_download_limit()
-
set_download_path
(download_path=None, **kwargs)¶ Implements
torrents_set_download_path()
-
set_force_start
(enable=None, **kwargs)¶ Implements
torrents_set_force_start()
-
set_location
(location=None, **kwargs)¶ Implements
torrents_set_location()
-
set_save_path
(save_path=None, **kwargs)¶ Implements
torrents_set_save_path()
Implements
torrents_set_share_limits()
-
set_super_seeding
(enable=None, **kwargs)¶ Implements
torrents_set_super_seeding()
-
set_upload_limit
(limit=None, **kwargs)¶ Implements
torrents_set_upload_limit()
-
state_enum
¶ Returns the formalized Enumeration for Torrent State instead of the raw string.
-
sync_local
()¶ Update local cache of torrent info.
-
toggle_first_last_piece_priority
(**kwargs)¶ Implements
torrents_toggle_first_last_piece_priority()
-
toggle_sequential_download
(**kwargs)¶ Implements
torrents_toggle_sequential_download()
-
top_priority
(**kwargs)¶ Implements
torrents_top_priority()
-
trackers
¶ Implements
torrents_trackers()
-
upload_limit
¶ Implements
torrents_upload_limit()
-
webseeds
¶ Implements
torrents_webseeds()
-
class
qbittorrentapi.torrents.
TorrentCategories
(*args, **kwargs)¶ Bases:
qbittorrentapi.definitions.ClientCache
Alows interaction with torrent categories within the “Torrents” API endpoints.
Usage: >>> from qbittorrentapi import Client >>> client = Client(host='localhost:8080', username='admin', password='adminadmin') >>> # these are all the same attributes that are available as named in the >>> # endpoints or the more pythonic names in Client (with or without 'torrents_' prepended) >>> categories = client.torrent_categories.categories >>> # create or edit categories >>> client.torrent_categories.create_category(name='Video', save_path='/home/user/torrents/Video') >>> client.torrent_categories.edit_category(name='Video', save_path='/data/torrents/Video') >>> # edit or create new by assignment >>> client.torrent_categories.categories = dict(name='Video', save_path='/hone/user/') >>> # delete categories >>> client.torrent_categories.removeCategories(categories='Video') >>> client.torrent_categories.removeCategories(categories=['Audio', "ISOs"])
-
categories
¶ Implements
torrents_categories()
-
create_category
(name=None, save_path=None, download_path=None, enable_download_path=None, **kwargs)¶ Implements
torrents_create_category()
-
edit_category
(name=None, save_path=None, download_path=None, enable_download_path=None, **kwargs)¶ Implements
torrents_edit_category()
-
remove_categories
(categories=None, **kwargs)¶ Implements
torrents_remove_categories()
-
-
class
qbittorrentapi.torrents.
TorrentTags
(*args, **kwargs)¶ Bases:
qbittorrentapi.definitions.ClientCache
Allows interaction with torrent tags within the “Torrent” API endpoints.
- Usage:
>>> from qbittorrentapi import Client >>> client = Client(host='localhost:8080', username='admin', password='adminadmin') >>> tags = client.torrent_tags.tags >>> client.torrent_tags.tags = 'tv show' # create category >>> client.torrent_tags.create_tags(tags=['tv show', 'linux distro']) >>> client.torrent_tags.delete_tags(tags='tv show')
Implements
torrents_add_tags()
Implements
torrents_create_tags()
Implements
torrents_delete_tags()
Implements
torrents_remove_tags()
Implements
torrents_tags()
-
class
qbittorrentapi.torrents.
TorrentPropertiesDictionary
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.Dictionary
Response to
torrents_properties()
-
class
qbittorrentapi.torrents.
TorrentLimitsDictionary
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.Dictionary
Response to
torrents_download_limit()
-
class
qbittorrentapi.torrents.
TorrentCategoriesDictionary
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.Dictionary
Response to
torrents_categories()
-
class
qbittorrentapi.torrents.
TorrentsAddPeersDictionary
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.Dictionary
Response to
torrents_add_peers()
-
class
qbittorrentapi.torrents.
TorrentFilesList
(list_entries=None, client=None)¶ Bases:
qbittorrentapi.definitions.List
Response to
torrents_files()
-
class
qbittorrentapi.torrents.
TorrentFile
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.ListEntry
Item in
TorrentFilesList
-
class
qbittorrentapi.torrents.
WebSeedsList
(list_entries=None, client=None)¶ Bases:
qbittorrentapi.definitions.List
Response to
torrents_webseeds()
-
class
qbittorrentapi.torrents.
WebSeed
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.ListEntry
Item in
WebSeedsList
-
class
qbittorrentapi.torrents.
TrackersList
(list_entries=None, client=None)¶ Bases:
qbittorrentapi.definitions.List
Response to
torrents_trackers()
-
class
qbittorrentapi.torrents.
Tracker
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.ListEntry
Item in
TrackersList
-
class
qbittorrentapi.torrents.
TorrentInfoList
(list_entries=None, client=None)¶ Bases:
qbittorrentapi.definitions.List
Response to
torrents_info()
-
class
qbittorrentapi.torrents.
TorrentPieceInfoList
(list_entries=None, client=None)¶ Bases:
qbittorrentapi.definitions.List
Response to
torrents_piece_states()
andtorrents_piece_hashes()
-
class
qbittorrentapi.torrents.
TorrentPieceData
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.ListEntry
Item in
TorrentPieceInfoList
-
class
qbittorrentapi.torrents.
TagList
(list_entries=None, client=None)¶ Bases:
qbittorrentapi.definitions.List
Response to
torrents_tags()
-
class
qbittorrentapi.torrents.
Tag
(data=None, client=None)¶ Bases:
qbittorrentapi.definitions.ListEntry
Item in
TagList