{"id":15066851,"url":"https://github.com/jayadamsmorgan/yatoro","last_synced_at":"2025-07-09T22:36:57.593Z","repository":{"id":257049669,"uuid":"857175992","full_name":"jayadamsmorgan/Yatoro","owner":"jayadamsmorgan","description":"VIM-like Apple Music Player in Terminal","archived":false,"fork":false,"pushed_at":"2025-02-22T05:00:16.000Z","size":6145,"stargazers_count":79,"open_issues_count":8,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-02T18:12:58.802Z","etag":null,"topics":["applemusic","cli","cli-app","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/jayadamsmorgan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2024-09-14T01:12:38.000Z","updated_at":"2025-05-01T22:16:08.000Z","dependencies_parsed_at":"2025-05-02T18:16:59.465Z","dependency_job_id":null,"html_url":"https://github.com/jayadamsmorgan/Yatoro","commit_stats":null,"previous_names":["jayadamsmorgan/yatoro"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/jayadamsmorgan/Yatoro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayadamsmorgan%2FYatoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayadamsmorgan%2FYatoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayadamsmorgan%2FYatoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayadamsmorgan%2FYatoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jayadamsmorgan","download_url":"https://codeload.github.com/jayadamsmorgan/Yatoro/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jayadamsmorgan%2FYatoro/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264504616,"owners_count":23618831,"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":["applemusic","cli","cli-app","swift"],"created_at":"2024-09-25T01:13:05.524Z","updated_at":"2025-07-09T22:36:57.565Z","avatar_url":"https://github.com/jayadamsmorgan.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Yatoro\n**First Apple Music Player in Terminal**\n\n\u003c/div\u003e\n\n\n## Overview\n\nYatoro is a standalone VIM-like Apple Music player written in Swift intended to be used in a Terminal emulator.\n\nYatoro strives for bringing all the features of the Apple Music app into your Terminal.\n\n![](yatoro.gif)\n\n\n## Installation\n\n### Requirements\n\n- Active Apple Music subscription\n- macOS Sonoma or higher\n    - MusicKit library is only available on macOS for now. The workaround for Linux is being actively looked into, if you have any ideas please let me know\n- Terminal of your preference\n\n### [Homebrew][homebrew]\n\n```\nbrew tap jayadamsmorgan/yatoro\nbrew install yatoro\n```\n\n### Build from source\n\nCheck out [build instructions](BUILD.md).\n\n### Note\n\n- **Important:** Add both your Terminal and the Yatoro application in `System Settings -\u003e Privacy \u0026 Security -\u003e Media \u0026 Apple Music`\n\n- Run the app\n\n## Feature status\n\nThe player is still early in the development, so the features are quite limited for now.\n\n\n| Feature             | Status  | Comments                                        |\n| ------------------- | ------- | ----------------------------------------------- |\n| Playing music       | Working |                                                 |\n| Player controls     | Working |                                                 |\n| Now playing artwork | Working |                                                 |\n| Status line         | Working |                                                 |\n| Command line        | Working |                                                 |\n| Searching music     | Working | Only with `:search` command                     |\n| Player queue        | Working | Only adding to queue with `:addToQueue` command |\n| Coloring the UI     | Working | Check [THEMING](THEMING.md)                     |\n| Mouse controls      |   TBD   |                                                 |\n| Arrow navigation    |   TBD   |                                                 |\n\nFeel free to suggest new features through issues!\n\n\n## Usage\n\n### Configuring\n\nSome of the options might be configured with command line arguments. Check `Yatoro -h`.\n\nAnother way to configure everything is configuration file. Check [CONFIGURATION](CONFIGURATION.md).\n\nCommand line arguments will overwrite the options set in configuration file.\n\n### Default Controls\n\n| Action                                  | Modifier | Button |\n|-----------------------------------------| -------- | ------ |\n| Play/Pause Toggle                       |          |  `p`   |\n| Play                                    |  `SHIFT` |  `p`   |\n| Pause                                   |  `CTRL`  |  `p`   |\n| Stop                                    |          |  `c`   |\n| Clear queue                             |          |  `x`   |\n| Close last search result or detail page |          | `ESC`  |\n| Play next                               |          |  `f`   |\n| Play previous                           |          |  `b`   |\n| Start seeking forward                   |  `CTRL`  |  `f`   |\n| Start seeking backward                  |  `CTRL`  |  `b`   |\n| Stop seeking                            |          |  `g`   |\n| Restart song                            |          |  `r`   |\n| Start searching                         |          |  `s`   |\n| Station from current entry              |  `CTRL`  |  `s`   |\n| Open command line                       |  `SHIFT` |  `:`   |\n| Quit application                        |          |  `q`   |\n| Quit application (2)                    |  `CTRL`  |  `c`   |\n\n### Commands\n\nYatoro has a VIM-like command line. Check full command description in [COMMANDS](COMMANDS.md).\n\n\n## Contributing\n\nCheck [CONTRIBUTING](CONTRIBUTING.md) and [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md).\n\n\n[homebrew]: https://brew.sh\n[release_page]: https://github.com/jayadamsmorgan/Yatoro/releases \n[release_issue]: https://github.com/jayadamsmorgan/Yatoro/issues/3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayadamsmorgan%2Fyatoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjayadamsmorgan%2Fyatoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjayadamsmorgan%2Fyatoro/lists"}