{
    "info": {
        "author": "Sh3llcod3",
        "author_email": "28938427+Sh3llcod3@users.noreply.github.com",
        "bugtrack_url": null,
        "classifiers": [
            "Environment :: Web Environment",
            "Framework :: Flask",
            "License :: OSI Approved :: MIT License",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Topic :: Multimedia :: Sound/Audio"
        ],
        "description": "# HomePage\n\nHomePage is a trivial flask web app that allows downloading the audio track from almost any internet video.\nIt is intended to be deployed inside a private network for personal use, so that hosts within the network can access\nand download the tracks they want.\n\nHomePage is very basic, but it has a Material Design front-end which is simple and easy to use.\nHomePage uses `youtube_dl` to download the videos, so quite a few sites are supported. Playlists are also supported.\n\n![HomePage](homepage/static/HomePage.png)\n\n## Setup & Prerequsites\n\n- `python 3.6` or above\n- The `pip` module for the above python version\n- `sudo` access if you wish to use port `80`\n- `pyenv` installed (optional)\n- `poetry` installed (optional)\n\nThe basic installation is very simple.\n\n```bash\n$ python3 -m pip install --user homepage\n\n# Normal desktop\n$ homepage -i\n\n# TTY only server\n$ homepage -ic\n```\n\nThen, you can deploy with:\n\n```bash\n$ homepage -df\n```\n\nAlternatively, if your system is running an older version of python or you wish to run this project inside\na virtual environment, you can do that too. In fact, this is the __recommended__ method of installing this project.\n\nFirst, go ahead and install [pyenv](https://github.com/pyenv/pyenv#basic-github-checkout). Then install [poetry](https://github.com/sdispater/poetry).\nOnce you've installed those, we just to install a few more things.\n\n```bash\n$ git clone https://github.com/Sh3llcod3/HomePage.git\n$ cd HomePage/\n$ pyenv install 3.7.4\n$ pyenv local 3.7.4\n$ poetry self:update --preview || poetry self update --preview\n$ poetry update\n$ poetry install # Add --no-dev if you don't want to tweak.\n$ poetry shell\n$ homepage -ip\n$ homepage -df\n```\n\nAfter installing `pyenv`, the lines you add to your `~/.bashrc` may need to be different, please see the [FAQ](#faq--troubleshooting).\n\n## Usage\n\nOnce deployed, if you're using this on the device which is hosting it, fire up your\nfavourite web browser and head to `http://0.0.0.0:5000/`. If you're on another device,\nsimply head to the IP address that it prints out when you run it.\n\nIf you have `sudo` access, please use the `-f` switch. If you don't, other hosts can\nstill use this, but they will need to explicitly specify the port, e.g. `http://192.168.0.10:5000`.\n\nFrom there, you just need to select your options and paste in a link to the video or playlist\nthat you want to download the tracks from. Obviously, you can download from `YouTube`, but thanks\nto the power of the `youtube_dl` library, many other sites will also work, e.g. `Vimeo`, or `Reddit`.\nYou can find the full list [here](https://bit.ly/2XKgkuV).\n\n## FAQ & Troubleshooting\n\n#### I'm having trouble with the env\n\nYou may have inserted the wrong lines in your `~/.bashrc`.\nThe initialization lines shown on the pyenv repo don't work\nwell with poetry. Instead, add these lines to the end of the file\nand remove any previous lines you may have added before\n(taking care to ensure you don't remove anything else).\n\n```bash\n# Pyenv installation\n\nif [[ -z \"$VIRTUAL_ENV\" ]]; then\n    export PATH=\"$HOME/.pyenv/bin:$PATH\"\n    eval \"$(pyenv init -)\"\nfi\n```\n\n#### Can I change the background?\n\nYou absolutely can. To change the background, change out `homepage/static/Background.jpg` with any image you like,\nbut it has to be called `Background.jpg` and in the `JPEG` format. I will make this process easier in the future.\n\n#### Pyenv fails to install 3.7.4\n\nYou may have forgotten to install some crucial `pyenv` dependencies.\nIf you're using other package managers, check [here](https://github.com/pyenv/pyenv/wiki#suggested-build-environment)\nfor their wiki page. If you're using `apt`, you can simply run:\n\n```bash\n$ sudo apt update\n$ sudo apt-get install -y --no-install-recommends make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev\n```\n\nThen retry the `pyenv` installation.\n\n#### Why does HomePage exist?\n\nThat is a really good question.\nI wanted a simple web app where I could download music from various videos on any\ndevice, without having access to a command line version of `youtube_dl` or resorting\nto using shady sites and apps.\n\nThe code is bad at best, but it is functional and you have the freedom of choice.\nWhether you want to use it or not is up to you, but I assumed that people prefer\nconvenience, so I should probably upload this where more people may be able to take\nadvantage of this.\n\n#### Why is it not working?\n\nYour version of `youtube_dl` may be out of date. Having a version of `youtube_dl`\nthat is even one version old can mean your tracks may fail to download. Fortunately,\nthe library is updated frequently and you can pull in the updates very easily.\n\nIf you're using it from PyPi, then:\n```shell\n$ python3 -m pip install --upgrade youtube_dl gevent Flask --user\n```\n\nIf you're using it from the `env`, then simply `cd` to the directory you installed it\nand run:\n```shell\n$ poetry update\n$ poetry shell\n```\n\n> You may want to write some sort of `cron` job to do this every few days or so.\n\n#### Does HomePage scale?\n\nNo. It was never intended to scale in the first place. Neither is it secure in any way.\nTherefore, I should stress that you should __NOT__ deploy this to anywhere except your\nprivate/internal network.\n\n#### Does it have Windows support?\n\nNo. However I am planning to release compiled executables for both Windows and Linux so\nstay tuned for that, if you're interested.\n\n#### Why does it take a long time?\n\nTime is of the essence. I understand that if a specific computational task does not complete\nas quickly as someone anticipates, it can leave the user feeling disappointed.\n\nHowever, the length of time it takes for a specific video to be downloaded heavily depends\non several factors, such as the length, quantity and chosen quality of the download.\nOn top of this, you have to consider that for each video you download, `youtube_dl` has\nto first download the video, then it has to be encoded in your preferred format using\n`ffmpeg`. That can take a while, especially on older systems.\n\nI am always looking to optimise this so it downloads and converts the videos faster, but\nif you have any tips, please create an issue and I'll check it out as soon as possible.\n\n## To-do\n\n- [ ] Add an authentication page.\n- [ ] Make site restore state after a download.\n- [ ] Save user preferences using cookies.\n- [ ] Display past tracks only for that host.\n- [ ] Add a separate page for management.\n- [ ] Create a system to auto-update `youtube_dl`\n- [ ] Make it work on windows and generate executables\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/Sh3llcod3/HomePage",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "homepage",
        "package_url": "https://pypi.org/project/homepage/",
        "platform": "",
        "project_url": "https://pypi.org/project/homepage/",
        "project_urls": {
            "Homepage": "https://github.com/Sh3llcod3/HomePage",
            "Repository": "https://github.com/Sh3llcod3/HomePage"
        },
        "release_url": "https://pypi.org/project/homepage/0.3.0/",
        "requires_dist": [
            "Flask",
            "youtube_dl",
            "easyparse",
            "gevent"
        ],
        "requires_python": ">=3.6,<4.0",
        "summary": "A simple flask webapp to download the audio track from almost any internet video.",
        "version": "0.3.0"
    },
    "last_serial": 5931941,
    "releases": {
        "0.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a1279aaa94b13c0b138d4d6374a140cb",
                    "sha256": "2ada66f50a3290d5920100ec43f8dec31e37fed693b8a20abd799b5f5b813f3d"
                },
                "downloads": -1,
                "filename": "homepage-0.2.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "a1279aaa94b13c0b138d4d6374a140cb",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 432967,
                "upload_time": "2019-06-28T20:46:35",
                "url": "https://files.pythonhosted.org/packages/32/2f/9b873c64493e797698ad016c51df53c208ee98a8b24e6ccf67702a83e991/homepage-0.2.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "a66dc8431c105f3385cbe823fb5d5e4d",
                    "sha256": "e83468a6e3594d5f9a92650c7b0882d9f2fb1a17bfaa97130633c88997db379a"
                },
                "downloads": -1,
                "filename": "homepage-0.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "a66dc8431c105f3385cbe823fb5d5e4d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 431526,
                "upload_time": "2019-06-28T20:46:38",
                "url": "https://files.pythonhosted.org/packages/ac/18/9b9e7f500186705436b093da788e8575f7ccdc8b4ae225ea049a88d3fb70/homepage-0.2.0.tar.gz"
            }
        ],
        "0.2.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "43d2fed7f3d210cd3f98ff4a30c3e4b2",
                    "sha256": "db9b61aef60d0b4658b5599bac9427bb6376c0549a8a8a825c51113e15a6999d"
                },
                "downloads": -1,
                "filename": "homepage-0.2.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "43d2fed7f3d210cd3f98ff4a30c3e4b2",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6",
                "size": 432958,
                "upload_time": "2019-06-28T21:20:45",
                "url": "https://files.pythonhosted.org/packages/91/66/79d0e124595e7287ef293dee221c90ad6924da09793cf7977e174a18ee2e/homepage-0.2.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "b4fafc9eac6dec468a8a19027ff30448",
                    "sha256": "8da887efbad6d6610c2ce718968ee8b6700c0bab0227fd97a2108856fb32a416"
                },
                "downloads": -1,
                "filename": "homepage-0.2.5.tar.gz",
                "has_sig": false,
                "md5_digest": "b4fafc9eac6dec468a8a19027ff30448",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6",
                "size": 431515,
                "upload_time": "2019-06-28T21:20:48",
                "url": "https://files.pythonhosted.org/packages/f8/90/1d927628611244ed21fb7fd93e033a1dfb5db28b18349a5d7177003410d9/homepage-0.2.5.tar.gz"
            }
        ],
        "0.2.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "cf9cd25c24da42a0b3c1f2842e7e7167",
                    "sha256": "a44ebd266973fac93c460dd324089cc8b9532a0ba1db50f217764dc6bd20d6e1"
                },
                "downloads": -1,
                "filename": "homepage-0.2.9-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "cf9cd25c24da42a0b3c1f2842e7e7167",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": "==3.7.4",
                "size": 434219,
                "upload_time": "2019-09-29T00:07:53",
                "url": "https://files.pythonhosted.org/packages/3c/57/cb682ff248b9fe296d468698b3b7e0ecd6a6618cb75057be511c80c663c5/homepage-0.2.9-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "5d800e45814233a77d30b837dc90777c",
                    "sha256": "8e6d666a92f72257278197eb221faeaa4a07caa779fd71528496f0958c57e5ef"
                },
                "downloads": -1,
                "filename": "homepage-0.2.9.tar.gz",
                "has_sig": false,
                "md5_digest": "5d800e45814233a77d30b837dc90777c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": "==3.7.4",
                "size": 435087,
                "upload_time": "2019-09-29T00:07:56",
                "url": "https://files.pythonhosted.org/packages/31/94/a43fb6f8f9476d5e6ff8a2c0c121a2ff69381298459500fbe35e5e27d844/homepage-0.2.9.tar.gz"
            }
        ],
        "0.3.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "dcacbc2580ba4229999acaa25d0edbfd",
                    "sha256": "865d33163b3a2e03ca24a4b02a41e5149d5e29129260c0414c0a8d9ff9829aae"
                },
                "downloads": -1,
                "filename": "homepage-0.3.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "dcacbc2580ba4229999acaa25d0edbfd",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.6,<4.0",
                "size": 434231,
                "upload_time": "2019-10-05T13:08:02",
                "url": "https://files.pythonhosted.org/packages/75/fa/4b3e7f286ec9b507abd293292312eceb3204493de03e9609cafdfd3725d1/homepage-0.3.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "cd111a303474f023bf16c24f2c24b094",
                    "sha256": "2db0993791ff9817e1c6c1086f1ab9897650e2931fbb7c041d28a9679f345d7f"
                },
                "downloads": -1,
                "filename": "homepage-0.3.0.tar.gz",
                "has_sig": false,
                "md5_digest": "cd111a303474f023bf16c24f2c24b094",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.6,<4.0",
                "size": 435104,
                "upload_time": "2019-10-05T13:08:04",
                "url": "https://files.pythonhosted.org/packages/5b/d0/68d1c7caf0e818de2db986d69ef8e5544b67e304685a30cbe7c80c2fd6d8/homepage-0.3.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "dcacbc2580ba4229999acaa25d0edbfd",
                "sha256": "865d33163b3a2e03ca24a4b02a41e5149d5e29129260c0414c0a8d9ff9829aae"
            },
            "downloads": -1,
            "filename": "homepage-0.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "dcacbc2580ba4229999acaa25d0edbfd",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6,<4.0",
            "size": 434231,
            "upload_time": "2019-10-05T13:08:02",
            "url": "https://files.pythonhosted.org/packages/75/fa/4b3e7f286ec9b507abd293292312eceb3204493de03e9609cafdfd3725d1/homepage-0.3.0-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "cd111a303474f023bf16c24f2c24b094",
                "sha256": "2db0993791ff9817e1c6c1086f1ab9897650e2931fbb7c041d28a9679f345d7f"
            },
            "downloads": -1,
            "filename": "homepage-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "cd111a303474f023bf16c24f2c24b094",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6,<4.0",
            "size": 435104,
            "upload_time": "2019-10-05T13:08:04",
            "url": "https://files.pythonhosted.org/packages/5b/d0/68d1c7caf0e818de2db986d69ef8e5544b67e304685a30cbe7c80c2fd6d8/homepage-0.3.0.tar.gz"
        }
    ]
}