{ "info": { "author": "Tony Crisci", "author_email": "tony@dubstepdish.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: BSD License", "Programming Language :: Python :: 3" ], "description": "i3-dstatus\n==========\n\nThe ultimate DIY statusline generator for `i3wm `__.\n\nAbout\n-----\n\ni3-dstatus is a statusline generator for i3 that you can use to display\nsystem information you may be interested in. i3 comes with ``i3status``\nwhich has many limitations. It has no plugin interface. It has no\nsupport for events and relies on polling for all its information, which\nmakes it surprisingly heavy on resources. It has a weird config file\nformat that makes it difficult to configure.\n\nOther projects have come along to make up for these weaknesses and many\nof them do a great job. i3-dstatus is for users who want a more flexible\nstatusline that can be achieved from editing options in a configuration\nfile but without having to learn a complicated plugin api to create\ncustom statusline entries.\n\nThis is accomplished by allowing users to update the statusline through\ninterprocess communication using\n`DBUS `__. i3-dstatus\nexposes a DBUS service that you can use to update the statusline simply\nin pretty much any programming language and from any process (maybe even\nin a cron!).\n\n- No configuration file is required\n- Update the statusline from multiple processes\n- Update the statusline from any language (even from the command line!)\n- No complicated plugin api to learn\n\nInstalling\n----------\n\ni3-dstatus is on `PyPI `__.\n\n::\n\n pip install i3-dstatus\n\nUsage\n-----\n\nUse i3-dstatus as your status command in your bar block like so:\n\n::\n\n bar {\n status_command i3-dstatus clock\n }\n\nPass the path of statusline generator scripts you want to run as\narguments to i3-dstatus. Passing a relative path will start the script\nfrom the generators included with i3-dstatus from the generator path.\nUsing an absolute path or a ~/ home relative path will call the\nappropriate path. The blocks will appear on i3bar in the order the\ngenerators were given on the command line.\n\nConfiguration\n~~~~~~~~~~~~~\n\nGenerator scripts will look for ``~/.i3-dstatus.conf`` for configuration\noptions. See ``i3-dstatus.conf`` in the repo for an example. The\nconfiguration file should be a single YAML object. (More documentation\nto come).\n\nUpdating the Statusline\n-----------------------\n\nThe dbus service exposes the method ``show_block`` to update the\nstatusline. This method takes a dict of variants. Pass an object that\nconforms to the `i3bar input\nprotocol `__ to show a block.\n\nYou can clear a block by omitting the \"full\\_text\" member or setting it\nto the empty string.\n\nYou can update the statusline from a python script. Just use a script\nlike this:\n\n.. code:: python\n\n from dbus_next.aio import MessageBus\n from dbus_next import Variant\n\n bus = await MessageBus().connect()\n introspection = await bus.introspect('com.dubstepdish.i3dstatus', '/com/dubstepdish/i3dstatus')\n obj = bus.get_proxy_object('com.dubstepdish.i3dstatus', '/com/dubstepdish/i3dstatus')\n i3dstatus = obj.get_interface('com.dubstepdish.i3dstatus')\n await i3dstatus.call_show_block({\n 'name': Variant('s', 'test'),\n 'full_text': Variant('s', 'hello world')\n })\n\nYou can update the statusline from any language with dbus bindings\n(which is pretty much all of them). You can even update the statusline\nfrom the command line!\n\n::\n\n dbus-send --session \\\n --dest=com.dubstepdish.i3dstatus \\\n --type=method_call \\\n /com/dubstepdish/i3dstatus \\\n com.dubstepdish.i3dstatus.show_block \\\n dict:string:string:name,test,full_text,'hello world'\n\nContributing\n------------\n\nPlease report bugs, request feature, write documentation, and add\ngenerators to the ``i3dstatus/generators`` directory. i3-dstatus is a community\nproject so feedback is welcome!\n\nLicense\n-------\n\nThis work is available under a FreeBSD License (see LICENSE).\n\nCopyright \u00a9 2014, Tony Crisci\n\nAll rights reserved.\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/altdesktop/i3-dstatus", "keywords": "", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "i3-dstatus", "package_url": "https://pypi.org/project/i3-dstatus/", "platform": "", "project_url": "https://pypi.org/project/i3-dstatus/", "project_urls": { "Homepage": "https://github.com/altdesktop/i3-dstatus" }, "release_url": "https://pypi.org/project/i3-dstatus/0.1.1/", "requires_dist": [ "PyYAML", "netifaces", "i3ipc", "requests", "dbus-next" ], "requires_python": "", "summary": "The ultimate DIY statusline generator for i3", "version": "0.1.1" }, "last_serial": 5732462, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "f17195b40fe0222df1d451ee945b27e3", "sha256": "6ee7e39b87d2195634e2873eb88b545444edef8b435100f815e723e28ce5571d" }, "downloads": -1, "filename": "i3-dstatus-0.0.1.tar.gz", "has_sig": false, "md5_digest": "f17195b40fe0222df1d451ee945b27e3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9589, "upload_time": "2015-03-31T15:54:14", "url": "https://files.pythonhosted.org/packages/77/f8/cd15f6c83da47986d13a064937b69c3323f173b3593ef18964fbbeb1f9ea/i3-dstatus-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "67365d954f2a76ba7725d882ae812b42", "sha256": "72f696ed2ccc352a63fc67afd345dd7c408f463d09c87b393f20748636d44779" }, "downloads": -1, "filename": "i3-dstatus-0.0.2.tar.gz", "has_sig": false, "md5_digest": "67365d954f2a76ba7725d882ae812b42", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9588, "upload_time": "2015-03-31T16:27:21", "url": "https://files.pythonhosted.org/packages/25/2d/8ad4d382ea829b97ca08bbcdec8e3e4a171c1f6e3380d8e149b3985b99ac/i3-dstatus-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "5c9375bb57d7834bf29dbbceddc378a1", "sha256": "afa337c5d651afb605a57ab48d2b985e2ac943648cfde6dfcd50e2d64ed0cdb1" }, "downloads": -1, "filename": "i3-dstatus-0.0.3.tar.gz", "has_sig": false, "md5_digest": "5c9375bb57d7834bf29dbbceddc378a1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9589, "upload_time": "2015-03-31T16:43:12", "url": "https://files.pythonhosted.org/packages/f6/9d/ab5df9f85354d2bfcf6299e223920d36a4d7e516f462681635972a5ba300/i3-dstatus-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "406fc4263339d4f5e4558e482b67864e", "sha256": "d258eaea7bcb0055f4089f7a70632d10a31ccf8d3ee334b0bc2dd54f723a1aed" }, "downloads": -1, "filename": "i3-dstatus-0.0.4.tar.gz", "has_sig": false, "md5_digest": "406fc4263339d4f5e4558e482b67864e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11887, "upload_time": "2016-03-20T18:53:44", "url": "https://files.pythonhosted.org/packages/b4/13/924d3f83d89d3a33b722508ad010936218397087af87c971848dd004e0bc/i3-dstatus-0.0.4.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "d2f3b47a768f85cd447742e742a26c88", "sha256": "955c6a0363515bf7f3225af0a02b47b66e216e4f69268ddf30578b3547c36b33" }, "downloads": -1, "filename": "i3_dstatus-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "d2f3b47a768f85cd447742e742a26c88", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 18402, "upload_time": "2019-08-26T18:40:48", "url": "https://files.pythonhosted.org/packages/8a/27/d28f905c6826b98af08a322a9b4169965cf7d1c465f99b5129d3c9277a97/i3_dstatus-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "85a2ef31d79b55064964aeb8f37e583d", "sha256": "3e70312635315aa76f4ce971424b4e29545ef5545c937f143c559ff5366076b1" }, "downloads": -1, "filename": "i3-dstatus-0.1.1.tar.gz", "has_sig": false, "md5_digest": "85a2ef31d79b55064964aeb8f37e583d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12211, "upload_time": "2019-08-26T18:40:50", "url": "https://files.pythonhosted.org/packages/09/f5/7e7c71a826f9379cd762d90bbbb5c429b314bd73c808f53a7bf656b6b6e0/i3-dstatus-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "d2f3b47a768f85cd447742e742a26c88", "sha256": "955c6a0363515bf7f3225af0a02b47b66e216e4f69268ddf30578b3547c36b33" }, "downloads": -1, "filename": "i3_dstatus-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "d2f3b47a768f85cd447742e742a26c88", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 18402, "upload_time": "2019-08-26T18:40:48", "url": "https://files.pythonhosted.org/packages/8a/27/d28f905c6826b98af08a322a9b4169965cf7d1c465f99b5129d3c9277a97/i3_dstatus-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "85a2ef31d79b55064964aeb8f37e583d", "sha256": "3e70312635315aa76f4ce971424b4e29545ef5545c937f143c559ff5366076b1" }, "downloads": -1, "filename": "i3-dstatus-0.1.1.tar.gz", "has_sig": false, "md5_digest": "85a2ef31d79b55064964aeb8f37e583d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12211, "upload_time": "2019-08-26T18:40:50", "url": "https://files.pythonhosted.org/packages/09/f5/7e7c71a826f9379cd762d90bbbb5c429b314bd73c808f53a7bf656b6b6e0/i3-dstatus-0.1.1.tar.gz" } ] }