{"id":21463794,"url":"https://github.com/obskyr/thehylia","last_synced_at":"2025-07-15T03:32:25.007Z","repository":{"id":41264613,"uuid":"42190013","full_name":"obskyr/thehylia","owner":"obskyr","description":"A script for The Hylia mass downloads. Get anime soundtracks quickly and easily! Also a Python interface.","archived":false,"fork":false,"pushed_at":"2021-08-04T14:31:10.000Z","size":59,"stargazers_count":76,"open_issues_count":5,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2023-06-30T07:15:57.985Z","etag":null,"topics":["anime","bulk-download","download","music","python","soundtracks"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/obskyr.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-09T16:17:44.000Z","updated_at":"2023-05-16T12:55:56.000Z","dependencies_parsed_at":"2022-09-20T23:50:55.854Z","dependency_job_id":null,"html_url":"https://github.com/obskyr/thehylia","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/obskyr%2Fthehylia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/obskyr%2Fthehylia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/obskyr%2Fthehylia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/obskyr%2Fthehylia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/obskyr","download_url":"https://codeload.github.com/obskyr/thehylia/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226016708,"owners_count":17560464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anime","bulk-download","download","music","python","soundtracks"],"created_at":"2024-11-23T07:28:12.975Z","updated_at":"2024-11-23T07:28:13.600Z","avatar_url":"https://github.com/obskyr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# thehylia.py\n\n`thehylia.py` is a [Python](https://www.python.org/) interface for getting [The Hylia](http://anime.thehylia.com/soundtracks/) soundtracks. It makes thehylia mass downloads a breeze. It's easy to use - check it!\n\nFrom the command line:\n\n```cmd\nthehylia.py yakitate-japan-original-soundtrack\n```\n\nAs an import:\n\n```python\nimport thehylia\nthehylia.download('yakitate-japan-original-soundtrack')\n# And bam, you've got the Yakitate!! Japan soundtrack!\n```\n\nFor video game music, [check out `khinsider.py`](https://github.com/obskyr/khinsider).\n\nCarefully put together by [@obskyr](http://twitter.com/obskyr)!\n\n### **[Download it here!](https://github.com/obskyr/thehylia/archive/master.zip)**\n\n## Usage\n\nJust run `thehylia.py` from the command line with the sole parameter being the soundtrack you want to download. You can either use the soundtrack's ID, or simply copy its entire URL. Easy!\n\nIf you want, you can also add another parameter as the output folder, but that's optional.\n\nYou can also download other file formats (if available), like FLAC or OGG, as following:\n\n```cmd\nkhinsider.py --format flac ano-natsu-de-matteru-op-single-sign\n```\n\nIf you don't want to go to the actual site to look for soundtracks, you can also just type a search term as the first parameter(s), and provided it's not a valid soundtrack, `thehylia.py` will give you a list of soundtracks matching that term.\n\nYou're going to need [Python](https://www.python.org/downloads/) (if you don't know which version to get, choose the latest version of Python 3 - `thehylia.py` works with both 2 and 3), so install that (and [add it to your path](http://superuser.com/a/143121)) if you haven't already.\n\nYou will also need to have [pip](https://pip.readthedocs.org/en/latest/installing.html) installed (if you have Python 3, it is most likely already installed - otherwise, download `get-pip.py` and run it) if you don't already have [requests](https://pypi.python.org/pypi/requests) and [Beautiful Soup 4](https://pypi.python.org/pypi/beautifulsoup4). The first time `khinsider.py` runs, it will install these two for you.\n\nFor more detailed information, try running `thehylia.py --help`!\n\n## As a module\n\n`thehylia.py` requires two non-standard modules: [requests](https://pypi.python.org/pypi/requests) and [beautifulsoup4](https://pypi.python.org/pypi/beautifulsoup4). Just run a `pip install` on them (with [pip](https://pip.readthedocs.org/en/latest/installing.html)), or just run `thehylia.py` on its own once and it'll install them for you.\n\nHere are the main functions you will be using:\n\n### `thehylia.download(soundtrackName[, path=\"\", makeDirs=True, formatOrder=None, verbose=False])`\n\nDownload the soundtrack `soundtrackName`. This should be the name the soundtrack uses at the end of its album URL.\n\nIf `path` is specified, the soundtrack files will be downloaded to the directory that path points to.\n\nIf `makeDirs` is `True`, the directory will be created if it doesn't exist.\n\nYou can specify `formatOrder` to download soundtracks in specific formats. `formatOrder=['flac', 'mp3']`, for example, will download FLACs if available, and MP3s if not.\n\nIf `verbose` is `True`, it will print progress as it is downloading.\n\n### `thehylia.search(term)`\n\nSearch khinsider for `term`. Return a list of `Soundtrack`s matching the search term. You can then access `soundtrack.id` or `soundtrack.url`.\n\n### More\n\nThere's a lot more detail to the API - more than would be sensible to write here. If you want to use `khinsider.py` as a module in a more advanced capacity, have a look at the `Soundtrack`, `Song`, and `File` objects in the source code! They're documented properly there for your reading pleasure.\n\n# Is this `khinsider.py` except it's for The Hylia?\n\nYes. Yes, it is.\n\nThe creators of the sites were nice enough to use a very, very similar site structure, which made a The Hylia script not only very possible, but very easy (or, uh, it should've been, had I not gone all metaprogramming-y on it). It would absolutely be possible to have both in the same script, with an argument for which site to check / download from, but I feel the separation of them as two scripts is logical and easier to handle.\n\n# Talk to me!\n\nYou can easily get to me in these ways:\n\n* [@obskyr](http://twitter.com/obskyr/) on Twitter!\n* [E-mail](mailto:powpowd@gmail.com) me!\n\nI'd love to hear it if you like `thehylia.py`! If there's a problem, or you'd like a new feature, submit an issue here on GitHub.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobskyr%2Fthehylia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fobskyr%2Fthehylia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fobskyr%2Fthehylia/lists"}