{ "info": { "author": "Mario Gomez", "author_email": "mxgxw.alpha@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2.7", "Topic :: Utilities" ], "description": "======================================================================\r\nRPiTwit - The (very simple) Raspberry PI Remote Controller for Tweeter\r\n======================================================================\r\n\r\nRPiTwit is a really simple script to execute remote shell commands on\r\nyour RaspberryPI (or any other Linux distribution with python) using\r\nyour twitter account.\r\n\r\nTo execute commands just write a status on your twitter with the\r\nfollowing format::\r\n\r\n #RPITwit [arguments]\r\n\r\nThe scripts are stored on **\"~/rpitwit_commands/\"**. You can call python\r\nscripts, shell scripts or executables. In the case of python scripts do\r\nnot include the **\".py\"** extension when calling the command on twitter.\r\n\r\nInstalling RPiTwit\r\n==================\r\n\r\nIf you have setuptools installed just run (as root)::\r\n\r\n sudo easy_install rpitwit\r\n\r\nIf not, download the tar.gz package, extract it and run::\r\n\r\n sudo python setup.py install\r\n\r\nRunning on Raspberry PI (Or any other Linux distribution)\r\n=========================================================\r\n\r\n**IMPORTANT: Never run rpitwit as root.**\r\n\r\nExecute the following command::\r\n\r\n rpitwit\r\n\r\nAnd follow the instructions.\r\n\r\nTo stop press **Ctrl+C**\r\n\r\n\r\nGetting Help\r\n============\r\n\r\nIf you feel nervous or don't want to come here again to read the\r\ninstructions, you can ask for help with the following command::\r\n\r\n rpitwit --help\r\n\r\nThis is going to show you a really small help text with the\r\ncommand line options that you can use on RPiTwit.\r\n\r\nChanging the list of authorized users:\r\n======================================\r\n\r\nJust start rpitwit with the '--ask-follow' parameter::\r\n\r\n rpitwit --ask-follow\r\n\r\nConfiguration\r\n=============\r\nThe first time that you run rpitwit it's going to ask your\r\nauthorization on twitter, just follow the instructions.\r\n\r\n**Important note**: RPiTwit NEVER is going to ask you for\r\nyour password or email, all the authentication is done on\r\nTwitter and they are going to generate for you a \"PIN\" that\r\nyou need to enter when it's asked.\r\n\r\nAfter you authorize the apllication on twitter, the script\r\nis going to ask you for the twitter usernames who are going\r\nto be able to execute scripts. For security don't allow access\r\nto unknown people.\r\n\r\nThe configuration options are stored in **~/.rpitwit_config**\r\n\r\nYou can modify the following options:\r\n\r\n **magicword**: keyword used to run commands, this must be\r\n the first word on your tweet.\r\n\r\n **follow**: list of twitter user IDs that who are going\r\n to be able to execute commands.\r\n\r\n **AppName**: Name of the application on Twitter. Do not\r\n modify unless you are using your own keys.\r\n\r\n **oauth_token**: generated automatically. Do not modify.\r\n\r\n **oauth_secret**: generated automatically. Do not modify.\r\n\r\nIf you are using your own application keys you MUST add\r\nthis three lines to your **~./rpitwit_config** file::\r\n\r\n AppName=\r\n CONSUMER_KEY=\r\n CONSUMER_SECRET=\r\n\r\nNow you need to start rpiwit with the \"--reload-tokens\" argument\r\nto update the authorization tokens::\r\n\r\n rpitwit --reload-tokens\r\n\r\nFor more info about generating your application keys look\r\nunder the documentation directory.\r\n\r\nWarning!\r\n========\r\n\r\nThis is very simple tool that just executes shell and python\r\nscripts contained within the script directory.\r\n\r\nIt doesn't limit what the commands could do to your system.\r\nDo not run rpitwit as root, and try to not give root access\r\nto the scripts with \"sudo\" or \"su -c\" unless completely necessary.\r\n\r\nBe really careful, don't put dangerous commands or scripts\r\nfrom untrusted sources inside the command directory.\r\n\r\nChangelog\r\n=========\r\n\r\n**From 0.1.0 to 0.2.0:**\r\n\r\n* The script now captures SIGINT and SIGTERM and closes\r\n without giving errors when you press CTRL-C or using the kill command.\r\n* Added the \"--about\" argument to show copyright info.\r\n* Added the \"--help\" with a really small help text.\r\n* Added the \"--load-defaults\" argument to load the default config.\r\n If you screw up the configuration try with this argument.\r\n* Added the \"--reload-tokens\" argument to update the oAuth tokens\r\n in case of using custom application keys.\r\n* Added the \"--ask-follow' argument to change the list\r\n of users that rpitwit follows after the first run.\r\n* A lot of code cleanup. Comments added. Now it's more\r\n easy to read and understand.\r\n\r\n**0.1.0**\r\n\r\n* Initial release.\r\n\r\nCredits and more Info\r\n=====================\r\n\r\nThis software uses the TwitterStream API from\r\nPython Twitter Tools by Mike Verdone (mike.verdone.ca)\r\n(http://pypi.python.org/pypi/twitter)\r\n\r\nRPiTwit maintainer:\r\n Mario Gomez \r\n (http://fuenteabierta.teubi.co/)\r\n\r\nA more detailed explanation of usage and examples:\r\n\r\n http://fuenteabierta.teubi.co/2013/01/controlling-raspberry-pi-via-twitter.html", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://pypi.python.org/pypi/RPiTwit/", "keywords": "twitter, raspberrypi, remote control", "license": "LICENSE.txt", "maintainer": "", "maintainer_email": "", "name": "rpitwit", "package_url": "https://pypi.org/project/rpitwit/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/rpitwit/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://pypi.python.org/pypi/RPiTwit/" }, "release_url": "https://pypi.org/project/rpitwit/0.2.0/", "requires_dist": null, "requires_python": null, "summary": "Remote control your RaspberryPI from Twitter.", "version": "0.2.0" }, "last_serial": 799064, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "aa1c2d79eba9e0f3caf642aa454ac362", "sha256": "be16c44d8c4fcc2e0935c3301647a8462b9176d99f9db68586aade3bada41ef0" }, "downloads": -1, "filename": "rpitwit-0.1.0.tar.gz", "has_sig": false, "md5_digest": "aa1c2d79eba9e0f3caf642aa454ac362", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18585, "upload_time": "2013-01-18T07:50:57", "url": "https://files.pythonhosted.org/packages/92/e2/565246988c7605fed87eaf227d2484a1b3be192b56804912a9192b94e635/rpitwit-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "a947600785536ed33191285967d0cc44", "sha256": "91f8442e0dced1f903b002fd6d30c6a25f39de130d4a45e9460b425289b66fd2" }, "downloads": -1, "filename": "rpitwit-0.2.0.tar.gz", "has_sig": false, "md5_digest": "a947600785536ed33191285967d0cc44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21142, "upload_time": "2013-01-21T06:10:20", "url": "https://files.pythonhosted.org/packages/b1/74/99465aad7be174652d90fa8ed595131bd27be1c6432a71db4926476c64a9/rpitwit-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a947600785536ed33191285967d0cc44", "sha256": "91f8442e0dced1f903b002fd6d30c6a25f39de130d4a45e9460b425289b66fd2" }, "downloads": -1, "filename": "rpitwit-0.2.0.tar.gz", "has_sig": false, "md5_digest": "a947600785536ed33191285967d0cc44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21142, "upload_time": "2013-01-21T06:10:20", "url": "https://files.pythonhosted.org/packages/b1/74/99465aad7be174652d90fa8ed595131bd27be1c6432a71db4926476c64a9/rpitwit-0.2.0.tar.gz" } ] }