{ "info": { "author": "Neil Martinsen-Burrell", "author_email": "neilmartinsenburrell@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Multimedia :: Sound/Audio :: Capture/Recording" ], "description": "Timeshift\n=========\n\n``timeshift`` is a python program for recording Internet radio streams and saving\nthem for later listening (``_).\nThis is \"fair use\" of the copyrighted material that is being broadcast and is\nperfectly legal as long as the files are not made publicly available. \n\nQuick Start\n-----------\n\n::\n\n $ easy_install timeshift\n $ cat << EOF > timeshift.conf \n [DEFAULT]\n basedir = /tmp\n baseurl = http://localhost/tmp\n\n [NPR]\n title = \"National Public Radio\"\n url = http://npr.ic.llnwd.net/stream/npr_live24\n duration = 60\n feedfile = npr.atom\n EOF\n $ python timeshift.py NPR\n\n\nInstallation\n------------\n\nThe simplest installation method is to use Python's ``easy_install`` or\n``pip`` to install the package from `PyPI\n`_::\n\n pip install timeshift\n\nTo install from source, you can clone the project from `BitBucket\n`_::\n\n hg clone https://bitbucket.org/nmb/timeshift\n\nConfiguration\n-------------\n\n``timeshift`` uses a configuration file by default named ``timeshift.conf`` in\nthe current directory. To specify a different file use the ``--config=FILE``\noption. The configuration file specifies a global location and URL::\n\n [DEFAULT]\n basedir = /tmp\n baseurl = http://localhost/tmp\n\nwhere ``basedir`` is the local directory where files will be saved and\n``baseurl`` is the URL where those files can be accessed.\n\nEach source is specified by a separate stanza in the configuration file::\n\n [NPR]\n title = \"National Public Radio\"\n url = http://npr.ic.llnwd.net/stream/npr_live24\n duration = 60\n feedfile = npr.atom\n\nwhere ``title`` is a long name for source, ``url`` is the location to record\nfrom, ``duration`` is the time in *seconds* to record, and ``feedfile`` is the\nname of the file in ``basedir`` to write an `Atom\n`_ feed to (for use with podcasting\nsoftware).\n\nThe ``url`` for the source is the location from which to download the stream.\nThis can often be found by *downloading* the MP3 playlist of the stream and\nlooking for the ``File1`` value inside.\n\nUsage\n-----\n\nSimply run the ``timeshift.py`` script with the name of the section that you\nwish to record: ``python timeshift.py NPR``. That will record for the\nspecified number of seconds to a suitably named file in ``basedir`` and will\nadd that file to the specified Atom feed in the same directory.\n\nTo record at regular intervals, use the ``cron`` facility under Unix. For\nexample, to record at 17:00 every saturday you could use the crontab line::\n\n # m h dom mon dow command\n 0 17 * * SAT python /path/to/timeshift.py --config=/path/to/timeshift.conf NPR\n\nAcknowledgments\n---------------\n\nTimeshift incorporates the Python `feedparser library\n`_ and the `rfc3339 module\n`_. Thanks to the authors of\nthose projects.\n\nLicense\n-------\n\nCopyright 2013 Neil Martinsen-Burrell \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://bitbucket.org/nmb/timeshift", "keywords": null, "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "timeshift", "package_url": "https://pypi.org/project/timeshift/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/timeshift/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://bitbucket.org/nmb/timeshift" }, "release_url": "https://pypi.org/project/timeshift/0.2/", "requires_dist": null, "requires_python": null, "summary": "A python program for recording Internet radio streams and saving them for later listening", "version": "0.2" }, "last_serial": 570444, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "94916ee782af5270efdb233c2cf87ad3", "sha256": "e7b584fd7b67f0626b79e4187e0a6ea964fbf6f0258668918ff244fb409b50a8" }, "downloads": -1, "filename": "timeshift-0.1.tar.gz", "has_sig": false, "md5_digest": "94916ee782af5270efdb233c2cf87ad3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 51988, "upload_time": "2013-02-20T19:23:22", "url": "https://files.pythonhosted.org/packages/54/37/717f4c544f2be1180d4f0a976ab4e90fd2c4d2b904c96ea0908522747bf6/timeshift-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "71eed544d70188367f20d6c2ba9e3c26", "sha256": "cff39fe60344d0436309733625578c93f356afdd3eae04830686c0348c8ee163" }, "downloads": -1, "filename": "timeshift-0.2.tar.gz", "has_sig": false, "md5_digest": "71eed544d70188367f20d6c2ba9e3c26", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 52115, "upload_time": "2013-02-21T04:35:45", "url": "https://files.pythonhosted.org/packages/89/8b/72a6ccb2bb23561048281fa2e0936410c25937bc763e02294b0a746fbf88/timeshift-0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "71eed544d70188367f20d6c2ba9e3c26", "sha256": "cff39fe60344d0436309733625578c93f356afdd3eae04830686c0348c8ee163" }, "downloads": -1, "filename": "timeshift-0.2.tar.gz", "has_sig": false, "md5_digest": "71eed544d70188367f20d6c2ba9e3c26", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 52115, "upload_time": "2013-02-21T04:35:45", "url": "https://files.pythonhosted.org/packages/89/8b/72a6ccb2bb23561048281fa2e0936410c25937bc763e02294b0a746fbf88/timeshift-0.2.tar.gz" } ] }