{ "info": { "author": "Olivier Schwander", "author_email": "olivier.schwander@ens-lyon.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2" ], "description": "Humble Client - Non official client for Humble Bundle\n*****************************************************\n\nDescription\n===========\n\nHumble Client is a command line client for downloading your DRM-free games\npurchased on the `Humble Bundle`_ online store. It allows listing your\norders (or bundles) and your games and downloading DRM-free ones.\n\nIt includes basic filtering capabilities to exclude platforms you do not\nwant or to download only a precise list of games.\n\n**This client is not supported in any way by Humble Bundle !**\n\n.. _Humble Bundle: https://www.humblebundle.com\n\nQuickstart\n----------\n\nSimply put your login information into the configuration file (see\nConfiguration_) and run ``humblec download`` to get all your DRM-free games.\nYou can also use ``humblec --key KEY download`` to get the games of a bundle\nwithout using an account.\n\nSee Usage_ for more details.\n\nDependencies\n============\n\nPython modules:\n\n* PyYAML,\n* requests.\n\nCommand line tool:\n\n* wget_ (which is used to effectively download files).\n\n.. _wget: https://www.gnu.org/software/wget/\n\nInstallation\n============\n\nYou can always install the latest version from PyPi using:\n\n.. code-block:: bash\n\n $ pip install humbleclient\n\nUsing an archive, this software can be installed using\n\n.. code-block:: bash\n\n $ python setup.py install\n\nUsage\n=====\n\nAdd ``--key KEY`` before a command to avoid the need for an account\n(where ``KEY`` comes from the ``key=`` of a bundle URL\nhttps://www.humblebundle.com/downloads?key=XXXXXXXXXXXX).\n\nListing orders\n--------------\n\n.. code-block:: bash\n\n $ humblec list-bundles\n\nOptions:\n\n* ``--content``: display the content of each bundle,\n* ``--files`` : display the individual files associated to each game.\n\nListing games\n-------------\n\n.. code-block:: bash\n\n $ humblec list-games\n\nOptions:\n\n* ``--files``: display the individual files associated to each game.\n\nThis command is slower than the previous one since it requires to\ndownload the complete games list before displaying it in order to\ndisplay once games which have been purchased multiple times.\n\nDownloading games\n-----------------\n\n.. code-block:: bash\n\n $ humblec download\n\nOnly the files which are not filtered out by the filters (see\nFiltering_) will be downloaded.\n\nTo precisely select what to download or to override the filters given in\nthe configuration file, the following command line flags are available:\n\n* ``--bundles BUNDLE [BUNDLE ...]``: download only the given bundles,\n* ``--games GAME [GAME ...]``: download only the given games,\n* ``--platforms PLATFORM [PLATFORM ...]``: download only files for the given platforms,\n* ``--files FILE [FILE ...]``: download only files corresponding to the\n given codenames.\n\nBe careful that other filters are still applied: for example, if you\nselect a particular file with ``--files`` but the platform of this file\nis filtered out, nothing will be downloaded, you also need to override\nthe platform with ``--platforms``.\n\nOther options:\n\n* ``--directory DIRECTORY`` or ``-d DIRECTORY``: download files to this\n directory instead of the one in the configuration file,\n\n* ``--dry-run`` or ``-n``: do not download anything, just display\n download commands.\n\nConfiguration\n=============\n\nThe configuration goes to ``~/.config/humbleclient/config.yml`` (or\n``$XDG_CONFIG_HOME/humbleclient/config.yml``).\n\nTo begin to download files, you just need to enter your login details in\nthe ``account`` section:\n\n.. code-block:: yaml\n\n account:\n email: you@example.com\n password: xxxxxxxx\n\nYou can also add key of bundles which are not claimed by your account\nusing (you can mix account and keys, all bundles will be processed):\n\n.. code-block:: yaml\n\n keys:\n - XXXXXXXXXXXX\n - YYYYYYYYYYYY\n\nFiles will go the directory ``~/Humble`` or any directory of your\nchoice:\n\n.. code-block:: yaml\n\n directory: ~/Humble\n\nAdvanced users may customize the format used to display list of games\nand orders and to generate the destination directories of download files\n(see Formatting_).\n\nSome filters allow to select more precisely the files which will be\ndownloaded (see Filtering_).\n\nExample\n-------\n\nThe default values are the following:\n\n.. code-block:: yaml\n\n account:\n email:\n password:\n \n keys: []\n \n directory: ~/Humble\n \n exclude:\n bundles: []\n # bundles:\n # - hib8 # I do not like games from the Humble Indie Bundle 8\n platforms: []\n # platforms:\n # - mac # I do not have a mac\n games: []\n files: []\n \n format:\n download: \"{game_name}/{filename}\"\n file: \"- {title} ({platform}, {human_size}, {name}, {filename})\"\n game: \"- {title} ({name}, {url})\"\n order: \"* {title} ({name}, {url})\"\n\nFiltering\n---------\n\nThere are 4 filters available:\n\n* ``bundles``\n* ``platforms``\n* ``games``\n* ``files``\n\nEach filter expects a list of code names which can be found using\n``list-orders`` or ``list-games``.\n\nFormatting\n----------\n\nOutput format can be customized using the ``format`` section of the\nconfiguration file. There are 4 different format string, which accept\ndifferent variables:\n\n* ``order``\n\n * ``key``: Key of the bundle\n * ``title``: Title of the bundle\n * ``name``: Code name of the bundle\n * ``url``: URL of the bundle\n\n* ``game``\n\n * ``name``: Code name of the game\n * ``title``: Human name of the game\n * ``icon``: URL of an icon\n * ``url``: URL of the game\n * ``editor``: Editor of the game\n\n* ``file`` and ``download``\n\n * ``game_name``: Code name of the game\n * ``game_title``: Human name of the game\n * ``game_editor``: Human name of the editor\n * ``platform``: Platform\n * ``name``: Code name of the file\n * ``title``: Human name of the download (often not really interesting,\n like \"Download\")\n * ``size``: Size of the file\n * ``human_size``: Human size of the file\n * ``sha1``: SHA1 hash of the file (if available)\n * ``md5``: MD5 hash of the file (if available)\n * ``url``: Download url\n * ``torrent``: Torrent url (if available)\n * ``filename``: Filename\n\nDownload\n========\n\n* Version 0.1.3: http://chadok.info/humbleclient/humbleclient-0.1.3.tar.gz\n* Darcs repository: http://hub.darcs.net/oschwand/humbleclient/\n\nBugs and comments\n=================\n\nPlease submit bug reports on the `issues tracker`_.\n\n.. _issues tracker: http://hub.darcs.net/oschwand/humbleclient/issues\n\nLicence\n=======\n\nHumble is free software, released under the term of the GPLv3+.\n\nCopyright 2014-2015 Olivier Schwander ", "description_content_type": null, "docs_url": null, "download_url": "http://chadok.info/humbleclient/humbleclient-0.1.3.tar.gz", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://chadok.info/humbleclient", "keywords": null, "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "humbleclient", "package_url": "https://pypi.org/project/humbleclient/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/humbleclient/", "project_urls": { "Download": "http://chadok.info/humbleclient/humbleclient-0.1.3.tar.gz", "Homepage": "http://chadok.info/humbleclient" }, "release_url": "https://pypi.org/project/humbleclient/0.1.3/", "requires_dist": null, "requires_python": null, "summary": "Non official client for Humble Bundle", "version": "0.1.3" }, "last_serial": 1688805, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "288a625c135aa31eb878f20e26d855d7", "sha256": "f3a9a5578b056011146aa80dbab43717ec6d8fe7c992d3d1f8ae2d7fbd9461f2" }, "downloads": -1, "filename": "humbleclient-0.1.1.tar.gz", "has_sig": false, "md5_digest": "288a625c135aa31eb878f20e26d855d7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4550, "upload_time": "2015-08-22T15:32:46", "url": "https://files.pythonhosted.org/packages/08/3b/23ab79714e2ed58b20f640a6baf477745fc6c466c8e804aee6c24b5ed839/humbleclient-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "2c38e5a1b6635953101c292aa99a927a", "sha256": "a857db677bdc9da0731e2b6d740c9a14eacbbd6623b3d7c020564728cde0a3cb" }, "downloads": -1, "filename": "humbleclient-0.1.2.tar.gz", "has_sig": false, "md5_digest": "2c38e5a1b6635953101c292aa99a927a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5502, "upload_time": "2015-08-22T15:38:25", "url": "https://files.pythonhosted.org/packages/ee/57/b8fa80b75b4207ff454c67bc396e6319c3fddca8912256affc318baf3058/humbleclient-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "1e25a5cf3d495a2112c29164ddad00f0", "sha256": "882c2bf98c36fef0a4e542284b22804b9386e451a206591d468f40d54ba2e3f2" }, "downloads": -1, "filename": "humbleclient-0.1.3.tar.gz", "has_sig": false, "md5_digest": "1e25a5cf3d495a2112c29164ddad00f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7389, "upload_time": "2015-08-22T15:42:09", "url": "https://files.pythonhosted.org/packages/ab/ce/9d19f007c84561f47d254af907ead6698beb34c673693d6f0d8d9df2b262/humbleclient-0.1.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1e25a5cf3d495a2112c29164ddad00f0", "sha256": "882c2bf98c36fef0a4e542284b22804b9386e451a206591d468f40d54ba2e3f2" }, "downloads": -1, "filename": "humbleclient-0.1.3.tar.gz", "has_sig": false, "md5_digest": "1e25a5cf3d495a2112c29164ddad00f0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7389, "upload_time": "2015-08-22T15:42:09", "url": "https://files.pythonhosted.org/packages/ab/ce/9d19f007c84561f47d254af907ead6698beb34c673693d6f0d8d9df2b262/humbleclient-0.1.3.tar.gz" } ] }