[![PyPI version shields.io](https://img.shields.io/pypi/v/youtube-title-parse.svg)](https://pypi.org/project/youtube-title-parse/)
[![PyPI license](https://img.shields.io/pypi/l/youtube-title-parse.svg)](https://pypi.org/project/youtube-title-parse/)
[![PyPI status](https://img.shields.io/pypi/status/youtube-title-parse.svg)](https://pypi.org/project/youtube-title-parse/)
![youtube_title_parse CI](https://github.com/lttkgp/youtube_title_parse/workflows/youtube_title_parse%20CI/badge.svg)
# youtube title parse
Parse the title of a YouTube video to try and get artist & song name.
## Description
Video titles on YouTube follow no strict format, and so passing the titles directly to music APIs to fetch metadata hardly works. This module attempts to recognize common patterns (using regex) and extract artist and song name.
## Installation
To install [youtube\_title\_parse](https://pypi.python.org/pypi/youtube-title-parse/), simply use pipenv (or pip, of course):
```bash
pipenv install youtube_title_parse
```
## Usage
### CLI
`youtube_title_parse` comes with a CLI that you can use directly:
```bash
$ youtube_title_parse "Seoul - Stay With Us (Official Video)"
Seoul - Stay With Us
```
### Module
You can also import `youtube_title_parse` as a module.
```python
from youtube_title_parse import get_artist_title
artist, title = get_artist_title("Seoul - Stay With Us (Official Video)")
assert artist == "Seoul"
assert title == "Stay With Us"
```
## Credits
This module is originally a Python3 rewrite of the equivalent npm library, [`get-artist-title`](https://www.npmjs.com/package/get-artist-title), but adds some extra functionality to catch more patterns.
## Contributing
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/lttkgp/youtube-title-parse/issues/new).
## License
youtube-title-parse is made available under the [MIT license](https://opensource.org/licenses/MIT).
Raw data
{
"_id": null,
"home_page": "https://github.com/lttkgp/youtube-title-parse",
"name": "youtube-title-parse",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "youtube,title,metadata,parse,music",
"author": "lttkgp",
"author_email": "ghostwriternr@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/34/72/59407b949e51e6f174d4b6ceaa175034a66c6b6770285242cc41d8e2c775/youtube_title_parse-1.0.0.tar.gz",
"platform": "",
"description": "\n[![PyPI version shields.io](https://img.shields.io/pypi/v/youtube-title-parse.svg)](https://pypi.org/project/youtube-title-parse/)\n[![PyPI license](https://img.shields.io/pypi/l/youtube-title-parse.svg)](https://pypi.org/project/youtube-title-parse/)\n[![PyPI status](https://img.shields.io/pypi/status/youtube-title-parse.svg)](https://pypi.org/project/youtube-title-parse/)\n![youtube_title_parse CI](https://github.com/lttkgp/youtube_title_parse/workflows/youtube_title_parse%20CI/badge.svg)\n\n# youtube title parse\n\nParse the title of a YouTube video to try and get artist & song name.\n\n## Description\n\nVideo titles on YouTube follow no strict format, and so passing the titles directly to music APIs to fetch metadata hardly works. This module attempts to recognize common patterns (using regex) and extract artist and song name.\n\n## Installation\n\nTo install [youtube\\_title\\_parse](https://pypi.python.org/pypi/youtube-title-parse/), simply use pipenv (or pip, of course):\n\n```bash\npipenv install youtube_title_parse\n```\n\n## Usage\n\n### CLI\n\n`youtube_title_parse` comes with a CLI that you can use directly:\n\n```bash\n$ youtube_title_parse \"Seoul - Stay With Us (Official Video)\"\nSeoul - Stay With Us\n```\n\n### Module\n\nYou can also import `youtube_title_parse` as a module.\n\n```python\nfrom youtube_title_parse import get_artist_title\n\nartist, title = get_artist_title(\"Seoul - Stay With Us (Official Video)\")\nassert artist == \"Seoul\"\nassert title == \"Stay With Us\"\n```\n\n## Credits\n\nThis module is originally a Python3 rewrite of the equivalent npm library, [`get-artist-title`](https://www.npmjs.com/package/get-artist-title), but adds some extra functionality to catch more patterns.\n\n## Contributing\n\nPull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/lttkgp/youtube-title-parse/issues/new).\n\n## License\n\nyoutube-title-parse is made available under the [MIT license](https://opensource.org/licenses/MIT).\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Parse the title of a YouTube video to try and get artist & song name",
"version": "1.0.0",
"split_keywords": [
"youtube",
"title",
"metadata",
"parse",
"music"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "fc207f7ea6bc9b13680c1e2a14126117",
"sha256": "88c9413e9f478affa9152dd234ec55223e4b8785973707f87f67fe1b55f61b85"
},
"downloads": -1,
"filename": "youtube_title_parse-1.0.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "fc207f7ea6bc9b13680c1e2a14126117",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 9653,
"upload_time": "2020-05-25T19:46:55",
"upload_time_iso_8601": "2020-05-25T19:46:55.210887Z",
"url": "https://files.pythonhosted.org/packages/a6/a4/d2fd0eaee9739098afadf71560e817ccd1c057275c3724ec9b8b36fb5c9a/youtube_title_parse-1.0.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "682eed5c5584d8cf21e9ac61a69a8261",
"sha256": "350cc055c058e8f639ac7e1cbc67a1fb485a4bb5fcd1f9645d79d1ccc8e3518d"
},
"downloads": -1,
"filename": "youtube_title_parse-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "682eed5c5584d8cf21e9ac61a69a8261",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13479,
"upload_time": "2020-05-25T19:46:56",
"upload_time_iso_8601": "2020-05-25T19:46:56.848256Z",
"url": "https://files.pythonhosted.org/packages/34/72/59407b949e51e6f174d4b6ceaa175034a66c6b6770285242cc41d8e2c775/youtube_title_parse-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2020-05-25 19:46:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "lttkgp",
"github_project": "youtube-title-parse",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "youtube-title-parse"
}