{"id":13430178,"url":"https://github.com/caleb531/play-song","last_synced_at":"2026-03-10T23:04:44.656Z","repository":{"id":11194013,"uuid":"13575245","full_name":"caleb531/play-song","owner":"caleb531","description":"An Alfred workflow for quickly and easily playing music in the Apple Music app","archived":false,"fork":false,"pushed_at":"2025-09-20T22:39:39.000Z","size":3955,"stargazers_count":114,"open_issues_count":0,"forks_count":12,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-12-20T07:29:58.241Z","etag":null,"topics":["alfred","alfred-workflow","applescript","itunes"],"latest_commit_sha":null,"homepage":"","language":"AppleScript","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/caleb531.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2013-10-14T22:46:20.000Z","updated_at":"2025-11-25T14:16:37.000Z","dependencies_parsed_at":"2025-07-25T02:19:17.771Z","dependency_job_id":"68bb74fe-cb3b-4eb9-961c-1652662ffb6a","html_url":"https://github.com/caleb531/play-song","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/caleb531/play-song","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fplay-song","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fplay-song/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fplay-song/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fplay-song/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caleb531","download_url":"https://codeload.github.com/caleb531/play-song/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caleb531%2Fplay-song/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30360675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"ssl_error","status_checked_at":"2026-03-10T21:40:59.357Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["alfred","alfred-workflow","applescript","itunes"],"created_at":"2024-07-31T02:00:50.822Z","updated_at":"2026-03-10T23:04:44.639Z","avatar_url":"https://github.com/caleb531.png","language":"AppleScript","funding_links":[],"categories":["AppleScript","Music"],"sub_categories":[],"readme":"# Play Song\n\n*Copyright 2013-2025 Caleb Evans*  \n*Released under the MIT license*\n\nPlay Song is an [Alfred](https://www.alfredapp.com/) workflow designed to make\nplaying music in Music.app extremely quick and convenient.\n\nThe workflow will be solely supporting Alfred 5 going forward, but the workflow\nversions last compatible with the previous versions of Alfred will remain\navailable here for your convenience.\n\n![Play Song in action](screenshot.png)\n\nSpecial thanks to [@Tyilo](https://github.com/Tyilo) for his invaluable feedback\nand code contributions.\n\n## Usage\n\nPlay Song includes a number of keyword filters which allow you to search for and\nplay songs in your Music.app library. For example:\n\n### Playing a song\n\n```\nplaysong hey jude\n```\n\n#### Playing a song in a particular album\n\n```\nplaysongin abbey road\n```\n\n#### Playing a song by a particular artist\n\n```\nplaysongby beatles\n```\n\n### Playing an album\n\n```\nplayalbum pet sounds\n```\n\n#### Playing an album by a particular artist\n\n```\nplayalbumby beach boys\n```\n\n### Playing an artist\n\n```\nplayartist killers\n```\n\n### Playing a genre\n\n```\nplaygenre alternative\n```\n\n### Playing a playlist\n\n```\nplayplaylist favorites\n```\n\n### Controlling the Music app's global shuffle setting\n\n```\nshuffleon\n```\n\n```\nshuffleoff\n```\n\n```\nshuffletoggle\n```\n\n### Queueing songs\n\nFor any of the above filters, choosing a result with the `cmd` key held down\nwill queue the result (as opposed to playing it immediately). This allows you to\nqueue up multiple songs before playing them.\n\nTo play the songs you've queued, use the `playqueue` keyword. To clear the queue\nof all songs, use the `clearqueue` keyword.\n\n**Note:** At this time, Play Song does not support queueing for Apple Music\nplaylists.\n\n## Searching songs on Google\n\nFor any of the above filters, choosing a result with the `ctrl` key held down\nwill search the result on Google.\n\n### Clearing the cache\n\nPlay Song stores a local cache containing album artwork (from displayed\nresults), as well as the compiled workflow configuration. If you experience any\nissues with Play Song, you can clear this cache via the `clearcache` keyword.\n\n### A note about play order\n\nPlay Song always respects the current shuffle mode within Music.app. For example,\nif shuffle is enabled, playing an album via Play Song will play the songs of the\nalbum in shuffled order. Therefore, if you desire Play Song to respect album\norder, run the `shuffleoff` command within Alfred.\n\nAdditionally, Play Song will honor the column you are sorting by in Music.app to\nsort queued songs. This applies to keyword filters like `playartist`,\n`playalbum`, and `playgenre`. For example, if you are sorting by \"Album by\nArtist\" in your library, then Play Song will group artists together and group\nalbums together when using `playgenre`. However, if you are sorting by \"Title\"\nin your library, then Play Song will disregard album groupings and simply play\nsongs in alphabetical order.\n\nThe `playplaylist` filter is the only Play Song filter where play order is\nguaranteed.\n\n### Playing a song directly (the Play Song v1 behavior)\n\nIf you are a longtime Play Song user who prefers the v1 behavior for playing\nsongs (where music continues playing after the song finishes), you can do so via\nthe `shift` modifier. Note that this only works for the `playsong` filter.\n\n## Support\n\nIf you have a bug to report or a feature to request, please [submit an issue on\nGitHub](https://github.com/caleb531/play-song/issues). You can also [contact me\ndirectly](https://calebevans.me/contact/) via email.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaleb531%2Fplay-song","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaleb531%2Fplay-song","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaleb531%2Fplay-song/lists"}