{"id":32272820,"url":"https://github.com/encrystudio/ytmusicapi_dart","last_synced_at":"2026-02-22T03:03:16.684Z","repository":{"id":305694400,"uuid":"1023696242","full_name":"encrystudio/ytmusicapi_dart","owner":"encrystudio","description":"Unofficial API client for YouTube Music. Inspired by sigma67's ytmusicapi for Python.","archived":false,"fork":false,"pushed_at":"2025-10-30T23:01:07.000Z","size":1097,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-31T00:28:51.334Z","etag":null,"topics":["api","client","cross-platform","youtube","youtube-api"],"latest_commit_sha":null,"homepage":"https://encrystudio.github.io/ytmusicapi_dart/","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/encrystudio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-21T14:51:18.000Z","updated_at":"2025-10-30T23:00:27.000Z","dependencies_parsed_at":"2025-07-21T15:25:22.166Z","dependency_job_id":"608d30fd-791c-4b4e-96a8-1f707956fb1d","html_url":"https://github.com/encrystudio/ytmusicapi_dart","commit_stats":null,"previous_names":["encrystudio/ytmusicapi_dart"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/encrystudio/ytmusicapi_dart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/encrystudio%2Fytmusicapi_dart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/encrystudio%2Fytmusicapi_dart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/encrystudio%2Fytmusicapi_dart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/encrystudio%2Fytmusicapi_dart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/encrystudio","download_url":"https://codeload.github.com/encrystudio/ytmusicapi_dart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/encrystudio%2Fytmusicapi_dart/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29704401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T23:35:04.139Z","status":"online","status_checked_at":"2026-02-22T02:00:08.193Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["api","client","cross-platform","youtube","youtube-api"],"created_at":"2025-10-22T23:08:11.059Z","updated_at":"2026-02-22T03:03:16.678Z","avatar_url":"https://github.com/encrystudio.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD024 --\u003e\n\n# Dart YTMusicAPI\n\n_ytmusicapi_dart_ is a Dart library to send requests to the YouTube Music API. It emulates YouTube Music web client requests.\n\n\u003e [!IMPORTANT]\n\u003e Dart YTMusicAPI is currently in early development.\n\u003e It is not yet feature-complete and may be unstable.\n\u003e We highly recommend wrapping most API calls in a `try-catch` block to prevent unexpected crashes or runtime errors.\n\n## Disclaimer\n\nThis project and its authors are **not affiliated with, endorsed by, or sponsored by YouTube, Google LLC, or any of their affiliates or subsidiaries**.\n**YouTube, YouTube Music**, and all related trademarks, logos, and brand names are the property of their respective owners.\n\nThis library is provided **for educational and research purposes only**.\nThe authors and contributors **assume no responsibility or liability** for any misuse of this software, violation of YouTube’s Terms of Service, or any other damages or consequences arising from its use. **Use at your own risk**.\n\n## Getting started\n\nAdd this to your pubspec.yaml file:\n\n```yaml\ndependencies:\n  ytmusicapi_dart: ^2.0.0\n```\n\nOr run this command:\n\n```sh\ndart pub add ytmusicapi_dart\n```\n\nIt is possible that YouTube restricts the access to the API after some time. If that happens, you will get an error message. Try again later.\n\n## Usage\n\n```dart\nimport 'package:ytmusicapi_dart/ytmusicapi_dart.dart';\n\nFuture\u003cvoid\u003e main() async {\n  final ytmusic = await YTMusic.create();\n  final results = await ytmusic.search('search term');\n  print(results);\n  ytmusic.close();\n}\n```\n\nMore examples can be found in the [example folder](/example/).\n\n## Features\n\n\u003e [!WARNING]\n\u003e Some features require authentication, which is currently not tested.\n\n| State            | Callable in code   | Has tests          | Passed all tests   | Stable             | Notes                                                |\n| ---------------- | ------------------ | ------------------ | ------------------ | ------------------ | ---------------------------------------------------- |\n| Stable           | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | Tested enough to be considered stable                |\n| Tested           | :white_check_mark: | :white_check_mark: | :white_check_mark: | :x:                | Ported and passed all available tests                |\n| Available        | :white_check_mark: | :x:                | :x:                | :x:                | Partially ported, usage not recommended but possible |\n| Missing Features | :x:                | :x:                | :x:                | :x:                | Not implemented yet                                  |\n\n### Stable\n\nNo feature is considered stable enough yet.\n\n### Tested\n\n#### Browsing\n\n- search (including all filters) and suggestions\n- get artist information and releases (songs, videos, albums, singles, related artists)\n- get user information (videos, playlists)\n- get albums\n- get watch playlists (next songs when you press play/radio/shuffle in YouTube Music)\n- get song lyrics\n\n### Available\n\n#### Browsing\n\n- get user information (videos, playlists)\n\n#### Exploring music\n\n- get moods and genres playlists\n- get latest charts (globally and per country)\n\n#### Playlists\n\n- create and delete playlists\n- modify playlists: edit metadata, add/move/remove tracks\n- get playlist contents\n- get playlist suggestions\n\n#### Podcasts\n\n- get podcasts\n- get episodes\n- get channels\n- get episodes playlists\n\n#### Localization\n\n- regions\n- English language\n\n### Missing Features\n\nThese features from [sigma67's ytmusicapi](https://github.com/sigma67/ytmusicapi) are not implemented yet (feel free to implement them and open a PR):\n\n#### Library management\n\n- get library contents: playlists, songs, artists, albums and subscriptions, podcasts, channels\n- add/remove library content: rate songs, albums and playlists, subscribe/unsubscribe artists\n- get and modify play history\n\n#### Uploads\n\n- upload songs and remove them again\n- list uploaded songs, artists and albums\n\n#### Localization\n\n- languages other than English\n\n## Additional information\n\nThis package is highly inspired by and ported to Dart from [sigma67's ytmusicapi](https://github.com/sigma67/ytmusicapi), which is licensed under the MIT license, just like this package.\nFor additional information, check [the repository](https://github.com/sigma67/ytmusicapi).\nFor now, this package is only a port of it so I will not add new features that are not part of [sigma67's ytmusicapi](https://github.com/sigma67/ytmusicapi).\nIf you want to help (I would appreciate it), implement more functionality from there or fix bugs listed in [the todo file](/TODO.md) or the _issues_ section and open a PR here.\n\nThanks to [sigma67](https://github.com/sigma67) for the great work!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fencrystudio%2Fytmusicapi_dart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fencrystudio%2Fytmusicapi_dart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fencrystudio%2Fytmusicapi_dart/lists"}